Google AdWords Customer Match Connector Setup Guide | Server-Side Connectors |Tealium Docs

This connector is now deprecated and no longer available in the tag marketplace.
The underlying Google AdWords API is planning to be retired on April 27, 2022. Learn more from the Google Ads Developer Blog.
You need to replace your existing Google AdWords connectors with the updated Google Ads Customer Match connector.

Requirements

There are two types of Google AdWords Customer Match Connectors. Ensure that you select the appropriate one when adding the connector.

Google Adwords Customer Match (Customer-Provided Credentials)
- Requires Google approval.
Google Adwords Customer Match (Tealium-Provided Credentials)
- Tealium has been pre-approved to handle volume, bypassing your need to go through the application process.

Connector actions

Action Name	AudienceStream	EventStream
Add User to Remarketing List	✓	✓
Remove User from Remarketing List	✓	✓

API information

This connector uses the following vendor API:

API Name: Google Audience Partner API DmpUserListService
API Version: v201809
API Endpoint: <https://ddp.googleapis.com/>
Documentation: AdWords API

Batch limits

This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met:

Max number of requests: 100000
Max time since oldest request: 60 minutes
Max size of requests: 100 MB

Configure settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

When you add this connector you are prompted to accept the vendor’s data platform policy.

After adding the connector, configure the following settings:

AdWords Customer ID
- Required
- Provide the Adwords account Customer ID to manage.
Developer Token
- Required
- Provide the API developer token that has been approved by Google to make production volume API requests.
- Obtaining and approving a developer token is a multi-step process that you will need to own and manage.
- To get started, click here.

Action settings - parameters and options

Click Next or go to the Actions tab. This is where you configure connector actions.

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

Action - Add User to Remarketing List

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list to add user to. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.
User Identifier	Required. Map applicable user identifier. For additional information, see: Remarketing and Audience Targeting. Required fields depend on the list type selected, as follows: Contact Info (`CONTACT_INFO`) Minimum Required: Email, Phone Number or All Address information. Email, Phone Number, First and Last Name must be trimmed of whitespace, lowercased and SHA-256 encoded. If mapped values are plain text, check the Contact Info Hash check box in the optional section. Country Code must follow the 2-letter ISO-3166 Alpha-2 format. CRM (`CRM_ID`) Required User ID Advertiser generated and accessible to whitelisted clients only. Mobile Advertising (`MOBILE_ADVERTISING_ID`) Required Mobile ID Mobile Device ID (advertising ID/IDFA).
Contact Info Hash	Optional Check if mapped contact information is in plain text. Values are automatically SHA-256 hashed.

Action - Remove User from Remarketing List

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list to remove user from. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.
User Identifier	Required. Map applicable user identifier. For additional information, see: Remarketing and Audience Targeting. Required fields depend on the list type selected, as follows: Contact Info (`CONTACT_INFO`) Minimum Required: Email, Phone Number or All Address information. Email, Phone Number, First and Last Name must be trimmed of whitespace, lowercased and SHA-256 encoded. If mapped values are plain text, check the Contact Info Hash check box in the optional section. Country Code must follow the 2-letter ISO-3166 Alpha-2 format. CRM (`CRM_ID`) Required User ID Advertiser generated and accessible to whitelisted clients only. Mobile Advertising (`MOBILE_ADVERTISING_ID`) Required Mobile ID Mobile Device ID (advertising ID/IDFA).
Contact Info Hash	Optional Check if mapped contact information is in plain text. Values are automatically SHA-256 hashed.