Google Ads Customer Match Connector Setup Guide

This connector replaces the deprecated Google AdWords Customer Match connectors.

Connector actions

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

API information

This connector uses the following vendor API:

• API Name: Google Ads API
• API Version: v12
• API Endpoint: <https://googleads.googleapis.com/>
• Documentation: Google Ads API

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.

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

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.

Actions

Enter a name for the action and select the action type from the drop-down menu.

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

User Identifiers

Each action requires a user identifier and the vendor requires these values to be normalized and hashed using SHA-256. Each user identifier value mapped is expected to meet the following requirements:

• Lower-case
• Trimmed whitespace from the front and end of the text
• Hashed with SHA-256

You can map attributes that are already normalized and hashed or you can allow the connector to normalize and hash them for you. Select the appropriate mapping for your scenario.

The required user identifier is based on the User List type selected. The User List type can be one of the following:

• CONTACT_INFO
• CRM_ID
• MOBILE_ADVERTISING_ID

The following user identifier fields are supported:

User Identifier Field	Description
CONTACT_INFO	Provide Hashed Email, Hashed Phone Number or Address Info. Address Info: Country Code - 2-letter country code in ISO-3166-1 alpha-2 of the user’s address. Address Info: First Name (already SHA256 hashed) - Provide first name which has been already whitespace trimmed, lowercased and SHA256 hashed. Address Info: First Name (apply SHA256 hash) - Provide a plain text first name and the connector will hash this value using SHA256 hash. Address Info: Last Name (already SHA256 hashed) - Provide last name which has been already whitespace trimmed, lowercased and SHA256 hashed. Address Info: Last Name (apply SHA256 hash) - Provide a plain text last name and the connector will hash this value using SHA256 hash. Address Info: Postal Code - Postal code of the user’s address. Email Address (already SHA256 hashed) - Provide an email address which has been already whitespace trimmed, lowercased and SHA256 hashed. Email Address (apply SHA256 hash) - Provide a plain text email address and the connector will hash this value using SHA256 hash. Phone Number (already SHA256 hashed) - Provide a phone number which has been already whitespace trimmed, lowercased and SHA256 hashed. Phone Number (apply SHA256 hash) - Provide a plain text phone number and the connector will hash this value using SHA256 hash.
CRM_ID	User ID (Required) - Advertiser-assigned user ID for Customer Match upload.
MOBILE_ADVERTISING_ID	Mobile ID (Required) - Mobile device ID (advertising ID/IDFA).

Add User to Remarketing List

Batch Limits

This action 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: 33000
• Max time since oldest request: 60 minutes
• Max size of requests: 40 MB

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.

Remove User from Remarketing List

Batch Limits

This action 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: 33000
• Max time since oldest request: 60 minutes
• Max size of requests: 40 MB

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.

Bulk Add Users to Remarketing List

Batch Limits

This action 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: 33000
• Max time since oldest request: 60 minutes
• Max size of requests: 40 MB

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.

Bulk Remove Users from Remarketing List

Batch Limits

This action 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: 33000
• Max time since oldest request: 60 minutes
• Max size of requests: 40 MB

Parameters

Parameter	Description
Remarketing List	Select a remarketing user list. For more information, see: Remarketing and Audience Targeting. Available options contain only user lists of first party CRM data type.