Google Ads: Upload customer match members
ads_upload_customer_match_membersLädt Mitglieder in eine Customer-Match-Userliste hoch (Data Manager API).
Die Userliste legen Sie zuvor mit 'ads_create_customer_match_list' an oder finden sie mit 'ads_list_customer_match_lists'. E-Mail/Telefon/Adresse werden server-seitig normalisiert und mit SHA-256 gehasht — Klartext wird nicht gesendet. Für Customer Match nutzt Google in der Regel nur die E-Mail-Adresse; Telefon/Adresse erhöhen die Trefferquote. Voraussetzung: Google-Verbindung des Workspace mit Data-Manager-Berechtigung.
Versand in Batches à 2000 (Rückgabe requestId bzw. batches/request_ids, members = tatsächlich gesendete Anzahl, audience_id). Bei einem Teilfehler nennt die Antwort failed_batch_index und submitted_members — beim Wiederholen nur die noch nicht gesendeten Mitglieder übergeben. requestId bedeutet nur "angenommen": Matching und Listengröße (ads_list_customer_match_lists) aktualisieren sich zeitversetzt.
audience_id: User-List-ID (oder Resource-Name) aus 'ads_create_customer_match_list' / 'ads_list_customer_match_lists'. members: Liste von Dicts, je Mitglied 'email' und/oder 'phone' und/oder 'address'. phone NUR im E.164-Format (+43664...), andere Formate werden ohne Fehler verworfen. address nur mit allen vier Feldern given_name, family_name, region_code, postal_code (Aliase first_name/last_name/ country_code/zip), sonst still verworfen. Mitglieder ohne gültigen Identifier werden übersprungen — members in der Antwort mit der Eingabe vergleichen; error=no_identifiers nur, wenn keines brauchbar ist. consent: optionales {'adUserData','adPersonalization'} je 'CONSENT_GRANTED'/ 'CONSENT_DENIED'/'CONSENT_STATUS_UNSPECIFIED' — für EEA/UK dringend empfohlen. validate_only: True für einen Probelauf (Dry-Run) ohne Schreiben. accept_customer_match_terms: True akzeptiert die Customer-Match- Nutzungsbedingungen im Namen des Werbekontos für diesen Request (nur nach ausdrücklicher Bestätigung durch den Kontoinhaber setzen; nötig bei TERMS_AND_CONDITIONS_NOT_SIGNED, solange das Konto die Bedingungen nicht dauerhaft in der Google-Ads-Oberfläche akzeptiert hat). workspace: Slug des Kunden-Workspace (optional bei nur einem Workspace).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"audience_id": "<audience_id>",
"members": "<members>"
},
"name": "ads_upload_customer_match_members"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consent | No | ||
| members | Yes | ||
| workspace | No | ||
| audience_id | Yes | ||
| validate_only | No | ||
| accept_customer_match_terms | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||