Links

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. 1.
    _gcl_aw
  2. 2.
    _gcl_dc
  3. 3.
    _gac_[GA_PROPERTY_ID]

Configuration

Settings
Description
Authentication
Required
Your credentials with Google Ads as set in the Commanders Act interface following: AdministrationConnector CredentialsAdd connector credentialsGoogle 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 & SETTINGSMeasurementConversionsConversion 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.emailoruser.email_sha256
  • user.phone
  • user.firstname
  • user.lastname
  • user.streetAddress
  • user.city
  • user.state
  • user.country
  • user.zipcode
This will prevent the errorincomplete_any_user_identifier_is_requiredto 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] Ifuser.emailis provided, it's hashed using SHA256, otherwise , user.email_sha256is used. [3] Normalized and hashed via SHA256. [4] See Destination setup for more details.