> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senderz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Customer Match

> Sync a Senderz segment to a Google customer list via the Data Manager API — outbound only.

Connect Google Ads to keep a Customer Match list in sync with a Senderz segment. Like Meta, it's outbound only — Senderz pushes membership continuously and reads nothing back.

## How it works

<Steps>
  <Step title="Connect Google (OAuth)">
    Authorise Senderz through a dedicated OAuth flow. Manager (MCC) accounts
    are supported, not just direct-admin.
  </Step>

  <Step title="Link a segment">
    Map a Senderz segment to a Google customer list (1:1).
  </Step>

  <Step title="Hourly sync">
    Senderz diffs the segment against the last snapshot and applies joins and
    removes.
  </Step>
</Steps>

## The Data Manager API

<Warning>
  Membership ingestion goes through the **Data Manager API**
  (`datamanager.googleapis.com`), **not** the legacy Google Ads API upload
  path. Since April 2026, the Ads upload path rejects developer tokens that
  weren't already sending Customer Match traffic — so it's permanently closed
  to new integrations. The Ads API is still used for the list entity and
  account metadata.
</Warning>

## Identity & hashing

Members are matched on hashed **email and phone only** (Google's address
matching needs given name, family name, region and postal code as a unit,
which Senderz contacts don't carry). Normalisation is Google-specific:

* Gmail / googlemail addresses have dots and `+suffix` stripped; other domains keep them.
* Phones are E.164 **with** the `+`.
* Un-normalisable input is skipped, not hashed as-is.

## Limits worth knowing

| Limit                      | Value                                             |
| -------------------------- | ------------------------------------------------- |
| Members per ingest request | 10,000                                            |
| Serving minimum            | 100 members (below this the audience won't serve) |
| Membership lifespan        | up to 540 days                                    |
| Processing time            | up to 48 hours                                    |

<Note>
  Match rate is available after processing. Manager (MCC) account support is a
  differentiator — many tools are direct-admin only. This connector is in
  progress; OAuth and the API clients are being built on top of the shared
  ad-sync foundation.
</Note>