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
  • Anfrageheader developer-token
  • Anfrageheader login-customer_id
  • Anfrageheader linked-customer-id
  • conversion_action
destinations Weitere Informationen finden Sie unter Felder für Kunden und Conversion-Aktionen.
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 die Encoding fest, die für UserIdentifier-Werte verwendet wird.
Kein Äquivalent encryption_info Festlegen, wenn die Anfrage verschlüsselte Werte enthält. Weitere Informationen finden Sie unter Verschlüsselung.
job_id Kein Äquivalent Verwenden Sie die request_id in der Antwort zurückgegebene, um Diagnosen abzurufen.
partial_failure Kein Äquivalent Die Data Manager API unterstützt keine Teilausfälle. Wenn die Validierung eines Felds 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 Conversion-Felder.

Felder für Kunden und Conversion-Aktionen

Für die Google Ads API ist der developer-token Anfrageheader erforderlich. Die login-customer-id und linked-customer-id Anfrageheader werden für verschiedene Authentifizierungsszenarien festgelegt.

Für die Data Manager API ist kein Entwicklertoken erforderlich. Anmelde- und verknüpfte Kundendaten werden stattdessen über Felder eines Destination-Objekts angegeben. 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 einem Destination-Objekt zu:

Google Ads API Destination (Data Manager API) Hinweise
customer_id der Anfrage operating_account Legen Sie account_id auf die Kunden-ID des Google Ads-Conversion-Kontos fest. Legen Sie account_type des operating_account auf GOOGLE_ADS fest.
Anfrageheader developer-token Kein Äquivalent Für die Data Manager API ist kein Entwicklertoken erforderlich.
Anfrageheader login-customer-id login_account Legen Sie account_id auf die Kunden-ID des Anmeldekontos fest. Legen Sie account_type auf GOOGLE_ADS fest, wenn das Anmeldekonto ein Google Ads-Konto ist, oder auf DATA_PARTNER, wenn es ein Konto eines Datenpartners ist.
Anfrageheader linked-customer-id linked_account Wenn Sie über eine Partnerverknüpfung auf das 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 Legen Sie die numerische ID der Conversion-Aktion fest. Verwenden Sie nicht den Ressourcennamen der ConversionAction.
Kein Äquivalent reference Eine benutzerdefinierte Kennung für das Destination-Objekt. 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 Felder für Warenkorbdaten.
consent consent Beide APIs verwenden ein ähnliches Consent Objekt (ad_user_data, ad_personalization).
Für die 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.
conversion_action destination_references Wenn Sie Conversions für mehrere Conversion-Aktionen in einer einzigen Anfrage senden, legen Sie dieses Feld auf 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, der sich geringfügig vom Datums- und Zeitformat der Google Ads API unterscheidet.
  • Wenn Sie Protocol Buffers verwenden, verwenden Sie einen 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. Verwenden Sie beispielsweise für einen Conversion-Wert von 5,23 $ den Wert 5.23.
currency_code currency
custom_variables custom_variables Weitere Informationen finden Sie unter Felder für benutzerdefinierte Variablen.
customer_type
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 Nutzerkennungen.
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 Legen Sie das Feedlabel fest.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Artikel-Felder 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 einzigen Anfrage sowie die Verwendung des Felds destination_references, um anzugeben, welche Ziele eine bestimmte benutzerdefinierte Variable erhalten sollen.
conversion_custom_variable variable Legen Sie den Namen der Variablen anstelle eines Ressourcennamens fest.
value value

Felder für Nutzerkennungen

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API)
address_info address Beachten Sie die Formatierungs- und Hashing-Richtlinien. Sie können auch die gehashten Attribute einer Adresse verschlüsseln.
hashed_email email_address Legen Sie die formatierte und gehashte E-Mail-Adresse fest. Sie können auch die gehashte E-Mail-Adresse verschlüsseln.
hashed_phone_number phone_number Legen Sie die formatierte und gehashte Telefonnummer fest. Sie können auch die gehashte Telefonnummer verschlüsseln.
Andere Felder:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
Nicht relevant Keine der beiden 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 die request_id in der Antwort zurückgegebene, um Diagnosen abzurufen.
partial_failure_error Kein Äquivalent Die Data Manager API unterstützt keine Teilausfälle. Wenn die Validierung eines Felds 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 anhand der Diagnoseinformationen.