Verwenden Sie die Zuordnungen in den Tabellen, um die Methoden und Felder der Google Ads API den entsprechenden IngestEventsRequest-Elementen in der Data Manager API zuzuordnen.
Authentifizierung
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.
API-Methoden
Mit der Data Manager API können Sie jeden Batch von Ladenverkaufsereignissen in einem einzigen IngestEventsRequest hochladen.
In der Google Ads API waren dagegen drei Schritte mit dem OfflineUserDataJobService erforderlich:
- Job mit
CreateOfflineUserDataJoberstellen - Fügen Sie dem Job mit
AddOfflineUserDataJobOperationsVorgänge hinzu. - Job mit
RunOfflineUserDataJobausführen
Anfragefelder
Für jede IngestEventsRequest gelten Anfragelimits. Wenn die Anzahl der Vorgänge in Ihrer AddOfflineUserDataJobOperations-Anfrage diese Limits überschreitet, müssen Sie sie in mehrere Data Manager API-Aufnahme-Anfragen aufteilen.
Hier sehen Sie, wie die Felder der Google Ads API-Anfragen der Data Manager API zugeordnet werden.
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 Felder für Kunden- und Conversion-Aktionen. |
|
destinations |
Weitere Informationen finden Sie unter Felder für Kunden- und Conversion-Aktionen. |
|
Diagnose | Verwenden Sie die request_id, die in der IngestEventsResponse zurückgegeben wird, um Diagnosedaten zu Ihrem Conversion-Upload abzurufen. |
job.id |
request_id |
Verwenden Sie die request_id, die in der 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 in Form von Ladenverkäufen 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 |
|
Ordnen Sie das Feld variable eines CustomVariable auf Ereignisebene oder eines 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. In der Data Manager API können Sie die Einwilligung für alle Ereignisse in einer Anfrage angeben, indem Sie das Feld consent im 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. Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryption_info |
Wird festgelegt, wenn 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 |
|---|---|---|
|
destinations |
Weitere Informationen finden Sie unter Felder für Kunden- und Conversion-Aktionen. |
resource_name |
Kein Äquivalent | Bei der Data Manager API ist keine Aktualisierung einer Jobressource erforderlich. |
enable_partial_failure |
Kein Äquivalent | Wenn die IngestEventsRequest erfolgreich ist, werden alle Fehler, die während der nachgelagerten Verarbeitung auftreten, auf Ereignisebene behandelt. Dies kann zu einem Teilerfolg führen. Mit der 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 | Mit der Diagnose können Sie Warnungen zu Ihrer Data Manager API-Anfrage abrufen. Sie müssen diese Option nicht aktivieren. |
operations |
events |
Der Vorgang OfflineUserDataJobOperation.create entspricht dem Senden einer 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. In 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. Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryption_info |
Wird festgelegt, wenn die Anfrage verschlüsselte UserData-Nutzer-IDs enthält. Weitere Informationen finden Sie unter Verschlüsselung. |
Felder für Kunden- und Conversion-Aktionen
Für die Google Ads API ist der Anfrageheader developer-token erforderlich. Die Anfrageheader login-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.
| Google Ads API | Destination (Data Manager API) |
Hinweise |
|---|---|---|
customer_id der Anfrage |
operating_account |
Legen Sie die account_id auf die Kundennummer des Google Ads-Conversion-Kontos fest. Legen Sie für account_type von operating_account den Wert GOOGLE_ADS fest. |
developer-token-Anfrageheader |
Kein Äquivalent | 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 |
product_destination_id |
Legen Sie die numerische ID der Conversion-Aktion fest. Verwenden Sie nicht den Ressourcennamen. |
Ereignisfelder
In der folgenden Tabelle sehen Sie, wie die Felder einer Conversion in Form eines Ladenverkaufs zwischen den beiden APIs zugeordnet werden.
Im Gegensatz zur Google Ads API, die nur einen einzelnen Artikel pro Transaktion mit ItemAttribute unterstützt, können Sie mit der Data Manager API mehrere Artikel pro Ereignis in CartData angeben.
OfflineUserDataJobOperation.create (Google Ads API) |
Event (Data Manager API) |
Hinweise |
|---|---|---|
| Kein Äquivalent | event_source |
Erforderlich: Für Conversions in Form von Ladenverkäufen auf IN_STORE festlegen. |
transaction_attribute.conversion_action |
destinations.product_destination_id |
Weitere Informationen finden Sie unter Felder für Kunden- und Conversion-Aktionen. Verwenden Sie die numerische ID der Conversion-Aktion anstelle des Ressourcennamens. |
transaction_attribute.transaction_date_time |
event_timestamp |
Weitere Informationen finden Sie unter Zeitstempelformat. |
transaction_attribute.transaction_amount_micros |
|
Legen Sie den Währungswert fest, nicht den Wert in Mikros. Für einen 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 im Objekt EventLocation fest. |
transaction_attribute.custom_value |
|
Ordnen Sie das Feld value eines CustomVariable auf Ereignisebene oder eines ItemCustomVariable auf Artikelebene zu. |
transaction_attribute.item_attribute.item_id |
cart_data.items[].merchant_product_id |
|
transaction_attribute.item_attribute.merchant_id |
|
Wenn Sie cart_data.merchant_id festlegen, gilt dies als Standard für alle Artikel. Sie können die Einstellung jedoch für einzelne Artikel überschreiben. |
transaction_attribute.item_attribute.country_code |
|
Wenn Sie cart_data.merchant_feed_label festlegen, gilt dies als Standard für alle Artikel. Sie können die Einstellung jedoch für einzelne Artikel überschreiben. |
transaction_attribute.item_attribute.language_code |
|
Wenn Sie cart_data.merchant_feed_language_code festlegen, gilt dies als Standard für alle Artikel. Sie können die Einstellung jedoch für einzelne Artikel überschreiben. |
transaction_attribute.item_attribute.quantity |
cart_data.items[].quantity |
|
| Kein Äquivalent | cart_data.items[].unit_price |
Legen Sie den Artikelpreis ohne Steuern, Versand und ereignisbezogene Rabatte (auf Transaktionsebene) für diesen Artikel fest. |
user_identifiers |
|
Erforderlich.
|
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 Nutzer-IDs
UserIdentifier (Google Ads API) |
UserIdentifier (Data Manager API) |
Hinweise |
|---|---|---|
user_identifier_source |
Die Quelle bestimmt, welches Feld in der Data Manager API
|
|
hashed_email |
email_address |
Legen Sie die formatierte und gehashte E-Mail-Adresse fest. Sie können die gehashte E-Mail-Adresse auch verschlüsseln. |
hashed_phone_number |
phone_number |
Legen Sie die formatierte und gehashte Telefonnummer fest. Sie können die gehashte Telefonnummer auch verschlüsseln. |
address_info |
address |
Wird auf ein AddressInfo-Objekt festgelegt. Folgen Sie den Formatierungs- und Hash-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 für Google Ads-Anzeigenziele nicht unterstützt. |
address_info.state |
Kein Äquivalent | Wird für Google Ads-Anzeigenziele nicht unterstützt. |
address_info.hashed_street_address |
Kein Äquivalent | Wird für Google Ads-Ziele nicht unterstützt. |