Conversion Post for GBRAID & WBRAID click identifiers

1,375 views
Skip to first unread message

G San

unread,
May 7, 2024, 8:41:11 PM5/7/24
to Google Ads API and AdWords API Forum
Hi Google Support,

Our organisation is sending Conversion Events to Google Ads via API.

The Ad Links we get usually have GCLID, and we are able to submit leads just fine with it.
We're using Enhanced Conversions for Leads method:

But when our Ad Link uses GBRAID and WBRAID instead of GCLID, it starts to breakdown and we get this error:
The field cannot be set., at conversions[0].user_identifiers

We looked around documentation and the only conversion posting article that I saw with reference to GBRAID and WBRAID is using the Upload Clicks method: 
But when we switch to this method using GBRAID/WBRAID we get this error instead:
Conversion actions that use one-per-click counting can't be used with gbraid or wbraid parameters., at conversions[0].conversion_action

How can we post conversions when it only has GBRAID/WBRAID?
Does it not work for Enhanced Conversion for Leads method?

Thank you!


David Levin

unread,
Oct 29, 2024, 2:29:13 PM10/29/24
to Google Ads API and AdWords API Forum
I am seeing the "The field cannot be set., at conversions[0].user_identifiers" occasionally as well when the clickId is a gbraid and not a gclid.
We are using v18 of the REST API: https://developers.google.com/google-ads/api/rest/reference/rest/v18/customers/uploadClickConversions

Did you ever find a solution for this issue? I couldn't find anything else on the internet, so I have a feeling this is a bug with Google's API.

سعد الحربي

unread,
Oct 29, 2024, 2:36:34 PM10/29/24
to da...@angrysam.com, Google Ads API and AdWords API Forum


احصل على Outlook for Android

From: adwor...@googlegroups.com <adwor...@googlegroups.com> on behalf of David Levin <da...@angrysam.com>
Sent: Tuesday, October 29, 2024 9:29:13 PM
To: Google Ads API and AdWords API Forum <adwor...@googlegroups.com>
Subject: Re: Conversion Post for GBRAID & WBRAID click identifiers
 
--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
 
You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwor...@googlegroups.com
To unsubscribe from this group, send email to
adwords-api...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups "Google Ads API and AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/adwords-api/7ea1f8dd-cfa2-4805-941b-50da2b82a962n%40googlegroups.com.

Google Ads API Forum Advisor

unread,
Oct 30, 2024, 1:27:11 AM10/30/24
to da...@angrysam.com, adwor...@googlegroups.com

Hi,

Thank you for reaching out to the Google Ads API support team.

I would like to inform you that the Enhanced Conversions for Leads can't be used with either WBRAID or GBRAID identifiers. You are getting the VALUE_MUST_BE_UNSET error on the user_identifiers field because the presence of user_identifiers is what denotes the request as an Enhanced Conversions for Leads request. If you want this error to be resolved, you will need to remove the user_identifiers field, then try making the API request again and let us know how it goes from your end.

For ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID error, I would suggest using different counting type, specifically the MANY_PER_CLICK. Additionally, you can use this conversion_action report to retrieve and check conversion action instances. For your reference, you may also refer to this help center article about conversion counting options.

If the issue still persists, kindly provide the complete API logs (request and response with request-id and request header) generated at your end when you are creating click conversations. Please note that logs are crucial to replicate and address your issue.

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java.NetPHPPythonRuby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

You can send the details via Reply privately to the author option, or direct private reply to this email.
 
This message is in relation to case "ref:!00D1U01174p.!5004Q02vGhIA:ref" (ADR-00273796)

Thanks,
 
Google Logo Google Ads API Team


David Levin

unread,
Nov 18, 2024, 1:35:24 PM11/18/24
to Google Ads API Forum Advisor, adwor...@googlegroups.com
Thank you for your response. The conversion in question is already set up to count as "Every Conversion."  I am including a screenshot below for your reference. That's why I think this could be a bug in the REST API.

image.png

Google Ads API Forum Advisor

unread,
Nov 18, 2024, 3:10:37 PM11/18/24
to da...@angrysam.com, adwor...@googlegroups.com

Hi,

In order to assist you further, kindly provide the complete API logs (request and response with request-id and request header) generated at your end when you are creating click conversations. 

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java.NetPHPPythonRuby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

You can send the details via Reply privately to the author option, or direct private reply to this email.
 

This message is in relation to case "ref:!00D1U01174p.!5004Q02vGhIA:ref" (ADR-00273796)

Thanks,
 
Google Logo Google Ads API Team

Feedback
How was our support today?

rating1    rating2    rating3    rating4    rating5


 


David Levin

unread,
Nov 18, 2024, 5:39:03 PM11/18/24
to Google Ads API and AdWords API Forum
I send a copy of the request and response with the RequestID included privately to the author.

Google Ads API Forum Advisor

unread,
Nov 19, 2024, 3:45:42 AM11/19/24
to da...@angrysam.com, adwor...@googlegroups.com

Hi,

With regard to your concern, I am checking with the rest of my team and one of our colleagues will reach out to you once we have an update.

Google Ads API Forum Advisor

unread,
Nov 19, 2024, 12:12:10 PM11/19/24
to adwor...@googlegroups.com, da...@angrysam.com
Hi,

We have an update. As mentioned earlier, the issue here is that Enhanced Conversions for Leads can't be used with either WBRAID or GBRAID identifiers. You are getting the error on the user_identifiers field because the presence of user_identifiers is what denotes the request as an Enhanced Conversions for Leads request. If you want this error to be resolved, you will need to remove the user_identifiers field.

I hope this clarifies.

David Levin

unread,
Nov 19, 2024, 1:25:17 PM11/19/24
to Google Ads API Forum Advisor, adwor...@googlegroups.com
I'm confused. Can you please clarify? The conversion action in question is not an Enhanced Conversion for Leads; it's an Enhanced Conversion for Purchases.

Google Ads API Forum Advisor

unread,
Nov 20, 2024, 1:05:16 AM11/20/24
to da...@angrysam.com, adwor...@googlegroups.com
Hi,

I understand that you had a confusion between what are enhanced conversions for leads and enhanced conversion for purchases (as you call it).

There is no enhanced conversion type called "enhanced conversions for purchases" in the Google Ads API. Note that 'purchase' here is a conversion goal. You can set up conversion goals to track important actions that your customers take, such as making a purchase or signing up for your newsletter. Learn more about conversion goals.

On a whole, the enhanced conversions help you to improve the accuracy of your conversion measurement by supplementing your existing conversion tags with first-party conversion data, like email address, name, home address, and phone number. The enhanced conversion type that's the best fit for you depends on what you're looking to track. Enhanced conversions for web are relevant for advertisers who want to track sales and events that happen on a website. Enhanced conversions for leads are relevant for advertisers who want to track sales that happen off a website (for example, phone or email) from website leads. They improve measurement of offline transactions that came from a website lead or visitor. Refer to this guide on 'Get started with enhanced conversions' for more information.

So, for your conversion action with ID: 1046888366 (Purchase), the conversion_action_type is UPLOAD_CLICKS, which means you are implementing enhanced conversions for leads.

David Levin

unread,
Nov 20, 2024, 1:59:06 PM11/20/24
to Google Ads API Forum Advisor, adwor...@googlegroups.com
Thank you so much for the clarification!  I see what you mean now, and I appreciate the detailed explanation.

O K

unread,
Dec 3, 2024, 4:49:34 AM12/3/24
to Google Ads API and AdWords API Forum

Still, there is clarification needed.

In case GBRAID and user identifiers cannot be processed in one API call, I found that I can call once with GBRAID and a second time with the user identifier. There is no error in this case. But still, I don't know how to check which identifier was used by Google's internals to bind conversion to showed ads.

Also, I see that my conversions have both GBRAID and a short GCLID.

So, the question is, what is the best strategy?

Is it okay if I upload one conversion with GBRAID and a second time with GCLID and the user identifier? They are deduplicated by orderId, so there is no trouble with duplicates.

But which one will be used by ad campaigns after that?

Google Ads API Forum Advisor

unread,
Dec 3, 2024, 11:17:07 PM12/3/24
to pana...@gmail.com, adwor...@googlegroups.com
Hi,

Note that enhanced conversions for leads can't be used with either WBRAID or GBRAID identifiers. You can upload one conversion with GBRAID and a second time with GCLID and the user identifier. Also, the order_ids must be unique across your uploaded conversions. If you try to upload multiple conversions with the same order ID, you will receive the ConversionUploadError.DUPLICATE_ORDER_ID

Additionally, you may refer to the usage flow for more details. Before implementing EC for leads, make sure you have followed these prerequisites.

I hope this clarifies. Let us know if you have any further questions. 

tamrynleahw

unread,
Dec 9, 2024, 3:09:44 AM12/9/24
to Google Ads API and AdWords API Forum, Christos, Google Maps Timeline, do_not...@telkom.co.za, pana...@gmail.com, tamryn Leah walker, tamryn Leah walker, walkertamrynleah, tamry...@gmail.com




Sent from my Samsung Galaxy smartphone.

-------- Original message --------
From: O K <pana...@gmail.com>
Date: 12/3/24 11:49 (GMT+02:00)
To: Google Ads API and AdWords API Forum <adwor...@googlegroups.com>
Subject: Re: conversion post for gbraid & wbraid click identifiers

Still, there is clarification needed.

In case GBRAID and user identifiers cannot be processed in one API call, I found that I can call once with GBRAID and a second time with the user identifier. There is no error in this case. But still, I don't know how to check which identifier was used by Google's internals to bind conversion to showed ads.

Also, I see that my conversions have both GBRAID and a short GCLID.

So, the question is, what is the best strategy?

Is it okay if I upload one conversion with GBRAID and a second time with GCLID and the user identifier? They are deduplicated by orderId, so there is no trouble with duplicates.

But which one will be used by ad campaigns after that?


On Wednesday, November 20, 2024 at 8:05:16 AM UTC+2 Google Ads API Forum Advisor wrote:
Hi,

I understand that you had a confusion between what are enhanced conversions for leads and enhanced conversion for purchases (as you call it).

There is no enhanced conversion type called "enhanced conversions for purchases" in the Google Ads API. Note that 'purchase' here is a conversion goal. You can set up conversion goals to track important actions that your customers take, such as making a purchase or signing up for your newsletter. Learn more about conversion goals.

On a whole, the enhanced conversions help you to improve the accuracy of your conversion measurement by supplementing your existing conversion tags with first-party conversion data, like email address, name, home address, and phone number. The enhanced conversion type that's the best fit for you depends on what you're looking to track. Enhanced conversions for web are relevant for advertisers who want to track sales and events that happen on a website. Enhanced conversions for leads are relevant for advertisers who want to track sales that happen off a website (for example, phone or email) from website leads. They improve measurement of offline transactions that came from a website lead or visitor. Refer to this guide on 'Get started with enhanced conversions' for more information.

So, for your conversion action with ID: 1046888366 (Purchase), the conversion_action_type is UPLOAD_CLICKS, which means you are implementing enhanced conversions for leads.


I hope this clarifies.

 
This message is in relation to case "ref:!00D1U01174p.!5004Q02vGhIA:ref" (ADR-00273796)

Thanks,
 
Google Logo Google Ads API Team

Feedback
How was our support today?

rating1    rating2    rating3    rating4    rating5



--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
 
You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwor...@googlegroups.com
To unsubscribe from this group, send email to
adwords-api...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups "Google Ads API and AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api...@googlegroups.com.

tamrynleahw

unread,
Dec 9, 2024, 3:09:56 AM12/9/24
to tamryn Leah walker, Google Ads API and AdWords API Forum, tamry...@gmail.com
Tamryn walker 
Reply all
Reply to author
Forward
0 new messages