Google Ads API is returning to beta status. Please read our blog post for more details.

Customer Match

Customer Match with email address, address, or user ID

For advertisers with rich CRM databases, you can define and target audience lists based on your CRM data. You can upload CRM data in bulk, append/remove data, or use these user lists to create a logical_user_list.

These audience lists are eligible to serve on Google Search, YouTube, and Gmail but will not be available on the Google Display Network.

Per policy, you will only be allowed to upload data that you have acquired yourself (first party). You are not allowed to buy email lists from third parties and upload them into the account.

For privacy concerns, email addresses, first names, and last names must be hashed using the SHA-256 algorithm before being uploaded. In order to standardize the hash results, prior to hashing one of these values you must:

  • Remove leading/trailing whitespaces.

  • Convert the text to lowercase.

Options for Customer Match in different campaign types

Search network only campaigns
A crm_based_user_list is available. Ads will show on the search network.
Display network only campaigns
A crm_based_user_list and its similar_user_list are available. Ads will show on Gmail only if there are GSP creatives.
Search network with display select campaigns
A crm_based_user_list is available. Ads will show on the search network and on Gmail (only if there are GSP creatives).
Video campaigns
A crm_based_user_list and its similar_user_list are available. Ads will show on YouTube only if there are in-stream TrueView ads.

Customer Match with phone number

Similar to Customer Match with emails, you can also perform customer matching with phone numbers.

For privacy concerns, the phone number needs to be hashed using the SHA-256 algorithm before being uploaded. In order to standardize results, convert each phone number to E164 format before hashing. This format represents a phone number as a number up to fifteen digits in length starting with a + sign (e.g. +12125650000, +442070313000).

If the phone number is not correctly formatted before hashing, the API will still accept the hashed phone number, but the phone number will not be matched with a customer.

Customer Match with mobile device IDs

Similar to Customer Match with emails, you can also perform customer matching using IDFA (Identifier for Advertising) or AAID (Google Advertising ID) mobile device IDs. Note that mobile device IDs cannot be combined with any other types of customer data.

Customer Match considerations

When implementing Customer Match, keep the following points in mind:

  • It takes 6 to 12 hours for a list to be populated with members, so you'll most likely see an "In Progress" status (on the Google Ads UI) if you upload to an audience list more frequently than once every 12 hours.

  • For privacy purposes, the user list size will show as zero until the list has at least 1,000 members. After that, the size will be rounded to the two most significant digits.

  • Upload at least 5,000 members to the list to ensure that ads start serving.

  • A crm_based_user_list can only be combined with another crm_based_user_list when using a logical_user_list. All the policies for crm_based_user_list will apply to the result user list.