This destination is currently under final review and will be available soon.
Google is a multinational technology company focusing on online advertising, search engine technology, cloud computing, and computer software. Taking advantage of the Google Ads API Upload Conversion Adjustments, you can amend conversions values initially reported by other means (E.g. via client-side tags).
To adjust a conversion, you must first have a conversion action set up, and conversions must have been reported in Google Ads interface.
Google recommends waiting 24 hours after a conversion is reported before sending adjustments. This will avoidCONVERSION_NOT_FOUND
orTOO_RECENT_CONVERSION
upload errors. Also, wait 4-6 hours after creating a conversion action before adjusting its conversions to avoid a TOO_RECENT_CONVERSION_ACTION
upload error.
To identify the conversion and when a transaction identifier is not provided, this destination will try to include the gclid
if its value is provided in the Google Click Id
field (See Configuration for more details). If this is not set, the following cookies, in the presented priority order, are used to retrieve a proper value:
_gcl_aw
_gcl_dc
_gac_[GA_PROPERTY_ID]
On the other hand, when a transaction identifier is present both the gclid
and conversionDateTime
are removed from the hit to prevent the GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET
upload error. More details on all upload errors are available following this LINK.
Conversion adjustments don't work with conversion actions whose type is UNKNOWN
. In addition, adjustments for a conversion whose click has a gbraid
or wbraid
instead of a gclid
will fail with a CONVERSION_NOT_FOUND
upload error.
Authentication
Required
Your credentials with Google Ads as set in the Commanders Act interface following: Administration
➜ Connector Credentials
➜ Add connector credentials
➜ Google Ads
Mapping
Required
Map your Google Ads Conversion Name(s), where conversion value adjustments are applied, with Commanders Act event(s) by setting your Google Ads Conversion Name
and Your event name
. At least one line is required. Conversion names can be found in the Google Ads interface following: TOOLS & SETTINGS
➜ Measurement
➜ Conversions
➜ Conversion action
.
If a conversion action is not found the event will be discarded.
Google Click Id
Google click Id (gclid) associated with the original conversion. This field has priority over related cookies.
Google Analytics Property Id
The transaction identifier (id
) is required in any of the following conditions:
The type of the conversion action is equal to Website
/ WEBPAGE
.
The original conversion you are adjusting was assigned a transaction identifier.
If Transaction Adjusted Timestamp (adjustmentDateTime)
"Smart Mapping" field is not set, this destination will use the current timestamp to set the Google property conversionAdjustments.0.adjustmentDateTime
.
Google properties are set starting from the path conversionAdjustments.0
.
value
restatementValue.adjustedValue
[*]
id
orderId
[1]
currency
restatementValue.currencyCode
context.event_timestamp
gclidDateTimePair.conversionDateTime
Google Click Id
Cookie _gcl_aw
Cookie _gcl_dc
Cookie _gac_[GA_PROPERTY_ID]
gclidDateTimePair.gclid
[2]
[*] Mandatory property. [1] This is required when specific conditions are verified. See Field mappings for details. [2] See Destination setup for more details.
The GA Tracking Id is a string like "UA-XXXXXX-Y" or "G-XXXXXXXXXX" for Google Analytics 4. It's used as an alternative method to retrieve the from cookies. See for more details.