Feldzuordnungen

Verwenden Sie die Zuordnungen in den Tabellen, um ein UploadClickConversionRequest in der Google Ads API dem entsprechenden IngestEventsRequest in der Data Manager API zuzuordnen.

Anfragefelder

UploadClickConversionRequest (Google Ads API) IngestEventsRequest (Data Manager API) Hinweise
  • customer_id
  • developer-token-Anfrageheader
  • login-customer_id-Anfrageheader
  • linked-customer-id-Anfrageheader
  • conversion_action
destinations Weitere Informationen finden Sie unter Kunden- und Conversion-Aktionsfelder.
Kein Äquivalent consent 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 den in der Antwort zurückgegebenen request_id, um Diagnosedaten abzurufen.
partial_failure Kein Äquivalent Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn die Validierung eines Felds in einer IngestEventsRequest fehlschlägt, 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 zu Conversion-Feldern.

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 nicht über Anfrageheader, sondern über Felder eines Destination 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:

Google Ads API Destination (Data Manager API) Hinweise
customer_id der Anfrage operating_account 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.
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 Wenn Sie über einen Partnerlink auf operating_account zugreifen, legen Sie account_id auf die Kunden-ID des verknüpften Kontos und account_type auf DATA_PARTNER fest. Andernfalls legen Sie das Feld linked_account nicht fest.
conversion_action einer ClickConversion product_destination_id Auf die numerische ID der Conversion-Aktion festgelegt. Verwenden Sie nicht den Ressourcennamen von ConversionAction.
Kein Äquivalent reference Eine benutzerdefinierte Kennung für die Destination. Legen Sie dieses Feld fest, wenn Sie Conversions für mehrere Conversion-Aktionen in einer einzigen Anfrage senden.

Conversion-Felder

ClickConversion (Google Ads API) Event (Data Manager API) Hinweise
cart_data cart_data Weitere Informationen finden Sie unter Warenkorbdatenfelder.
consent consent Für beide APIs wird ein ähnliches Consent-Objekt (ad_user_data, ad_personalization) verwendet.
Bei der Data Manager API können Sie die Einwilligung für alle Ereignisse in einer Anfrage auch auf Anfrageebene mit dem Feld consent festlegen.
conversion_action destination_references Wenn Sie Conversions für mehrere Conversion-Aktionen in einer einzelnen Anfrage senden, legen Sie für dieses Feld die entsprechende reference des Ziels fest.
conversion_date_time event_timestamp
  • Wenn Sie das JSON-Format verwenden, legen Sie einen Wert im RFC 3339-Format fest, das sich geringfügig vom Datums- und Zeitformat der Google Ads API unterscheidet.
  • Wenn Sie Protocol Buffers verwenden, nutzen Sie ein Timestamp und legen Sie die Felder seconds und (optional) nanoseconds fest.

Weitere Informationen finden Sie unter Zeitstempelformat.
conversion_environment Kein Äquivalent
conversion_value conversion_value Legen Sie den Währungswert fest, nicht den Wert in Mikros. Bei einem Conversion-Wert von 5,23 € verwenden Sie beispielsweise den Wert 5.23.
currency_code currency
custom_variables custom_variables Weitere Informationen finden Sie unter Benutzerdefinierte Variablenfelder.
customer_type user_properties.customer_type Legen Sie einen Wert in der Aufzählung CustomerType fest.
Kein Äquivalent event_source
Kein Äquivalent event_device_info
external_attribution_data Kein Äquivalent
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
Kein Äquivalent last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes Weitere Informationen finden Sie unter Sitzungsattribute hinzufügen.
session_attributes_key_value_pairs experimental_fields Weitere Informationen finden Sie unter Sitzungsattribute hinzufügen.
user_identifiers user_data.user_identifiers Weitere Informationen finden Sie unter Felder für Nutzer-IDs.
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

Felder für Warenkorbdaten

CartData (Google Ads API) CartData (Data Manager API) Hinweise
feed_country_code merchant_feed_label Auf das Feedlabel festgelegt.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Artikelfelder für Warenkorbdaten

Item (Google Ads API) Item (Data Manager API) Hinweise
product_id merchant_product_id
quantity quantity
unit_price unit_price
Kein Äquivalent item_id
Kein Äquivalent additional_item_parameters

Felder für benutzerdefinierte Variablen

CustomVariable (Google Ads API) CustomVariable (Data Manager API) Hinweise
Kein Äquivalent destination_references 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 einzelnen Anfrage. Außerdem kann mit dem Feld destination_references angegeben werden, welche Ziele eine bestimmte benutzerdefinierte Variable erhalten sollen.
conversion_custom_variable variable Wird auf den Namen der Variablen anstelle eines Ressourcennamens festgelegt.
value value

Felder für Nutzerkennungen

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API)
address_info address Halten Sie sich an die Formatierungs- und Hashing-Richtlinien. Sie können auch die gehashten Attribute einer Adresse verschlüsseln.
hashed_email email_address Auf die formatierte und gehashte E-Mail-Adresse festgelegt. Sie können die gehashte E‑Mail-Adresse auch verschlüsseln.
hashed_phone_number phone_number Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können die gehashte Telefonnummer auch verschlüsseln.
Andere Felder:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
Nicht relevant 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 auch nicht, wenn Conversion-Ereignisse als zusätzliche Datenquelle gesendet werden.

Antwortfelder

UploadClickConversionResponse (Google Ads API) IngestEventsResponse (Data Manager API) Hinweise
job_id Kein Äquivalent Verwenden Sie den in der Antwort zurückgegebenen request_id, um Diagnosedaten abzurufen.
partial_failure_error Kein Äquivalent Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn die Validierung eines Felds in einer IngestEventsRequest fehlschlägt, lehnt die Data Manager API die gesamte Anfrage ab.
request-id Antwortheader request_id Die Anfrage-ID wird in der Data Manager API als Antwortfeld und nicht als Antwortheader zurückgegeben.
results Kein Äquivalent Die Data Manager API verarbeitet Ereignisse asynchron. Prüfen Sie die Verarbeitungsergebnisse mit der Diagnose.