Feldzuordnungen

Verwenden Sie die Zuordnungen in den Tabellen, um die Google Ads API-Methoden und -Felder ihrem IngestEventsRequest-Äquivalent in der Data Manager API zuzuordnen.

API-Methoden

Mit der Data Manager API können Sie jeden Batch von Ereignissen zu Ladenverkäufen in einem einzigen IngestEventsRequest hochladen.

Bei der Google Ads API war dagegen ein dreistufiger Prozess mit OfflineUserDataJobService erforderlich:

  1. Job mit CreateOfflineUserDataJob erstellen
  2. Fügen Sie dem Job mit AddOfflineUserDataJobOperations Vorgänge hinzu.
  3. Job mit RunOfflineUserDataJob ausführen

Anfragefelder

Für jede IngestEventsRequest gelten Anfragelimits. Wenn die Anzahl der Vorgänge in Ihrer AddOfflineUserDataJobOperations-Anfrage diese Grenzwerte überschreitet, müssen Sie sie in mehrere Data Manager API-Aufnahmeanfragen aufteilen.

So werden die Felder der Google Ads API-Anfragen der Data Manager API zugeordnet.

CreateOfflineUserDataJobRequest

In der folgenden Tabelle sehen Sie, wie die Felder eines CreateOfflineUserDataJobRequest einem IngestEventsRequest zugeordnet werden.

CreateOfflineUserDataJobRequest (Google Ads API) IngestEventsRequest (Data Manager API) Hinweise
customer_id destinations.operating_account Weitere Informationen finden Sie unter Kunden- und Conversion-Aktionsfelder.
  • developer-token-Anfrageheader
  • login-customer_id-Anfrageheader
  • linked-customer-id-Anfrageheader
 destinations Weitere Informationen finden Sie unter Kunden- und Conversion-Aktionsfelder.
  • job.status
  • job.failure_reason
 Diagnose Verwenden Sie die request_id, die in IngestEventsResponse zurückgegeben wird, um Diagnosedaten zu Ihrem Conversion-Upload abzurufen.
job.id request_id Verwenden Sie die request_id, die in IngestEventsResponse zurückgegeben wird, um Diagnosedaten zu Ihrem Conversion-Upload abzurufen.
job.external_id Kein Äquivalent
job.type Kein Äquivalent
job.store_sales_metadata.third_party_metadata.partner_id destinations.login_account Ein Datenpartner, der Conversions vom Typ „Ladenverkäufe“ hochlädt, wird durch die login_account eines Ziels identifiziert. Weitere Informationen finden Sie unter Ziele konfigurieren.
job.store_sales_metadata.third_party_metadata.advertiser_upload_date_time Kein Äquivalent
job.store_sales_metadata.third_party_metadata.valid_transaction_fraction Kein Äquivalent
job.store_sales_metadata.third_party_metadata.partner_match_fraction Kein Äquivalent
job.store_sales_metadata.third_party_metadata.partner_upload_fraction Kein Äquivalent
job.store_sales_metadata.third_party_metadata.bridge_map_version_id Kein Äquivalent
job.store_sales_metadata.loyalty_fraction Kein Äquivalent
job.store_sales_metadata.transaction_upload_fraction Kein Äquivalent
job.store_sales_metadata.custom_key
  • events[].custom_variables[].variable
  • events[].cart_data.items[].custom_variables[].variable
 Ordnen Sie das Feld variable einem CustomVariable auf Ereignisebene oder einem ItemCustomVariable auf Artikelebene zu.
enable_match_rate_range_preview Kein Äquivalent
validate_only validate_only
Kein Äquivalent consent In der Google Ads API kann consent nur auf Ereignisebene in UserData angegeben werden. Bei der Data Manager API können Sie die Einwilligung für alle Ereignisse in einer Anfrage angeben, indem Sie das Feld consent für IngestEventsRequest festlegen. Sie können diesen Wert für ein einzelnes Ereignis überschreiben, indem Sie das Feld consent von Event festlegen.
Kein Äquivalent encoding Erforderlich für UserData-Uploads. Auf die Encoding für UserIdentifier-Werte festgelegt.
Kein Äquivalent encryption_info Legen Sie fest, ob die Anfrage verschlüsselte UserData-Nutzer-IDs enthält. Weitere Informationen finden Sie unter Verschlüsselung.

AddOfflineUserDataJobOperationsRequest

In der folgenden Tabelle sehen Sie, wie die Felder eines AddOfflineUserDataJobOperationsRequest einem IngestEventsRequest zugeordnet werden.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestEventsRequest (Data Manager API) Hinweise
  • developer-token-Anfrageheader
  • login-customer_id-Anfrageheader
  • linked-customer-id-Anfrageheader
 destinations Weitere Informationen finden Sie unter Kunden- und Conversion-Aktionsfelder.
resource_name Kein Äquivalent Bei der Data Manager API ist es nicht erforderlich, eine Jobressource zu aktualisieren.
enable_partial_failure Kein Äquivalent Wenn IngestEventsRequest erfolgreich ist, werden alle Fehler, die bei der Downstream-Verarbeitung auftreten, auf Ereignisebene behandelt, was zu einem Teilerfolg führen kann. Mit Diagnose können Sie den Status Ihres Uploads sowie Fehler und Warnungen für einzelne Ereignisse abrufen. Wenn die IngestEventsRequest fehlschlägt (z. B. aufgrund eines BadRequest), werden keine Ereignisse verarbeitet. Sie müssen den Fehler beheben und die Anfrage noch einmal senden. Weitere Informationen finden Sie unter API-Fehler verstehen.
enable_warnings Kein Äquivalent Verwenden Sie Diagnose, um Warnungen zu Ihrer Data Manager API-Anfrage abzurufen. Sie müssen diese Funktion nicht aktivieren.
operations events Der Vorgang OfflineUserDataJobOperation.create entspricht dem Senden eines IngestEventsRequest. Das Entfernen von Ereignissen wird von der Data Manager API nicht unterstützt.
validate_only validate_only
Kein Äquivalent consent In der Google Ads API kann consent nur auf Ereignisebene in UserData angegeben werden. Bei der Data Manager API können Sie die Einwilligung für alle Ereignisse in einer Anfrage angeben, indem Sie das Feld consent für IngestEventsRequest festlegen. Sie können diesen Wert für ein einzelnes Ereignis überschreiben, indem Sie das Feld consent von Event festlegen.
Kein Äquivalent encoding Erforderlich für UserData-Uploads. Auf die Encoding für UserIdentifier-Werte festgelegt.
Kein Äquivalent encryption_info Legen Sie fest, ob die Anfrage verschlüsselte UserData-Nutzer-IDs enthält. Weitere Informationen finden Sie unter Verschlüsselung.

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 Kundendaten werden über Felder eines Destination anstelle von Anfrageheadern angegeben. Weitere Informationen zu Zielen finden Sie unter Ziele konfigurieren.

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 Datenpartnerkonto 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 product_destination_id Wird auf die numerische ID der Conversion-Aktion festgelegt. Verwenden Sie nicht den Ressourcennamen.

Ereignisfelder

In der folgenden Tabelle sehen Sie, wie die Felder einer Conversion-Map für Store-Verkäufe zwischen den beiden APIs zugeordnet werden.

Im Gegensatz zur Google Ads API, bei der mit ItemAttribute nur ein Artikel pro Transaktion angegeben werden kann, können mit der Data Manager API in CartData mehrere Artikel pro Ereignis angegeben werden.

OfflineUserDataJobOperation.create (Google Ads API) Event (Data Manager API) Hinweise
Kein Äquivalent event_source Erforderlich: Muss für Conversions in Form von Ladenverkäufen auf IN_STORE festgelegt werden.
transaction_attribute.conversion_action destinations.product_destination_id Weitere Informationen finden Sie unter Kunden- und Conversion-Aktionsfelder. Verwenden Sie die numerische ID der Conversion-Aktion anstelle des Ressourcennamens.
transaction_attribute.transaction_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.
transaction_attribute.transaction_amount_micros
  • conversion_value (Erforderlich)
  • cart_data.items[].conversion_value
 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.
transaction_attribute.currency_code currency Erforderlich.
transaction_attribute.order_id transaction_id Erforderlich.
transaction_attribute.store_attribute.store_code event_location.store_id Erforderlich: Legen Sie den Geschäftscode im Feld store_id des EventLocation-Objekts fest.
transaction_attribute.custom_value
  • custom_variables[].value
  • cart_data.items[].custom_variables[].value
 Ordnen Sie das Feld value einem CustomVariable auf Ereignisebene oder einem ItemCustomVariable auf Artikelebene zu.
transaction_attribute.item_attribute.item_id cart_data.items[].merchant_product_id
transaction_attribute.item_attribute.merchant_id
  • cart_data.merchant_id
  • cart_data.items[].merchant_id
 Wenn Sie cart_data.merchant_id festlegen, gilt dies als Standardwert für alle Artikel. Sie können ihn jedoch für einzelne Artikel überschreiben.
transaction_attribute.item_attribute.country_code
  • cart_data.merchant_feed_label
  • cart_data.items[].merchant_feed_label
 Wenn Sie cart_data.merchant_feed_label festlegen, gilt dies als Standardwert für alle Artikel. Sie können ihn jedoch für einzelne Artikel überschreiben.
transaction_attribute.item_attribute.language_code
  • cart_data.merchant_feed_language_code
  • cart_data.items[].merchant_feed_language_code
 Wenn Sie cart_data.merchant_feed_language_code festlegen, gilt dies als Standardwert für alle Artikel. Sie können ihn jedoch für einzelne Artikel überschreiben.
transaction_attribute.item_attribute.quantity cart_data.items[].quantity
Kein Äquivalent cart_data.items[].unit_price Der Wert muss auf den Stückpreis ohne Steuern, Versandkosten und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel festgelegt werden.
user_identifiers
  • user_data.user_identifiers
  • third_party_user_data.user_identifiers
 Erforderlich.

third_party_user_data hat dieselbe Struktur wie user_data, gibt aber an, dass die Nutzerkennungen aus einer Drittanbieterquelle stammen und nicht eigene Werbetreibendendaten sind.

Das Ausfüllen von third_party_user_data ist nur zulässig, wenn das Anmeldekonto ein Datenpartner ist (login_account.account_type ist DATA_PARTNER).

Weitere Informationen finden Sie unter Felder für Nutzer-IDs.

consent consent 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 für IngestEventsRequest festlegen.

Felder für Nutzerkennungen

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Hinweise
user_identifier_source

Die Quelle bestimmt, welches Feld in der Data Manager API Event ausgefüllt werden soll:

  • user_data
  • third_party_user_data

third_party_user_data hat dieselbe Struktur wie user_data, gibt aber an, dass die Nutzerkennungen aus einer Drittanbieterquelle stammen und nicht eigene Werbetreibendendaten sind.

Das Ausfüllen von third_party_user_data ist nur zulässig, wenn das Anmeldekonto ein Datenpartner ist (login_account.account_type ist DATA_PARTNER).

Weitere Informationen finden Sie unter Felder für Nutzer-IDs.

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.
address_info address Auf ein AddressInfo-Objekt festgelegt. Halten Sie sich an die Formatierungs- und Hashing-Richtlinien. Sie können auch die gehashten Attribute einer Adresse verschlüsseln.
address_info.hashed_first_name address.given_name
address_info.hashed_last_name address.family_name
address_info.country_code address.region_code
address_info.postal_code address.postal_code
address_info.city Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.
address_info.state Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.
address_info.hashed_street_address Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.
Zurück
Upgrade ausführen