Mapowanie pól

Użyj mapowań pól, aby uaktualnić każdy krok procesu kierowania na listę klientów z interfejsu Google Ads API do interfejsu Data Manager API:

Mapowania pól zarządzania odbiorcami

Użyj mapowań w tabelach, aby zmapować UserList w interfejsie Google Ads API na jego odpowiednik UserList w interfejsie Data Manager API.

UserList (interfejs Google Ads API) UserList (Data Manager API) Uwagi
resource_name name Szczegółowe informacje znajdziesz w sekcji Nazwy zasobów.
id id
read_only read_only
name display_name Wymagany
description description Wymagany
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Okres, przez jaki odbiorca pozostaje na liście po dodaniu. Wartość musi odpowiadać pełnym dniom. Jeśli nie jest ustawiona, domyślnie przyjmuje się wartość maksymalną.

Sformatuj wartość za pomocą formatu sygnatury czasowej.
size_for_display size_info.display_network_members_count
size_range_for_display Brak odpowiednika. Informacje o rozmiarze podawaj w size_info.display_network_members_count.
size_for_search size_info.search_network_members_count
size_range_for_search Brak odpowiednika. Informacje o rozmiarze podawaj w size_info.search_network_members_count.
type Brak odpowiednika.
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 Nie jest używane w przypadku kierowania na listę klientów.
crm_based_user_list ingested_user_list_info Wymagane. Zobacz informacje o odbiorcach kierowania na listę klientów.
Brak odpowiednika. ingested_user_list_info.pair_id_info Nie jest używane w przypadku kierowania na listę klientów.
Brak odpowiednika. ingested_user_list_info.partner_audience_info Nie jest używane w przypadku kierowania na listę klientów.
logical_user_list Brak odpowiednika. Nie jest używane w przypadku kierowania na listę klientów.
logical_user_list Brak odpowiednika. Nie jest używane w przypadku kierowania na listę klientów.
lookalike_user_list Brak odpowiednika. Nie jest używane w przypadku kierowania na listę klientów.
rule_based_user_list Brak odpowiednika. Nie jest używane w przypadku kierowania na listę klientów.
similar_user_list Brak odpowiednika. Nie jest używane w przypadku kierowania na listę klientów.

Informacje o odbiorcach kierowania na listę klientów

W interfejsie Google Ads API pole crm_based_user_list jest wymagane podczas tworzenia grupy odbiorców kierowania na listę klientów.

W interfejsie Data Manager API ustaw odpowiednie atrybuty, ustawiając pole ingested_user_list_info na wartość IngestedUserListInfo, a następnie ustaw pola wymagane w przypadku kierowania na listę klientów i rodzaj danych użytkowników.

Informacje kontaktowe

upload_key_types
Ustaw na listę zawierającą CONTACT_INFO.
contact_id_info

Ustaw wartość ContactIdInfo.

Ustaw wartość data_source_type na DATA_SOURCE_TYPE_FIRST_PARTY.

Identyfikatory urządzeń mobilnych

upload_key_types
Ustaw na listę zawierającą MOBILE_ID.
mobile_id_info

Ustaw wartość MobileIdInfo.

  • Ustaw wartość data_source_type na DATA_SOURCE_TYPE_FIRST_PARTY.
  • Ustaw wartość key_space na IOS lub ANDROID.
  • Ustaw wartość app_id na ciąg znaków, który jednoznacznie identyfikuje aplikację mobilną, z której zebrano dane. Użyj tego samego formatu, co w przypadku identyfikatora aplikacji w interfejsie Google Ads API.

Identyfikatory użytkowników

upload_key_types
Ustaw na listę zawierającą USER_ID.
user_id_info

Ustaw wartość UserIdInfo.

Ustaw wartość data_source_type na DATA_SOURCE_TYPE_FIRST_PARTY.

Nazwy zasobów

Interfejs Data Manager API używa innego formatu nazw zasobów niż interfejs Google Ads API.

Interfejs Google Ads API

W interfejsie Google Ads API UserList nazwa zasobu ma format:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

W interfejsie Data Manager API UserList nazwa zasobu ma format:

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

Przesyłanie mapowań pól

Użyj mapowań w tabelach, aby przypisać AddOfflineUserDataJobOperationsRequest w interfejsie Google Ads API do jego odpowiednika IngestAudienceMembersRequest w interfejsie Data Manager API.

Pola żądania

AddOfflineUserDataJobOperationsRequest (interfejs Google Ads API) IngestAudienceMembersRequest (Data Manager API) Uwagi
  • customer_id pole
  • customer_match_user_list_metadata pole OfflineUserDataJob
  • nagłówek żądania developer-token
  • nagłówek żądania login-customer_id
  • nagłówek żądania linked-customer-id
 destinations Zobacz Pola dotyczące klientów i odbiorców.
consent z  customer_match_user_list_metadata OfflineUserDataJob consent Opcjonalne domyślne ustawienia dotyczące zgody użytkowników w żądaniu. Możesz zastąpić tę wartość w przypadku poszczególnych odbiorców, ustawiając pole consent w AudienceMember.
Brak odpowiednika encoding Wymagane: ustaw na Encoding używany w przypadku wartości UserIdentifier.
Brak odpowiednika encryption_info Określ, czy żądanie zawiera zaszyfrowane wartości. Więcej informacji znajdziesz w sekcji Szyfrowanie.
job_id Brak odpowiednika Użyj parametru request_id zwróconego w odpowiedzi, aby pobrać diagnostykę.
enable_partial_failure Brak odpowiednika Interfejs Data Manager API nie obsługuje częściowych błędów. Jeśli w przypadku dowolnego pola w IngestAudienceMembersRequest weryfikacja się nie powiedzie, interfejs Data Manager API odrzuci całe żądanie. Pobierz błędy przetwarzania za pomocą diagnostyki.
enable_warnings Brak odpowiednika Interfejs Data Manager API nie zgłasza ostrzeżeń w odpowiedzi. Pobierz ostrzeżenia dotyczące przetwarzania za pomocą diagnostyki.
validate_only validate_only
operations audience_members Lista odbiorców. Więcej informacji znajdziesz w sekcji dotyczącej pól członków listy odbiorców.
Brak odpowiednika terms_of_service Wymagane. Ustawienie wskazujące, czy użytkownik zaakceptował lub odrzucił warunki korzystania z usługi kierowania na listę klientów.

Pola dotyczące klientów i odbiorców

Interfejs Google Ads API obsługuje przesyłanie członków list odbiorców tylko do jednej listy odbiorców na zadanie. Wymagany jest też nagłówek żądania developer-token. Nagłówki żądań login-customer-id i linked-customer-id ustawia się w różnych scenariuszach uwierzytelniania.

Interfejs Data Manager API obsługuje wysyłanie członków wielu list odbiorców w ramach jednego żądania. Interfejs Data Manager API nie wymaga tokena programisty, a informacje o logowaniu i połączonym kliencie podajesz w polach Destination zamiast w nagłówkach żądań. Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.

Interfejs Data Manager API nie obsługuje usuwania wszystkich członków listy odbiorców. W interfejsie Google Ads API możesz usunąć wszystkich członków listy odbiorców, ustawiając pole remove_all obiektu OfflineUserDataJobOperation na true.

Aby zmapować pola interfejsu Google Ads API dla pojedynczej listy odbiorców na odpowiednie pola w Destination:

Interfejs Google Ads API Destination (Data Manager API) Uwagi
customer_id prośby operating_account Ustaw account_id na identyfikator klienta grupy odbiorców. Ustaw account_type w operating_account na GOOGLE_ADS.
nagłówek żądania developer-token Brak odpowiednika Token programisty nie jest wymagany w przypadku interfejsu Data Manager API.
nagłówek żądania login-customer-id login_account Ustaw account_id na identyfikator klienta konta logowania. Ustaw wartość account_type na GOOGLE_ADS, jeśli konto logowania jest kontem Google Ads, lub DATA_PARTNER, jeśli jest to konto partnera danych.
nagłówek żądania linked-customer-id linked_account Ustaw account_id na identyfikator klienta połączonego konta. Ustaw wartość account_type na DATA_PARTNER.
user_list z customer_match_user_list_metadata OfflineUserDataJob product_destination_id Wymagane. Ustaw na liczbowy identyfikator listy odbiorców. Nie używaj nazwy zasobu elementu UserList.
Brak odpowiednika reference Identyfikator zdefiniowany przez użytkownika dla Destination. Ustaw to pole, jeśli wysyłasz w jednym żądaniu dane członków wielu list odbiorców.

Pola członków grupy odbiorców

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

Ustaw, aby określić zgodę użytkownika.

Oba interfejsy API używają podobnego Consent obiektu (ad_user_data, ad_personalization).

W przypadku interfejsu Data Manager API możesz też ustawić zgodę dla wszystkich członków listy odbiorców w żądaniu, ustawiając pole consent na poziomie żądania.
transaction_attribute Brak odpowiednika. Nie dotyczy kierowania na listę klientów.
user_attribute Brak odpowiednika. Nie dotyczy kierowania na listę klientów.
user_identifiers
  • mobile_id_data
  • user_id_data
  • user_identifiers

Wypełnij pole odpowiadające typowi danych, które wysyłasz w przypadku członków listy odbiorców. Więcej informacji znajdziesz w sekcji Pola identyfikatorów użytkownika.

Pola identyfikatorów użytkownika

W interfejsie Google Ads API do wysyłania danych kontaktowych, identyfikatorów urządzeń mobilnych lub identyfikatorów użytkowników używasz parametru UserIdentifier. Interfejs Data Manager API korzysta z innego podejścia i ma różne pola dla każdego typu danych.

W interfejsie Data Manager API wypełnij pole odpowiadające typowi przesyłanych danych:

Informacje kontaktowe

Jeśli używasz informacji kontaktowych, takich jak adres e-mail, numer telefonu lub adres, ustaw wartość user_data na UserData z osobnym wpisem w user_identifiers dla każdego elementu informacji kontaktowych.

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Uwagi
address_info address Więcej informacji znajdziesz w sekcji Pola adresu.
hashed_email email_address Ustaw na sformatowany i zahaszowany adres e-mail. Możesz też zaszyfrować zahaszowany adres e-mail.
hashed_phone_number phone_number Ustaw na sformatowany i zahaszowany numer telefonu. Możesz też zaszyfrować zahaszowany numer telefonu.
user_identifier_source Brak odpowiednika.

Pola adresu

Poniżej znajdziesz mapowania pól między OfflineUserAddressInfo w interfejsie Google Ads API a AddressInfo w interfejsie Data Manager API. Używaj tych mapowań, jeśli używasz informacji kontaktowych do wypełniania listy klientów na potrzeby kierowania na listę klientów.

OfflineUserAddressInfo (Google Ads API) AddressInfo (Data Manager API) Uwagi
city Brak odpowiednika.
country_code region_code
hashed_first_name given_name

Ustaw na sformatowane i zahaszowane imię. Możesz też zaszyfrować zahaszowane imię.
hashed_last_name family_name

Ustaw na sformatowane i zahaszowane nazwisko. Możesz też zaszyfrować zahaszowaną nazwę rodziny.
hashed_street_address Brak odpowiednika.
postal_code postal_code
state Brak odpowiednika.

Identyfikatory urządzeń mobilnych

Jeśli używasz identyfikatorów mobilnych, ustaw wartość mobile_data na MobileData z wpisem w mobile_ids dla każdego identyfikatora.

UserIdentifier (Google Ads API) MobileData (Data Manager API) Uwagi
mobile_id mobile_ids Ustaw na listę identyfikatorów mobilnych odbiorcy.

W interfejsie Google Ads API dodajesz osobny UserIdentifier z mobile_id dla każdego identyfikatora mobilnego użytkownika. W interfejsie Data Manager API dodaj pojedynczy element MobileData z wartością mobile_ids ustawioną na listę wszystkich identyfikatorów mobilnych użytkownika.

user_identifier_source Brak odpowiednika.

Identyfikatory użytkowników

Jeśli używasz identyfikatorów użytkowników, ustaw user_id_data na UserIdData, a user_id na identyfikator użytkownika należącego do grupy odbiorców.

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

W interfejsie Google Ads API dodajesz osobny UserIdentifier z parametrem third_party_user_id dla każdego identyfikatora użytkownika w przypadku członka grupy odbiorców.

W interfejsie Data Manager API ustaw pole user_id_data na UserIdData, a pole user_id na identyfikator użytkownika należącego do segmentu odbiorców. Nie możesz wysyłać wielu identyfikatorów użytkownika w przypadku tego samego członka listy odbiorców.

user_identifier_source Brak odpowiednika.
Wstecz
Przejście na nową wersję