Feldzuordnungen

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

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 ist das Feld crm_based_user_list erforderlich, 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_INFO festlegen.
contact_id_info

Legen Sie einen ContactIdInfo fest.

Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY.

Mobilgerät-IDs

upload_key_types
Auf eine Liste mit MOBILE_ID festlegen.
mobile_id_info

Legen Sie einen MobileIdInfo fest.

  • Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY.
  • Legen Sie key_space auf IOS oder ANDROID fest.
  • 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 die App-ID in der Google Ads API.

Nutzer-IDs

upload_key_types
Auf eine Liste mit USER_ID festlegen.
user_id_info

Legen Sie einen UserIdInfo fest.

Setzen Sie data_source_type auf DATA_SOURCE_TYPE_FIRST_PARTY.

Ressourcennamen

Die Data Manager API verwendet ein anderes Ressourcennameformat 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 ein AddOfflineUserDataJobOperationsRequest in der Google Ads API dem entsprechenden IngestAudienceMembersRequest in der Data Manager API zuzuordnen.

Anfragefelder

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 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 Wert auf die Encoding fest, die 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 die in der Antwort zurückgegebene request_id, um Diagnoseinformationen abzurufen.
enable_partial_failure Kein Äquivalent Die Data Manager API unterstützt keine Teilausfälle. Wenn die Validierung eines Felds in einem IngestAudienceMembersRequest fehlschlägt, wird die gesamte Anfrage von der Data Manager API abgelehnt. Verarbeitungsfehler mit Diagnose abrufen.
enable_warnings Kein Äquivalent In der Data Manager API werden keine Warnungen in der Antwort gemeldet. Verarbeitungswarnungen mit diagnostics abrufen.
validate_only validate_only
operations audience_members Die Liste der Zielgruppenmitglieder. Weitere Informationen finden Sie im Abschnitt Felder für Zielgruppenmitglieder.
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

Mit der Google Ads API können Sie Zielgruppenmitglieder nur in eine Zielgruppe pro Job hochladen.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 Kundeninformationen werden über Felder eines Destination anstelle von Anfrageheadern angegeben. Weitere Informationen zu Zielen finden Sie unter Ziele konfigurieren.

Über die Data Manager API ist es nicht möglich, alle Mitglieder einer Zielgruppe zu entfernen. In der Google Ads API können Sie alle Mitglieder einer Zielgruppe entfernen, indem Sie das Feld remove_all eines OfflineUserDataJobOperation auf true festlegen.

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 für account_id 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 Entwickler-Token erforderlich.
login-customer-id-Anfrageheader login_account Legen Sie account_id auf die Kundennummer 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.
linked-customer-id-Anfrageheader linked_account Legen Sie account_id auf die Kundennummer des verknüpften Kontos fest. Setzen Sie account_type auf DATA_PARTNER.
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 der 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 einzelnen Anfrage senden.

Felder für Zielgruppenmitglieder

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

Legen Sie fest, ob die Einwilligung für das Zielgruppenmitglied eingeholt wurde.

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_id_data
  • user_id_data
  • user_identifiers

Füllen Sie das Feld aus, das dem Typ der Daten entspricht, die 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 user_data auf ein UserData mit einem separaten Eintrag in user_identifiers für jedes Kontaktdatum fest.

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 die gehashte E-Mail-Adresse auch verschlüsseln.
hashed_phone_number phone_number Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können auch die gehashte Telefonnummer 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 für den Kundenabgleich zu erstellen.

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

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

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
state Kein Äquivalent.

Mobilgerät-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 Mobilgeräte-IDs für das Zielgruppenmitglied festgelegt.

In der Google Ads API fügen Sie für jede mobile ID des Zielgruppenmitglieds ein separates UserIdentifier mit mobile_id hinzu. Fügen Sie in der Data Manager API ein einzelnes MobileData mit mobile_ids ein, 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 eine 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