Which API endpoint would you use?

139 views
Skip to first unread message

Brian I

unread,
Feb 13, 2023, 9:40:36 PM2/13/23
to Google Ads API and AdWords API Forum
My site has 3 "lead" events:

- User signs up for the site by providing their email
- User starts a free 7-day trial (by submitting a CC)
- User becomes a full member if CC is charged by Stripe on the 7th day

The first 2 events occur on the site, so I have pixels in place. The 3rd event occurs behind the scenes and I receive the updates via a Stripe webhook.

My questions are:

1. For the first 2 events, which API endpoint is best to send this data to Google to make sure 100% of conversions are attributable via the GCLID?

2. For the last event, which API endpoint is best since Google will not be aware this subscription took place?

In the campaign setup, I'm optimizing for all 3 events and they are ranked by conversion value (full member is worth say $50, trial is $1, and providing email is $0.50).

I did notice a few threads that appeared similar, but couldn't find a use case that covered both scenarios, so figured I'd ask.

Appreciate any insight or help.

Thanks,
Brian

Brian I

unread,
Feb 13, 2023, 10:13:22 PM2/13/23
to Google Ads API and AdWords API Forum
This is what I'm assuming I'd want to use for the 3rd event (the actual subscription): https://developers.google.com/google-ads/api/docs/conversions/upload-clicks#upload_clickconversion

and for the first two, I'd use ConversionAdjustment, but please correct me if I'm wrong and there is a more appropriate choice.

Thanks.

Google Ads API Forum Advisor

unread,
Feb 14, 2023, 3:07:46 AM2/14/23
to biac...@gmail.com, adwor...@googlegroups.com

Hi Brian,


Thanks for reaching out to the Google Ads API team. I hope you are doing well today.
 

Please see my answer to your question below.
 

1.) For the first 2 events, which API endpoint is best to send this data to Google to make sure 100% of conversions are attributable via the GCLID?
 

  • The API endpoint conversions attributable to GCLID is this customer. uploadClickConversions as the Google click ID (gclid) associated with this conversion.


2.) For the last event, which API endpoint is best since Google will not be aware this subscription took place?
 

  • Could you elaborate more on this so our team provides precise guidance accordingly?


Additionally, you may also check this upload click conversions and Upload Conversion Adjustments for more information.


Regards,

Google Logo
Darwin
Google Ads API Team
 



ref:_00D1U1174p._5004Q2izst0:ref

Brian I

unread,
Feb 14, 2023, 9:14:53 AM2/14/23
to Google Ads API and AdWords API Forum
Hi Darwin

For the first 2 events, I'd want to use the uploadClickConversions even though a web pixel is also firing for both events and this is just for redundancy/accuracy purposes mainly in light of iOS updates?

For the last one, this is for a subscription that occurs at Stripe after a 7-day free trial. If the credit card is successfully charged and the user becomes a full member, there isn't any way for Google to know that occurred since there isn't an equivalent web pixel firing on Stripe's end, so I will pass the information back to Google Ads via the API using the GCLID.

Let me know if that helps clarify.

Thanks.

Brian I

unread,
Feb 14, 2023, 9:20:44 AM2/14/23
to Google Ads API and AdWords API Forum
Just to further clarify, it'd be like this in order of events:

1. User joins newsletter. A pixel fires. I also send this conversion via API.

2. User signs up for a free trial. A pixel fires. I also send this conversion via API.

3. User becomes a full member after trial ends automatically. A pixel does not fire. I send this conversion via API.

Three different conversion goals are setup in Measurement > Conversions, the last of which is "offline".

Thanks.

Google Ads API Forum Advisor

unread,
Feb 14, 2023, 2:48:12 PM2/14/23
to biac...@gmail.com, adwor...@googlegroups.com

Hi, 

This is Marjorie from the Google Ads API team as well. Thank you for getting back to us.

Moving forward to your concern, regarding conversions. Did you follow the provided information and guidelines by my colleague “Darwin” or are there any API implementation questions that we may help you with? 

If so, you may provide the complete API request and response logs with request-id and login-customer-id that are generated on your end. If you haven't yet, logging can be enabled by navigating to the Client libraries > Your client library (ex. Java) > Logging documentation, which you can access from this link.

For REST interface requests, you can enable logging via the curl command by using the -i flag. This will cause the tool to include HTTP response headers in the output.

In line with this matter, we recommend the REST API endpoints. Below after the creating uploadClickConversions then you may use the uploadConversionAdjustments for adjustments.
 


Have a great day.

Regards,

Google Logo
Marjorie
Google Ads API Team
 


ref:_00D1U1174p._5004Q2izst0:ref
Reply all
Reply to author
Forward
0 new messages