Google Enhanced Conversions

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, you can leverage the enhanced conversions feature to send first-party data in the form of conversion adjustments. Google uses this additional data to improve the reporting of your online conversions driven by ad interactions. The enhanced conversions supplement your existing conversion tags by sending hashed first-party conversion data from your website to Google in a privacy-safe way.

You must complete the setup and configuration steps before you can bridge enhanced conversions via the Google Ads API.

Destination setup

Your user account needs admin rights in the Google Ads Manager Accounts where the conversion action is located. When available, this destination will also include thegclidvalue by looking for the following cookies in this priority order:

1. _gcl_aw

2. _gcl_dc

3. _gac_[GA_PROPERTY_ID]

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 enhanced conversions 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 [1] If a conversion action is not found the event will be discarded.
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.

[1] Enhanced conversions must be enabled for your conversion action. This is done in the Google Ads interface following these steps: click on the conversion action ➜ expand Enhanced conversions ➜ flag Turn on enhanced conversions ➜ select API .

Flag "Turn on enhanced conversion" and select "API".

Quick reference

Commanders Act Events	Google Tracking
[Any Event] [1]	customers.uploadConversionAdjustments

[1] See Mapping for more details.

Field mappings

At least one of the following user identifiers must be set:

• user.email or user.email_sha256

• user.phone

• user.firstname

• user.lastname

• user.streetAddress

• user.city

• user.state

• user.country

• user.zipcode

This will prevent the error incomplete_any_user_identifier_is_required to be raised.

Commanders Act Properties	Google Enhanced Conversions Properties
id	conversionAdjustments.X.orderId [*]
context.device.user_agent	conversionAdjustments.X.userAgent
event_timestamp	conversionAdjustments.X.gclidDateTimePair.conversionDateTime [1] and conversionAdjustments.X.adjustmentDateTime [1]
value	conversionAdjustments.X.restatementValue.adjustedValue
currency	conversionAdjustments.X.restatementValue.currencyCode
user.email user.email_sha256	conversionAdjustments.X.userIdentifiers.Y.hashedEmail [2]
user.phone	conversionAdjustments.X.userIdentifiers.Y.hashedPhoneNumber [3]
user.firstname	conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedFirstName [3]
user.lastname	conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedLastName [3]
user.streetAddress	conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedStreetAddress [3]
user.city	conversionAdjustments.X.userIdentifiers.Y.addressInfo.city
user.state	conversionAdjustments.X.userIdentifiers.Y.addressInfo.state
user.country	conversionAdjustments.X.userIdentifiers.Y.addressInfo.countryCode
user.zipcode	conversionAdjustments.X.userIdentifiers.Y.addressInfo.postalCode
Cookie _gcl_aw Cookie _gcl_dc Cookie _gac_[GA_PROPERTY_ID]	conversionAdjustments.X.gclidDateTimePair.gclid [4]

[*] Mandatory property. [1] This value is automatically adjusted. See GclidDateTimePair for more details. [2] If user.email is provided, it's hashed using SHA256, otherwise , user.email_sha256 is used. [3] Normalized and hashed via SHA256. [4] See Destination setup for more details.