Für die Data Manager API sind Anmeldedaten mit einem anderen Bereich als für die Google Ads API erforderlich. Folgen Sie der Anleitung unter API-Zugriff einrichten, um neue Anmeldedaten zu generieren, die den Bereich der Data Manager API enthalten.
Optionale Standardeinstellungen für die Einwilligung für Ereignisse in der Anfrage. Sie können diesen Wert für ein einzelnes Ereignis überschreiben, indem Sie das Feld consent von Event festlegen.
Kein Äquivalent
encoding
Erforderlich: Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird.
Kein Äquivalent
encryption_info
Wird festgelegt, wenn die Anfrage verschlüsselte Werte enthält. Weitere Informationen finden Sie unter Verschlüsselung.
job_id
Kein Äquivalent
Verwenden Sie die in der Antwort zurückgegebene request_id, um Diagnosedaten abzurufen.
partial_failure
Kein Äquivalent
Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn ein Feld eines IngestEventsRequest die Validierung nicht besteht, lehnt die Data Manager API die gesamte Anfrage ab.
validate_only
validate_only
conversions
events
Die Liste der Conversions oder Ereignisse. Weitere Informationen finden Sie im Abschnitt Conversion-Felder.
Felder für Kunden- und Conversion-Aktionen
Für die Google Ads API ist der Anfrageheader developer-token erforderlich. Die Anfrageheaderlogin-customer-id und linked-customer-id werden für verschiedene Authentifizierungsszenarien festgelegt.
Für die Data Manager API ist kein Entwicklertoken erforderlich. Sie geben die Anmelde- und verknüpften Kundendaten über Felder einer Destination anstelle von Anfrageheadern an. Weitere Informationen zu Zielen finden Sie unter Ziele konfigurieren.
So ordnen Sie die Google Ads API-Felder für eine einzelne conversion_action den entsprechenden Feldern in einer Destination zu:
Für die Data Manager API ist kein Entwicklertoken erforderlich.
login-customer-id-Anfrageheader
login_account
Legen Sie für account_id die Kundennummer des Log-in-Kontos fest. Legen Sie account_type auf GOOGLE_ADS fest, wenn das Anmeldekonto ein Google Ads-Konto ist, oder auf DATA_PARTNER, wenn es sich um ein Datenpartnerkonto handelt.
linked-customer-id-Anfrageheader
linked_account
Wenn Sie über einen Partnerlink auf die operating_account zugreifen, legen Sie für account_id die Kundennummer des verknüpften Kontos und für account_type den Wert DATA_PARTNER fest. Andernfalls legen Sie das Feld linked_account nicht fest.
conversion_action von ClickConversion
product_destination_id
Legen Sie die numerische ID der Conversion-Aktion fest. Verwenden Sie nicht den Ressourcennamen des ConversionAction.
Beide APIs verwenden ein ähnliches Consent-Objekt (ad_user_data, ad_personalization).
Bei der Data Manager API können Sie die Einwilligung auch für alle Ereignisse in einer Anfrage festlegen, indem Sie das Feld consent auf Anfrageebene festlegen.
Für die Google Ads API sind separate Anfragen pro Conversion-Aktion erforderlich. Die Data Manager API unterstützt das Senden von Conversions für mehrere Conversion-Aktionen in einer einzigen Anfrage. Außerdem können Sie mit dem Feld destination_references angeben, welche Ziele eine bestimmte benutzerdefinierte Variable erhalten sollen.
conversion_custom_variable
variable
Legen Sie den Namen der Variablen anstelle eines Ressourcennamens fest.
Keine der APIs unterstützt diese Kennungen für Offline-Conversions oder erweiterte Conversions für Leads. Die Data Manager API unterstützt diese Kennungen nicht, wenn Conversion-Ereignisse als zusätzliche Datenquelle gesendet werden.
Verwenden Sie die in der Antwort zurückgegebene request_id, um die Diagnose abzurufen.
partial_failure_error
Kein Äquivalent
Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn ein Feld eines IngestEventsRequest die Validierung nicht besteht, lehnt die Data Manager API die gesamte Anfrage ab.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2026-10-21 (UTC)."],[],[]]
