Google Ads Enhanced Conversions for Web Connector Setup Guide | Server-Side Connectors

Prerequisites

Google Ads account with an Enhanced Conversions-enabled conversion. For more information, see About enhanced conversions for web in the Google Ads API.

Connector actions

Action Name	AudienceStream	EventStream
Send Conversion	✓	✓

API information

This connector uses the following vendor API:

API Name: Google Ads API
API Version: v17
API Endpoint: https://googleads.googleapis.com/
Documentation: Google Ads API: Enhanced Conversions

Batch limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

Max number of requests: 2000
Max time since oldest request: 10 minutes
Max size of requests: 2 MB

Configure settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

After adding the connector, configure the following settings:

Customer ID
Required. Provide Ads account customer ID to manage.
Manager Customer ID
Optional. If you’re accessing a client customer, the Manager Customer ID must be set.

Click Done when you are finished configuring the connector.

Action settings — parameters and options

Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Send Conversion

Parameters

Parameter	Description
Conversion Action	Select an existing conversion action. Conversion actions need to be configured in the Google Ads UI with a type of WEBPAGE, enhanced conversions enabled, and enhanced conversion implementation method set to API. For more information about enhanced conversions, see Google Ads Enhanced Conversion Tracking.
Transaction ID	ID that uniquely identifies a conversion event, generated by you as the advertiser. The value of this ID should equal the matching client-side event. We recommend using `order_ID` for purchases and `tealium_random` for other events. Not required if the Automatic Transaction ID is provided.
Conversion Value	Monetary value of the conversion.
Conversion Currency	Currency code of the conversion.
Conversion Time	The date and time when the original conversion occurred. The timezone must be specified. The format is yyyy-mm-dd hh:mm:ss+\|-hh:mm. For example, 2022-01-01 12:32:45-08:00. Default value is now.
Gclid	Google click identifier for the Ad click that led to the user conversion, where available.
User Agent	User agent of the user that converted, if such data is retained by advertiser.
Email Address (already SHA256 hashed)	Provide an email address that has been already whitespace trimmed, lowercased, and SHA256 hashed. Remove all periods (.) that precede the domain name in `gmail.com` and `googlemail.com` email addresses before hashing.
Email Address (apply SHA256 hash)	When a plain text email address is provided, the connector will remove all periods (.) that precede the domain name in `gmail.com` and `googlemail.com` email addresses, whitespace trim, lowercase, and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number according to the E164 standard that has been already whitespace trimmed and SHA256 hashed.
Phone Number (apply SHA256 hash)	When a plain text phone number is provided, the connector will remove all non-digit symbols, prefix the number with a plus sign (`+`), whitespace trim and hash this value using SHA256 hash.
Address Info: First Name (already SHA256 hashed)	Provide first name that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Address Info: First Name (apply SHA256 hash)	When a plain text first name is provided, the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Address Info: Last Name (already SHA256 hashed)	Provide last name that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Address Info: Last Name (apply SHA256 hash)	When a plain text last name is provided, the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Address Info: Street Address (already SHA256 hashed)	Provide street address that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Address Info: Street Address (apply SHA256 hash)	When a plain text street address is provided, the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Address Info: City	City of the user’s address.
Address Info: State	State code of the user’s address.
Address Info: Postal Code	Postal code of the user’s address.
Address Info: Country Code	2-letter country code in ISO-3166-1 alpha-2 of the user’s address.
Automatic Transaction ID	(Optional) When set to the Tealium iQ Tag ID, Tealium automatically looks for the transaction ID value that is sent from Tealium iQ. The tag template must be a version after April 2023 to use this feature. Either the Transaction ID or the Automatic Transaction ID must be provided.
Conversion Action Override	(Optional) Provide a Conversion Action ID to override the conversion action in the Required section. This parameter lets you use EventStream variables to populate the Conversion Action ID. To find the Conversion Action ID, go to your Google Ads dashboard, and click the conversion. The Conversion Action ID is the value of the `ctId` query parameter in the website URL. For example, if the URL is `https://ads.google.com/aw/conversions/detail?ctId=987654321`, the Conversion Action ID is `987654321`.

Error troubleshooting

The following are some common error codes and resolutions:

EC_MODE_MISMATCH: The conversion action has the incorrect conversion type in the Google Ads Platform. Change the converstion type to API in the Google Ads Platform under Tools > Conversions > Conversion Event.
INVALID_USER_CUSTOMER_AUTHORIZATION: The login used to authenticate to the Google Ads platform during connector setup needs to have at least read-only access for the account owning the audience list.
Invalid Parameter - Action has invalid parameter value or missing required parameter: This is an internal validation error from the connector raised when required fields are missing. One of the following Action Errors will be returned:
- Transaction ID cannot be empty: If a conversion does not have an order ID, tealium_random can be mapped in the client-side tag and the connector action configuration.
- Email or Phone Number or All Address Info need to be provided: Required PII for Enhanced Conversions are one set of the following:
  a) customer email
  b) customer first name, last name, street address, city, state, country, and zip code
  Ensure that required field values are present in the event data.

For more information, see Google Ads API Errors.