Feldzuordnungen

Verwenden Sie die Feldzuordnungen, um jeden Schritt Ihres Workflows zum Kundenabgleich von der Google Ads API auf die Data Manager API umzustellen:

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 Data Manager API-Bereich enthalten.

Feldzuordnungen für die Zielgruppenverwaltung

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

UserList (Google Ads API) UserList (Data Manager API) Hinweise
resource_name name Weitere Informationen finden Sie unter Ressourcennamen.
id id
read_only read_only
name display_name Erforderlich
description description Erforderlich
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Die Dauer, die ein Zielgruppenmitglied nach dem Hinzufügen in der Liste verbleibt. Der Wert muss ganzen Tagen entsprechen. Wenn nichts anderes festgelegt ist, wird standardmäßig der maximale Wert verwendet.

Formatieren Sie den Wert mit dem Zeitstempelformat.
size_for_display size_info.display_network_members_count
size_range_for_display Kein Äquivalent. Verwenden Sie size_info.display_network_members_count für Größenangaben.
size_for_search size_info.search_network_members_count
size_range_for_search Kein Äquivalent. Verwenden Sie size_info.search_network_members_count für Größenangaben.
type Kein Äquivalent.
access_reason access_reason
account_user_list_status account_access_status
closing_reason closing_reason
eligible_for_search target_network_info.eligible_for_search
eligible_for_display target_network_info.eligible_for_display
match_rate_percentage ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list ingested_user_list_info.pseudonymous_id_info Wird nicht für den Kundenabgleich verwendet.
crm_based_user_list ingested_user_list_info Erforderlich. Weitere Informationen zu Zielgruppen zum Kundenabgleich
Kein Äquivalent. ingested_user_list_info.pair_id_info Wird nicht für den Kundenabgleich verwendet.
Kein Äquivalent. ingested_user_list_info.partner_audience_info Wird nicht für den Kundenabgleich verwendet.
logical_user_list Kein Äquivalent. Wird nicht für den Kundenabgleich verwendet.
logical_user_list Kein Äquivalent. Wird nicht für den Kundenabgleich verwendet.
lookalike_user_list Kein Äquivalent. Wird nicht für den Kundenabgleich verwendet.
rule_based_user_list Kein Äquivalent. Wird nicht für den Kundenabgleich verwendet.
similar_user_list Kein Äquivalent. Wird nicht für den Kundenabgleich verwendet.

Informationen zu Zielgruppen zum Kundenabgleich

In der Google Ads API müssen Sie das Feld crm_based_user_list auf CrmBasedUserListInfo festlegen, wenn Sie eine Zielgruppe zum Kundenabgleich erstellen.

Legen Sie in der Data Manager API die entsprechenden Attribute fest, indem Sie das Feld ingested_user_list_info auf IngestedUserListInfo setzen. Legen Sie dann die erforderlichen Felder für den Kundenabgleich und den Typ der Nutzerdaten fest.

Kontaktdaten

upload_key_types
Auf eine Liste mit CONTACT_ID festgelegt. Das entspricht der Einstellung von upload_key_type auf CONTACT_INFO in der Google Ads API.
contact_id_info

Legen Sie einen ContactIdInfo fest.

Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY. Das entspricht der Einstellung von data_source_type auf FIRST_PARTY in der Google Ads API.

Mobilgeräte-IDs

upload_key_types
Auf eine Liste mit MOBILE_ID festgelegt. Das entspricht der Einstellung von upload_key_type auf MOBILE_ADVERTISING_ID in der Google Ads API.
mobile_id_info

Legen Sie einen MobileIdInfo fest.

  • Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY. Das entspricht der Einstellung von data_source_type auf FIRST_PARTY in der Google Ads API.
  • Legen Sie key_space auf IOS oder ANDROID fest. Die Data Manager API erfordert diesen Wert. Das unterscheidet sich von der Google Ads API, bei der der Schlüsselbereich aus dem app_id abgeleitet wird.
  • Legen Sie app_id auf den String fest, der die mobile Anwendung, aus der die Daten erhoben wurden, eindeutig identifiziert. Verwenden Sie dasselbe Format wie für app_id in der Google Ads API.

Nutzer-IDs

upload_key_types
Auf eine Liste mit USER_ID festgelegt. Das entspricht der Einstellung von upload_key_type auf CRM_ID in der Google Ads API.
user_id_info

Legen Sie einen UserIdInfo fest.

Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY. Das entspricht der Einstellung von data_source_type auf FIRST_PARTY in der Google Ads API.

Ressourcennamen

Die Data Manager API verwendet ein anderes Format für Ressourcennamen als die Google Ads API.

Google Ads API

In der Google Ads API hat ein UserList-Ressourcenname das folgende Format:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

In der Data Manager API hat ein UserList-Ressourcenname das folgende Format:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

Feldzuordnungen hochladen

Verwenden Sie die Zuordnungen in den Tabellen, um eine AddOfflineUserDataJobOperationsRequest in der Google Ads API der entsprechenden IngestionService-Anfrage in der Data Manager API zuzuordnen.

Anfragefelder

Für diese Zuordnungen wird die IngestAudienceMembersRequest in der Data Manager API als Referenz verwendet. Sie können sie aber auch verwenden, wenn Sie Ihre Google Ads API-Anfrage in eine RemoveAudienceMembersRequest oder eine RemoveAllAudienceMembersRequest umwandeln.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (Data Manager API) Hinweise
  • Feld customer_id
  • Feld customer_match_user_list_metadata von OfflineUserDataJob
  • developer-token-Anfrageheader
  • login-customer_id-Anfrageheader
  • linked-customer-id-Anfrageheader
 destinations Weitere Informationen zu Kunden- und Zielfeldern
consent aus dem customer_match_user_list_metadata von OfflineUserDataJob consent Optionale Standardeinstellungen für die Einwilligung für Zielgruppenmitglieder in der Anfrage. Sie können diesen Wert für ein einzelnes Zielgruppenmitglied überschreiben, indem Sie das Feld consent von AudienceMember festlegen.
Kein Äquivalent encoding Erforderlich:Legen Sie den Encoding fest, der 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 request_id, der in der Antwort zurückgegeben wurde, um Diagnosedaten abzurufen.
enable_partial_failure Kein Äquivalent Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn die Validierung eines Felds von IngestAudienceMembersRequest fehlschlägt, lehnt die Data Manager API die gesamte Anfrage ab. Verarbeitungsfehler mit Diagnose abrufen.
enable_warnings Kein Äquivalent Die Data Manager API meldet keine Warnungen in der Antwort. Verarbeitungswarnungen mit diagnostics abrufen.
validate_only validate_only
operations audience_members Die Liste der Zielgruppenmitglieder, die hinzugefügt oder entfernt werden sollen. Weitere Informationen finden Sie im Abschnitt Vorgangsfelder.
Kein Äquivalent terms_of_service Erforderlich. Gibt an, ob der Nutzer die Nutzungsbedingungen für den Kundenabgleich akzeptiert oder abgelehnt hat.

Kunden- und Zielgruppenfelder

Mit der Google Ads API können Zielgruppenmitglieder nur in eine Zielgruppe pro Job hochgeladen werden.Außerdem ist der developer-token-Anfrageheader erforderlich und Sie legen die login-customer-id- und linked-customer-id-Anfrageheader für verschiedene Authentifizierungsszenarien fest.

Die Data Manager API unterstützt das Senden von Zielgruppenmitgliedern für mehrere Zielgruppen in einer einzigen Anfrage. 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.

In der Google Ads API können Sie alle Mitglieder einer Zielgruppe entfernen, indem Sie das Feld remove_all eines OfflineUserDataJobOperation auf true festlegen.

In der Data Manager API senden Sie dazu eine RemoveAllAudienceMembersRequest. Weitere Informationen

So ordnen Sie die Google Ads API-Felder für ein einzelnes Zielvorhaben 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 Kunden-ID der Zielgruppe 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 Entwicklertoken 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 das Anmeldekonto ein Google Ads-Konto ist, oder auf DATA_PARTNER, wenn es ein Konto eines Datenpartners ist.
linked-customer-id-Anfrageheader linked_account Wenn Sie über einen Partnerlink auf operating_account zugreifen, legen Sie account_id auf die Kundennummer des verknüpften Kontos und account_type auf DATA_PARTNER fest. Andernfalls legen Sie das Feld linked_account nicht fest.
user_list aus dem customer_match_user_list_metadata von OfflineUserDataJob product_destination_id Erforderlich. Wird auf die numerische ID der Zielgruppe festgelegt. Verwenden Sie nicht den Ressourcennamen von UserList.
Kein Äquivalent reference Eine benutzerdefinierte Kennung für die Destination. Legen Sie dieses Feld fest, wenn Sie Zielgruppenmitglieder für mehrere Zielgruppen in einer einzigen Anfrage senden.

Vorgangsfelder

Die Data Manager API enthält separate Methoden zum Hinzufügen und Entfernen von Zielgruppenmitgliedern. Im Gegensatz dazu enthält AddOfflineUserDataJobOperationsRequest in der Google Ads API eine Liste von operations, mit denen je nach Art des Vorgangs entweder ein Mitglied hinzugefügt, ein Mitglied entfernt oder alle Mitglieder entfernt werden. Hier sehen Sie die Zuordnung der einzelnen Vorgangstypen zur entsprechenden Methode in der Data Manager API:

OfflineUserDataJobOperation (Google Ads API) IngestionService-Methode (Data Manager API) Hinweise
create IngestAudienceMembers Weitere Informationen finden Sie im Abschnitt zu Feldern für Zielgruppenmitglieder.
remove RemoveAudienceMembers Weitere Informationen finden Sie im Abschnitt zu Feldern für Zielgruppenmitglieder.
remove_all RemoveAllAudienceMembers Weitere Informationen finden Sie unter Alle Zielgruppenmitglieder entfernen.

Felder für Personen in der Zielgruppe

UserData (Google Ads API) AudienceMember (Data Manager API) Hinweise
consent consent

Gibt die Einwilligung für das Zielgruppenmitglied an.

Beide APIs verwenden ein ähnliches Consent-Objekt („ad_user_data“, „ad_personalization“).

Bei der Data Manager API können Sie auch die Einwilligung für alle Zielgruppenmitglieder in einer Anfrage festlegen, indem Sie das Feld consent auf Anfrageebene festlegen.
transaction_attribute Kein Äquivalent. Trifft nicht auf den Kundenabgleich zu.
user_attribute Kein Äquivalent. Trifft nicht auf den Kundenabgleich zu.
user_identifiers
  • mobile_data
  • user_id_data
  • composite_data
    • user_data
    • ip_data

Füllen Sie das Feld aus, das dem Datentyp entspricht, den Sie für Zielgruppenmitglieder senden. Weitere Informationen finden Sie unter Felder für Nutzerkennungen.

Felder für Nutzerkennungen

In der Google Ads API verwenden Sie UserIdentifier, um Kontaktinformationen, Mobilgeräte-IDs oder Nutzer-IDs zu senden. Bei der Data Manager API wird ein anderer Ansatz verwendet, bei dem für jeden Datentyp unterschiedliche Felder vorhanden sind.

Füllen Sie in der Data Manager API das Feld aus, das dem Typ der Daten entspricht, die Sie senden:

Kontaktdaten

Wenn Sie Kontaktdaten wie E‑Mail-Adresse, Telefonnummer oder Adressinformationen verwenden, legen Sie composite_data auf ein CompositeData mit einem separaten Eintrag in user_data.user_identifiers für jedes Kontaktdatenelement fest.

user_data wird zwar weiterhin unterstützt, wir empfehlen jedoch die Verwendung von composite_data, damit Ihre Integration für zukünftige Verbesserungen gerüstet ist. Weitere Informationen finden Sie unter Zusammengesetzte Daten.

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Hinweise
address_info address Weitere Informationen finden Sie unter Adressfelder.
hashed_email email_address Auf die formatierte und gehashte E‑Mail-Adresse festgelegt. Sie können auch die gehashte E‑Mail-Adresse verschlüsseln.
hashed_phone_number phone_number Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können die gehashte Telefonnummer auch verschlüsseln.
user_identifier_source Kein Äquivalent.

Adressfelder

Hier finden Sie die Feldzuordnungen zwischen OfflineUserAddressInfo in der Google Ads API und AddressInfo in der Data Manager API. Verwenden Sie diese Zuordnungen, wenn Sie Kontaktdaten verwenden, um Ihre Zielgruppe zum Kundenabgleich zu erstellen.

OfflineUserAddressInfo (Google Ads API) AddressInfo (Data Manager API) Hinweise
city Kein Äquivalent.
country_code region_code Erforderlich
hashed_first_name given_name

Erforderlich. Auf den formatierten und gehashten Vornamen festgelegt. Sie können auch den gehashten Vornamen verschlüsseln.
hashed_last_name family_name

Erforderlich. Auf den formatierten und gehashten Familiennamen festgelegt. Sie können auch den gehashten Familiennamen verschlüsseln.
hashed_street_address Kein Äquivalent.
postal_code postal_code Erforderlich
state Kein Äquivalent.

IP-Adresse

Die Data Manager API unterstützt das Einbeziehen von IP-Adressen für Uploads zum Kundenabgleich zusätzlich zu Nutzer-IDs. Diese sind in CompositeData verfügbar, das UserData und IpData umfasst. Wenn Sie diese Felder zusammen angeben, können Sie die Abgleichsraten verbessern.

Weitere Informationen finden Sie unter IP-Aufnahme für den Kundenabgleich.

Google Ads API CompositeData (Data Manager API) Hinweise
Kein Äquivalent. ip_data.ip_address Auf die unverarbeitete IPv4- oder IPv6-Adresse festgelegt. Weitere Informationen finden Sie unter IP-Adressformat.
Kein Äquivalent. ip_data.observe_start_time Der Zeitstempel im RFC 3339-Format, als die IP-Adresse zum ersten Mal beobachtet wurde.
Kein Äquivalent. ip_data.observe_end_time Auf den Zeitstempel im RFC 3339-Format festgelegt, als die IP-Adresse zuletzt beobachtet wurde.
user_identifiers user_data Auf ein UserData-Objekt festgelegt.

Mobilgeräte-IDs

Wenn Sie mobile IDs verwenden, legen Sie mobile_data auf ein MobileData mit einem Eintrag in mobile_ids für jede ID fest.

UserIdentifier (Google Ads API) MobileData (Data Manager API) Hinweise
mobile_id mobile_ids Wird auf die Liste der mobilen IDs für das Zielgruppenmitglied festgelegt.

In der Google Ads API fügen Sie für jedes Mitglied der Zielgruppe ein separates UserIdentifier mit mobile_id für jede mobile ID hinzu. Fügen Sie in der Data Manager API ein einzelnes MobileData mit mobile_ids hinzu, das auf die Liste aller Mobilgeräte-IDs für das Zielgruppenmitglied festgelegt ist.

user_identifier_source Kein Äquivalent.

Nutzer-IDs

Wenn Sie User-IDs verwenden, legen Sie user_id_data auf UserIdData und user_id auf die User-ID für das Zielgruppenmitglied fest.

UserIdentifier (Google Ads API) UserIdData (Data Manager API) Hinweise
third_party_user_id user_id

In der Google Ads API fügen Sie für jede Nutzer-ID des Zielgruppenmitglieds ein separates UserIdentifier mit third_party_user_id hinzu.

Legen Sie in der Data Manager API das Feld user_id_data auf UserIdData und das Feld user_id auf die Nutzer-ID für das Zielgruppenmitglied fest. Sie können nicht mehrere Nutzer-IDs für dasselbe Zielgruppenmitglied senden.

user_identifier_source Kein Äquivalent.
Zurück
Upgrade ausführen