Platform X
Search…
⌃K

Google Enhanced Conversions

Taking advantage of the Google Ads API, you can leverage the enhanced conversions feature to send first-party customer 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.

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 at least a Google Ads Conversion Name and a field 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". It's used to retrieve your gclid from cookie(s).
[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".

Field mappings

Commanders Act Properties
Google Enhanced Conversions Properties
device.user_agent
conversionAdjustments.X.userAgent
properties.id
conversionAdjustments.X.orderId
event_timestamp
conversionAdjustments.X.gclidDateTimePair.conversionDateTime [1] and conversionAdjustments.X.adjustmentDateTime [1]
properties.value
conversionAdjustments.X.restatementValue.adjustedValue
properties.currency
conversionAdjustments.X.restatementValue.currencyCode
properties.user.email or properties.user.email_sha256
conversionAdjustments.X.userIdentifiers.Y.hashedEmail [2]
properties.user.phone
conversionAdjustments.X.userIdentifiers.Y.hashedPhoneNumber [3]
properties.user.firstname
conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedFirstName [3]
properties.user.lastname
conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedLastName [3]
properties.user.streetAddress
conversionAdjustments.X.userIdentifiers.Y.addressInfo.hashedStreetAddress [3]
properties.user.city
conversionAdjustments.X.userIdentifiers.Y.addressInfo.city
properties.user.state
conversionAdjustments.X.userIdentifiers.Y.addressInfo.state
properties.user.country
conversionAdjustments.X.userIdentifiers.Y.addressInfo.countryCode
properties.user.zipcode
conversionAdjustments.X.userIdentifiers.Y.addressInfo.postalCode
[1] This value is automatically adjusted. See GclidDateTimePair for more details. [2] Ifproperties.user.emailis provided, it's hashed usingSHA-256, otherwise, properties.user.email_sha256is used. [3] Normalized and hashed usingSHA-256.