Send feedback
Customer Match overview
Stay organized with collections
Save and categorize content based on your preferences.
The Data Manager API supports the following
Customer Match features for Google Ads:
Customer Match using contact information (such as email address, phone number,
and address information), IP address data , or both.
Customer Match using mobile IDs.
Customer Match using user IDs.
Create an audiencearrow_forward
Upload membersarrow_forward
Workflow overview
To create and manage a Customer Match audience in a Google Ads account, complete the
following steps:
Create an audience and note the value of its
id field, or use userLists.list
to retrieve the id of an existing Customer Match audience.
Upload members to the audience by passing the audience id
as the productDestinationId in an
audienceMembers.ingest request.
Check upload results and list size using request
diagnostics and the sizeInfo field on the audience.
Remove all members from an audience if you need to
replace or clear an existing audience.
If you're upgrading from the Google Ads API , see
Upgrade from the Google Ads API .
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-14 UTC."],[],[]]