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 Wert auf die Encoding fest, die für UserIdentifier-Werte verwendet wird.
Kein Äquivalent
encryption_info
Gibt an, ob 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 Diagnoseinformationen abzurufen.
partial_failure
Kein Äquivalent
Die Data Manager API unterstützt keine Teilausfälle. Wenn die Validierung eines Felds in einer IngestEventsRequest fehlschlägt, wird die gesamte Anfrage von der Data Manager API abgelehnt.
validate_only
validate_only
conversions
events
Die Liste der Conversions oder Ereignisse. Weitere Informationen finden Sie im Abschnitt Conversion-Felder.
Kunden- und Conversion-Aktionsfelder
Für die Google Ads API ist der developer-token-Anfrageheader erforderlich. Sie legen die login-customer-id- und linked-customer-id-Anfrageheader für verschiedene Authentifizierungsszenarien fest.
Für die Data Manager API ist kein Entwicklertoken erforderlich. Anmelde- und verknüpfte Kundeninformationen werden über Felder eines Destination anstelle von Anfrageheadern angegeben. Weitere Informationen zu Zielen finden Sie unter Ziele konfigurieren.
So ordnen Sie die Google Ads API-Felder für ein einzelnes conversion_action den entsprechenden Feldern in einem Destination zu:
Legen Sie account_id auf die Kundennummer des Google Ads-Conversion-Kontos fest. Legen Sie den account_type des operating_account auf GOOGLE_ADS fest.
Für die Data Manager API ist möglicherweise eine andere Kunden-ID erforderlich als für die Google Ads API. Weitere Informationen finden Sie unter Unterschiede bei den Anforderungen an Zielkonten.
developer-token-Anfrageheader
Kein Äquivalent
Für die Data Manager API ist kein Entwickler-Token erforderlich.
login-customer-id-Anfrageheader
login_account
Setzen Sie account_id auf die Kundennummer des Anmeldekontos. Legen Sie account_type auf GOOGLE_ADS fest, wenn es sich beim Anmeldekonto um ein Google Ads-Konto handelt, oder auf DATA_PARTNER, wenn es sich beim Anmeldekonto um ein Konto eines Datenpartners handelt.
linked-customer-id-Anfrageheader
linked_account
Legen Sie account_id auf die Kundennummer des verknüpften Kontos fest. Setzen Sie account_type auf DATA_PARTNER.
conversion_action einer ClickConversion
product_destination_id
Wird auf die numerische ID der Conversion-Aktion festgelegt. Verwenden Sie nicht den Ressourcennamen von ConversionAction.
Beide APIs verwenden ein ähnliches Consent-Objekt (ad_user_data, ad_personalization).
Bei der Data Manager API können Sie die Einwilligung für alle Ereignisse in einer Anfrage auch festlegen, indem Sie das Feld consent auf Anfrageebene festlegen.
Legen Sie den Wert auf den Währungswert und nicht auf den Wert in Mikros fest. Bei einem Conversion-Wert von 5,23 $verwenden Sie beispielsweise den Wert 5.23.
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 sowie die Verwendung des Felds destination_references, um anzugeben, welche Ziele eine bestimmte benutzerdefinierte Variable erhalten sollen.
conversion_custom_variable
variable
Wird auf den Namen der Variablen anstelle eines Ressourcennamens festgelegt.
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 Diagnoseinformationen abzurufen.
partial_failure_error
Kein Äquivalent
Die Data Manager API unterstützt keine Teilausfälle. Wenn die Validierung eines Felds in einer IngestEventsRequest fehlschlägt, wird die gesamte Anfrage von der Data Manager API abgelehnt.