Re-posting the last inquiry (https://groups.google.com/g/adwords-api/c/SDyRhokC9AA) from the forum as it wasn't routed to our support queue.
On Thursday, June 22, 2023 at 4:48:38 PM UTC+8 greg....@oxbridge.email wrote: > I have looked at the examples again and have looked at the source code. > > I think that fundamentally this is an issue with Google's documentation > (unsurprising based on past experience, but anyway, I digress...). > > While at first glance *Upload Offline Conversion* > <https://developers.google.com/google-ads/api/samples/upload-offline-conversion> > > and *Upload Conversion with Identifiers* > <https://developers.google.com/google-ads/api/samples/upload-conversion-with-identifiers> > look > like different calls, they use *the same class* (ClickConversion) - just > called with different parameters. Neither example passes the order id. > > Also *Upload Conversion Enhancement* > <https://developers.google.com/google-ads/api/samples/upload-conversion-enhancement> > > and *Upload Conversion Adjustment* > <https://developers.google.com/google-ads/api/samples/upload-offline-conversion> > use > the same class (ConversionAdjustment), the adjustment type alters the > behaviour and whether some of the properties change from optional to > required. > > Here's a table showing what parameters are supported (has value) and which > are shown in the above example code (highlighted in blue). > > [image: conversions.png] > > Based on the above (*and it would be great if someone at Google could > confirm this!) *the best practice would be. > > 1. Log your ClickConversion with gclid/wbraid/gbraid, *and include > order_id *(for step 2). You probably could pass identifiers here, but > you might want to do that on step 2 for simpliccity. > 2. To enhance the conversion, call ConversionAdjustment, with the same > *order_id > *(as you can only do gclid/datetime pairs and *not *pairs with > wbraid/datetime or gbraid/datetime, this seems better way to reference a > unique conversion from step 1) and include: > a) user agent > b) all the user identifiers you have: hashes of name, phone, email, > postal address etc. > > Any adjustments are separate, hopefully it's clear to see what to do in > the last three columns. > > Ultimately I think the best actions variables to send are: > [image: conversions2.png] > > > 1. Upload with gclid/gbraid/wbraid and order_id > 2. Enhance the conversion by referencing order_id. > 3. Adjusting by referencing order_id > > I think that's it? As I said before - it would be great to have someone at > Google confirm this! > > Kind regards > Greg > > > On Wednesday, 21 June 2023 at 16:07:32 UTC+1 Google Ads API Forum Advisor > wrote: > >> Hi, >> >> Thank you for getting back to us. >> >> I understand that you want to upload click conversions and conversion >> adjustments (enhanced conversions) through the API. Please note that you >> need to associate your offline click conversions with a conversion action >> by passing the *gclid* identifier. In addition, provide the conversion >> date time, conversion action resource name and optionally the conversion >> value and currency to *ConversionUploadService. *Please use this code >> example ( >> *https://developers.google.com/google-ads/api/docs/conversions/upload-clicks#code_example* >> >> <https://developers.google.com/google-ads/api/docs/conversions/upload-clicks#code_example>) >> >> as reference. >> >> Additionally, in order to adjust a conversion, you must first have a >> conversion action *set up*, and you must also have recorded the >> conversions that you are about to adjust. With this, kindly check this code >> example ( >> https://developers.google.com/google-ads/api/docs/conversions/upload-adjustments#code_example) >> >> for reference. >> >> Please let us know if you have further questions. >> >> *Reference Links:* >> >> - *ConversionUploadService - * >> >> *https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionUploadService* >> >> >> <https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionUploadService> >> >> - *set up - *https://support.google.com/google-ads/answer/1722054 >> >> This message is in relation to case "ref:_00D1U1174p._5004Q2m9sBR:ref" >> >> Thanks, >> >> [image: Google Logo] Google Ads API Team >> >> >> -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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 adwords-api@googlegroups.com To unsubscribe from this group, send email to adwords-api+unsubscr...@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+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/adwords-api/ecfc7c71-974c-4833-8bf1-a70768fc400bn%40googlegroups.com.
