Skip to main content
Glama

Honeyfield Marketing MCP

Google Ads: Upload customer match members

ads_upload_customer_match_members

Lä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

NameRequiredDescriptionDefault
consentNo
membersYes
workspaceNo
audience_idYes
validate_onlyNo
accept_customer_match_termsNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Die Annotationen (readOnlyHint=false, destructiveHint=false, openWorldHint=true) decken nur das Sicherheitsprofil ab; die Beschreibung ergänzt serverseitige Normalisierung und SHA-256-Hashing, Batch-Größe 2000, Teilfehler-Semantik (failed_batch_index, submitted_members), die Bedeutung von requestId als bloße Annahme samt zeitversetzter Listenaktualisierung sowie stilles Verwerfen ungültiger Telefon-/Adressformate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Der Text ist lang, aber dicht und front-loaded: Zweck, Voraussetzung, Verhalten, dann Parameterspezifikation. Jeder Abschnitt trägt Information; minimaler Abzug, weil die Mischung aus Fließtext und Parameterliste ohne Gliederungssignale schwer zu scannen ist.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Für eine mutierende, gebündelte Upload-Operation mit Consent- und ToS-Bedingungen ist alles Nötige vorhanden: Voraussetzungen, Fehler-/Retry-Semantik, Parameterformate und Hinweis auf zeitversetzte Ergebnisaktualisierung. Das Output-Schema entlastet bei Rückgabefeldern, die Beschreibung erklärt dennoch die relevanten Antwortschlüssel.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Bei 0% Schema-Beschreibungsabdeckung trägt die Beschreibung die volle Last und erfüllt sie: audience_id-Herkunft, members-Struktur mit Pflichtfeldern, E.164-Format für phone, Adressfelder plus Aliase, consent-Werte-Enum, validate_only und accept_customer_match_terms mit Bedingungen. Das geht weit über das nackte Schema hinaus.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Der erste Satz nennt Verb, Ressource und Zielsystem ("Lädt Mitglieder in eine Customer-Match-Userliste hoch (Data Manager API)"). Die Abgrenzung zu den Geschwistertools ads_create_customer_match_list, ads_list_customer_match_lists und ads_remove_customer_match_members wird explizit hergestellt.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Die Beschreibung nennt Voraussetzungen (Google-Verbindung mit Data-Manager-Berechtigung, Liste zuvor anlegen oder finden), Alternativen (ads_list_customer_match_lists zur Größenprüfung) und bedingte Nutzung (validate_only für Dry-Run, accept_customer_match_terms nur bei TERMS_AND_CONDITIONS_NOT_SIGNED und ausdrücklicher Bestätigung).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources