Upload customer targeting lists for offers
Google Pay’s customer targeting list uses info that your customers shared with you. To target offers and reach new customers, you can use the list.
Important: As Apple App Tracking Transparency (ATT) policies take effect, customer targeting lists won’t be available on iOS traffic.
Collection of customer data
When you use customer targeting lists, you can only upload customer info that you collected in the first-party context. This is info that you collected from your websites, apps, physical stores, or other situations where customers shared their info directly with you.
Examples of collected info
Info you collected from customers who:
- Bought an item from your website
- Registered to get marketing messages through your apps
- Signed up for your loyalty program in your physical store
You must also:
- Use only the Google approved API or interface to upload customer data.
- Comply with all applicable laws and regulations, including any self-regulatory or industry codes that may apply.
Upload files in CSV format
Customer Match data files must follow specific guidelines to be accepted. Incorrect formatting, including incorrect hashing, can lead to an upload error or a low number of matched records.
To avoid a low list size, make sure to follow these guidelines:
- Files must be in CSV fomat.
- For one user record, use commas to separate all identifiers. For different user records, use the standard unix newline character \n or a line break. Do not use space or semicolons.
- Headers must only be: Email, Phone. If a single customer has multiple email addresses, mailing addresses, or phone numbers, your file may include multiple “Email”, or “Phone” rows.
- Email addresses must have domain names like gmail.com or hotmail.co.jp.
- Phone numbers must start with the country code and followed by the 10-digit mobile number. For example, 91xxxxxxxxxx. Other formats like +91xxxxxxxxxx or 0xxxxxxxxxx or xxxxxxxxxx aren’t acceptable.
How it works
To advertise an offer to users who aren’t currently your customers:
- Create, hash, and upload a customer list data file of contact info that your customers gave you through Google Pay & Wallet Console. Use our template and follow our file formatting guidelines.
- Create your offer campaign and target the desired audience. The offer campaign should exclude users who are matched from your uploaded data set from targeting.
Users who are not on your list find the Google Pay offer when they sign in to their Google Pay app or other applicable Google service.
- If you update the list during the offer, we discard the old list and use the new one.
- If the new list excludes the names of users who have previously won the reward, their reward cannot be withdrawn.
Match email address & phone numbers
Google keeps track of email addresses and phone numbers to match Google Pay accounts with their corresponding hashed string.
When you upload your customer list, Google Pay compares each hashed string on your customer list with the hashed strings of Google Pay accounts. If there’s a match, Google adds the corresponding Google Account to your customer targeting list and targets the offer to users outside of that list.
Our file formatting guidelines
Your data must be in a CSV file and encoded in either ASCII or UTF-8. UTF-16 isn’t supported. You must also hash your data with the SHA-256 algorithm, which is the industry standard for one-way hashing. We only accept hashed files.
To create your own file, use our template.
Each row should only have one email and one phone number. The phone number must be formatted with the country code, phone number, and extension, if applicable. The phone number must be provided without any delimiters between each part.
Always put the email value in the first column and the phone value in the second. If you don’t have a value for either email or phone for the row, leave it blank. For a specific example, use our template.
When you enter data in your CSV file, use the formatting below:
Always put the email value in the first column and the phone value in the second. If you don’t have a value for either email or phone for the row, leave it blank.
Once your file is created and your data is entered, you must hash your data.
To hash your data files, Use this Customer Match Hash tool.
Here’s an example of data that’s been hashed:
Upload your file
When you’re approved to use the customer targeting list targeting feature:
- Click Campaigns.
- From the offers campaign, go to the “Customer targeting list” section.
- From your computer, upload your hashed file.
After the Google QA team tests your offer, it becomes live on Google Pay.
If you have questions about this policy, contact your Google point of contact.