Google Customer Match - Google Ads Audiences

Create and manage Google Ads Customer Match audiences. Upload customer lists with auto-hashing, create similar audiences, manage offline conversions. Direct integration with Google Ads API.

Features

Customer List Management

• create_customer_list - Create a new customer match list
• get_customer_list - Get details of a specific list
• list_customer_lists - List all customer match lists
• update_customer_list - Update list name/description
• delete_customer_list - Delete a customer list

User Management

• add_users - Add users to a list (auto-hashes PII)
• remove_users - Remove users from a list

Advanced Features

• create_similar_audience - Create similar audience from source list
• get_audience_insights - Get audience size and status
• upload_offline_conversions - Upload offline conversion data

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
See input schema

Output Format

Customer List

{
  "resourceName": "customers/123/userLists/456",
  "id": "456",
  "name": "High Value Customers",
  "description": "Customers with LTV > $500",
  "membershipStatus": "OPEN",
  "sizeForSearch": 15000,
  "sizeForDisplay": 14500,
  "eligibleForSearch": true,
  "eligibleForDisplay": true
}

Upload Response

{
  "uploadedUserIdentifierCount": 1000,
  "matchedUserCount": 850,
  "failedUserIdentifierCount": 5
}

Pricing

This actor uses pay-per-event billing: $0.01 per query (all tasks)

Use Cases

Build Remarketing List

1. Export customer emails from CRM
2. Use add_users to upload to Google Ads
3. Create campaigns targeting the list

Create Similar Audience

1. Build list of best customers
2. Use create_similar_audience
3. Reach new users similar to your customers

Track Offline Conversions

1. Collect gclid from ad clicks
2. Record offline purchases/signups
3. Use upload_offline_conversions to attribute

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal