Google Conversion Adjustments

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).

Destination setup

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_FOUNDorTOO_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:

1. _gcl_aw

2. _gcl_dc

3. _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.

Configuration

Settings	Description
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 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 gclid from cookies. See Destination setup for more details.

Field mappings

The transaction identifier (id) is required in any of the following conditions:

1. The type of the conversion action is equal to Website / WEBPAGE .

2. 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 .

Commanders Act Properties	Google Properties
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.