google_ads_upload_customer_match
Upload hashed customer data (emails, phones, addresses) to Google Ads for targeting across Search, YouTube, Gmail, and Display networks.
Instructions
Upload Customer Match data (emails, phones, addresses).
Customer Match allows you to use your customer data to reach them on Google Search, YouTube, Gmail, and Display Network. Data is hashed before upload for privacy.
You can either upload to an existing list (provide user_list_id) or create a new list (provide list_name).
Args: customer_id: Customer ID (without hyphens) user_list_id: Existing user list ID to upload to (optional) list_name: Name for new list (required if user_list_id not provided) emails: List of email addresses phones: List of phone numbers (E.164 format recommended: +12345678900) first_names: List of first names (must match emails/phones index) last_names: List of last names (must match emails/phones index) countries: List of country codes (e.g., "US", "UK") zip_codes: List of postal codes
Returns: Success message with upload job details
Example: google_ads_upload_customer_match( customer_id="1234567890", list_name="Email Newsletter Subscribers", emails=[ "customer1@example.com", "customer2@example.com", "customer3@example.com" ] )
Privacy Note: All data is automatically hashed with SHA256 before upload. Google cannot see the original data.
Match Rate: Typically 30-70% of uploaded records will match to Google users.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_id | Yes | ||
| user_list_id | No | ||
| list_name | No | ||
| emails | No | ||
| phones | No | ||
| first_names | No | ||
| last_names | No | ||
| countries | No | ||
| zip_codes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |