Re: CartData in ClickConversions?

221 views
Skip to first unread message
Message has been deleted

Max

unread,
Dec 12, 2022, 10:32:14 AM12/12/22
to Google Ads API and AdWords API Forum
To add to this:

The RPC API docs are pretty inconsistent in regards to CartData (missing / wrong field-types and missing information) however the REST API docs are much better (https://developers.google.com/google-ads/api/rest/reference/rest/v11/customers/uploadClickConversions) so we implemented click-conversion uploads through the REST API.

A complete (single) sample-conversion in the conversions-array looks like this:

{
  gclid: '123',
  conversionAction: 'customers/12345678/conversionActions/987654321',
  conversionDateTime: '2022-12-05 22:00:00+01:00'
  conversionValue: '0.02'
  currencyCode: 'USD',
  cartData: {
    merchantId: '123'
    feedCountryCode: 'US', // not sure if this needs to be upper- or lowercase
    feedLanguageCode: 'us' // not sure if this needs to be upper- or lowercase
    localTransactionCost: 0,
    items: {
      productId: '123abc',
      quantity: 2,
      unitPrice: 1.2,
    },
  },
}

The API response does not throw any errors, yet we are not able to find the submitted (cart)data within the dashboards.

Specific questions (in addition to "are there any addition docs regardings this feature?" and "does this need to be enabled first?") are:

- Did we get something completely wrong here?
- Does the sample-conversion match the required syntax?
- If not, are there any mandatory fields missing, for example conversionEnvironment or orderId?
- What is the expected format (upper- or lowercase) of feedCountryCode and feedLanguageCode?

Any additional input is very appreciated!

Thanks
Max

f...@publish.it schrieb am Montag, 12. Dezember 2022 um 12:49:08 UTC+1:
Hi there,

we are a CSS using shopping campaigns and uploading conversions via google ads api / clickconversions / cart_data.

There is not really any other resource for using CartData with clickconversions out there then this:
https://developers.google.com/google-ads/api/reference/rpc/v12/CartData

Also it seems to be pretty fresh: 
https://ads-developers.googleblog.com/2021/06/announcing-v8-of-google-ads-api.html
(cart_data has been added to v8 API version in 06 2021)

Has anyone more informations about "CartData"? Does it need to be enabled first as shopping cart data still in beta and there is no resource on CartData via clickconversions?

We exspected the passed data to be shown within a shopping campaign in campaigns "products" tab within the shopping stats columns for example "orders" or "avg. cart size".

Example how we use cart_data:

"cartData": {
        "merchantId": 1234567890,
        "feedCountryCode": "DE",
        "feedLanguageCode": "de",
        "localTransactionCost": 0,
        "items": {
          "productId": "1234567890",
          "quantity": 2,
          "unitPrice":100.01
        }

All conversion parts before that like gclid, conversion value etc are working and recording.

Appreciate your help community!

Florian

Google Ads API Forum Advisor

unread,
Dec 12, 2022, 2:44:27 PM12/12/22
to adwor...@googlegroups.com
Hi everyone,

Hi everyone, the v8 is unfortunately already sunset. You can refer here for the currently supported, and upcoming API versions.

Cart data is included in the upload click conversions guide and this section discusses how it can be included, along with possible formats to follow. In addition, if API requests did not return any errors (make sure to check your response logs), then your requests should be successfully uploaded into your Google Ads accounts.

As for tracking its (cart data) information in your Google Ads account's campaigns or in the reports, I would recommend reaching out first to the Google Ads Product Support team for further insight. This is because as of now, retrieving them in the API's reports does not appear to be supported as seen in the available fields in the relevant reports such as the shopping_performance_view, and campaign view of the API.

If the Product Support team can provide a Google Ads UI view where this data is available, you can send over its screenshot to our team and via the Reply privately to author option. If this option is not available, you may send the details directly to our googleadsa...@google.com alias instead.

Our team can then check if any other resources can be used to retrieve the data, or create a feature request (subject for review), for its support in the Google Ads API.

Best regards,

Google Logo
Peter Laurence
Google Ads API Team
 


ref:_00D1U1174p._5004Q2h1y7B:ref

Max

unread,
Dec 12, 2022, 2:53:45 PM12/12/22
to Google Ads API and AdWords API Forum
Hi Peter,

as for "v8 is sunset": I referred to the REST API which is v11 and Flo was referring to RPC v12 – the v8 blog-article was just posted in order to ask weather this is still so beta'ish (as per the current API labels) that this might be the reason we could not find any actual data in the tracking itself.

We will proceed and ask the Google Ads Product Support Team for further insights and get back to you guys once we have an answer!

Thank you
Max
Reply all
Reply to author
Forward
0 new messages