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

Feldzuordnungen für die Zielgruppenverwaltung

Verwenden Sie die Zuordnungen in den Tabellen, um einen 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 bleibt. Der Wert muss ganzen Tagen entsprechen. Wenn nichts anderes festgelegt ist, wird standardmäßig der Höchstwert verwendet.

Formatieren Sie den Wert im 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ößeninformationen.
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ößeninformationen.
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 beim Erstellen einer Zielgruppe zum Kundenabgleich das Feld crm_based_user_list auf einen CrmBasedUserListInfo festlegen.

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

Kontaktdaten

upload_key_types
Legen Sie eine Liste mit CONTACT_ID fest. Das entspricht dem Festlegen 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 dem Festlegen von data_source_type auf FIRST_PARTY in der Google Ads API.

Digitale Ausweise

upload_key_types
Legen Sie eine Liste mit MOBILE_ID fest. Das entspricht dem Festlegen 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 dem Festlegen 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. Dies unterscheidet sich von der Google Ads API, bei der der Schlüsselbereich aus dem app_id abgeleitet wird.
  • Legen Sie für app_id den String fest, der die mobile Anwendung, aus der die Daten erfasst wurden, eindeutig identifiziert. Verwenden Sie dasselbe Format wie für app_id in der Google Ads API.

Nutzer-IDs

upload_key_types
Legen Sie eine Liste mit USER_ID fest. Das entspricht dem Festlegen 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 dem Festlegen 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 der Ressourcenname für UserList folgendes Format:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

In der Data Manager API hat der Name einer UserList-Ressource 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

Diese Zuordnungen verwenden die IngestAudienceMembersRequest in der Data Manager API als Referenz. Sie können diese Zuordnungen aber auch verwenden, wenn Sie Ihre Google Ads API-Anfrage in eine RemoveAudienceMembersRequest oder eine RemoveAllAudienceMembersRequest konvertieren.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (Data Manager API) Hinweise
  • Feld customer_id
  • customer_match_user_list_metadata-Feld von OfflineUserDataJob
  • developer-token-Anfrageheader
  • login-customer_id-Anfrageheader
  • linked-customer-id-Anfrageheader
 destinations Weitere Informationen finden Sie unter Kunden- und Zielgruppenfelder.
consent aus dem customer_match_user_list_metadata von OfflineUserDataJob consent Optionale Standardeinstellungen für die Einwilligung von Zielgruppenmitgliedern 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 Wird festgelegt, wenn 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 die Diagnose abzurufen.
enable_partial_failure Kein Äquivalent Die Data Manager API verwendet ein Fast-Fail-Fehlermodell. Wenn ein Feld eines IngestAudienceMembersRequest die Validierung nicht besteht, lehnt die Data Manager API die gesamte Anfrage ab. Rufen Sie Verarbeitungsfehler mithilfe der Diagnose ab.
enable_warnings Kein Äquivalent Die Data Manager API gibt keine Warnungen in der Antwort zurück. Rufen Sie Verarbeitungswarnungen mithilfe der Diagnose ab.
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. Wird festgelegt, um anzugeben, ob der Nutzer die Nutzungsbedingungen für den Kundenabgleich akzeptiert oder abgelehnt hat.

Kunden- und Zielgruppenfelder

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

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. 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.

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

In der Data Manager API senden Sie dazu eine RemoveAllAudienceMembersRequest. Weitere Informationen finden Sie im Leitfaden Alle Mitglieder entfernen.

So ordnen Sie die Google Ads API-Felder für eine einzelne Zielgruppe den entsprechenden Feldern in einer Destination zu:

Google Ads API Destination (Data Manager API) Hinweise
customer_id der Anfrage operating_account Legen Sie für account_id die Kundennummer der Zielgruppe 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 Loginkontos fest. Legen Sie account_type auf GOOGLE_ADS fest, wenn das Anmeldekonto ein Google Ads-Konto ist, oder auf DATA_PARTNER, wenn das Anmeldekonto ein Datenpartnerkonto ist.
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.
user_list aus dem customer_match_user_list_metadata von OfflineUserDataJob product_destination_id Erforderlich. Legen Sie die numerische ID der Zielgruppe fest. Verwenden Sie nicht den Ressourcennamen des 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 die AddOfflineUserDataJobOperationsRequest in der Google Ads API eine Liste von operations, die je nach Vorgangstyp entweder ein Mitglied hinzufügen, ein Mitglied entfernen oder alle Mitglieder entfernen. Hier ist 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 Felder für Zielgruppenmitglieder.
remove RemoveAudienceMembers Weitere Informationen finden Sie im Abschnitt Felder für Zielgruppenmitglieder.
remove_all RemoveAllAudienceMembers Weitere Informationen finden Sie unter Alle Zielgruppenmitglieder entfernen.

Felder für Zielgruppenmitglieder

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

Legen Sie die Einwilligung für das Zielgruppenmitglied fest.

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 Zielgruppenmitglieder in einer Anfrage auch festlegen, indem Sie das Feld consent auf Anfrageebene festlegen.
transaction_attribute Kein Äquivalent. Nicht zutreffend für Customer Match.
user_attribute Kein Äquivalent. Nicht zutreffend für Customer Match.
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 Nutzer-IDs.

Felder für Nutzer-IDs

In der Google Ads API verwenden Sie UserIdentifier, unabhängig davon, ob Sie Kontaktdaten, mobile IDs oder Nutzer-IDs senden. Die Data Manager API verwendet einen anderen Ansatz mit unterschiedlichen Feldern für jeden Datentyp.

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 für composite_data 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 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.
user_identifier_source Kein Äquivalent.

Adressfelder

Hier sind 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 füllen.

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

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

Erforderlich. Legen Sie den formatierten und gehashten Nachnamen fest. Sie können den gehashten Nachnamen auch verschlüsseln.
hashed_street_address Kein Äquivalent.
postal_code postal_code Erforderlich
state Kein Äquivalent.

IP-Adresse

Die Data Manager API unterstützt neben Nutzer-IDs auch IP-Adressen für Uploads zum Kundenabgleich. Diese werden in CompositeData bereitgestellt, das UserData und IpData bündelt. 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 Legen Sie die IPv4- oder IPv6-Rohadresse fest. Weitere Informationen finden Sie im Leitfaden zum IP-Adressformat.
Kein Äquivalent. ip_data.observe_start_time Wird auf den Zeitstempel im RFC 3339-Format gesetzt, zu dem die IP-Adresse zum ersten Mal beobachtet wurde.
Kein Äquivalent. ip_data.observe_end_time Wird auf den Zeitstempel im RFC 3339-Format gesetzt, zu dem die IP-Adresse zuletzt beobachtet wurde.
user_identifiers user_data Legen Sie ein UserData-Objekt fest.

Digitale Ausweise

Wenn Sie mobile IDs verwenden, legen Sie für mobile_data einen 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 Legen Sie die Liste der mobilen IDs für das Zielgruppenmitglied fest.

In der Google Ads API fügen Sie für jede mobile ID des Zielgruppenmitglieds eine separate UserIdentifier mit mobile_id hinzu. Fügen Sie in der Data Manager API ein einzelnes MobileData hinzu, wobei mobile_ids auf die Liste aller mobilen IDs für das Zielgruppenmitglied festgelegt ist.

user_identifier_source Kein Äquivalent.

Nutzer-IDs

Wenn Sie Nutzer-IDs verwenden, legen Sie für user_id_data eine UserIdData und für user_id die Nutzer-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