Mappature di campi

Utilizza le mappature dei campi per eseguire l'upgrade di ogni passaggio del flusso di lavoro Customer Match dall'API Google Ads all'API Data Manager:

Mappature dei campi di gestione segmenti di pubblico

Utilizza i mapping nelle tabelle per mappare un UserList nell'API Google Ads al suo UserList equivalente nell'API Data Manager.

UserList (API Google Ads) UserList (API Data Manager) Note
resource_name name Per maggiori dettagli, vedi Nomi delle risorse.
id id
read_only read_only
name display_name Obbligatorio
description description Obbligatorio
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Il periodo di tempo in cui un membro del pubblico rimane nell'elenco dopo essere stato aggiunto. Il valore deve corrispondere a giorni interi. Se non viene impostato, il valore predefinito è il valore massimo.

Formatta il valore utilizzando il formato timestamp.
size_for_display size_info.display_network_members_count
size_range_for_display Nessun equivalente. Utilizza size_info.display_network_members_count per le informazioni sulle taglie.
size_for_search size_info.search_network_members_count
size_range_for_search Nessun equivalente. Utilizza size_info.search_network_members_count per le informazioni sulle taglie.
type Nessun equivalente.
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 Non utilizzata per Customer Match.
crm_based_user_list ingested_user_list_info Obbligatorio. Consulta la sezione Informazioni sul segmento di pubblico Customer Match.
Nessun equivalente. ingested_user_list_info.pair_id_info Non utilizzata per Customer Match.
Nessun equivalente. ingested_user_list_info.partner_audience_info Non utilizzata per Customer Match.
logical_user_list Nessun equivalente. Non utilizzata per Customer Match.
logical_user_list Nessun equivalente. Non utilizzata per Customer Match.
lookalike_user_list Nessun equivalente. Non utilizzata per Customer Match.
rule_based_user_list Nessun equivalente. Non utilizzata per Customer Match.
similar_user_list Nessun equivalente. Non utilizzata per Customer Match.

Informazioni sul segmento di pubblico Customer Match

Nell'API Google Ads, il campo crm_based_user_list è obbligatorio quando viene creato un segmento di pubblico Customer Match.

Nell'API Data Manager, imposta gli attributi equivalenti impostando il campo ingested_user_list_info su IngestedUserListInfo, quindi imposta i campi obbligatori per Customer Match e il tipo di dati utente.

Dati di contatto

upload_key_types
Impostato su un elenco contenente CONTACT_INFO.
contact_id_info

Impostato su un ContactIdInfo.

Imposta data_source_type su DATA_SOURCE_TYPE_FIRST_PARTY.

ID mobile

upload_key_types
Impostato su un elenco contenente MOBILE_ID.
mobile_id_info

Impostato su un MobileIdInfo.

  • Imposta data_source_type su DATA_SOURCE_TYPE_FIRST_PARTY.
  • Imposta key_space su IOS o ANDROID.
  • Imposta app_id sulla stringa che identifica in modo univoco l'applicazione mobile da cui sono stati raccolti i dati. Utilizza lo stesso formato che utilizzi per l'ID app nell'API Google Ads.

ID utente

upload_key_types
Impostato su un elenco contenente USER_ID.
user_id_info

Impostato su un UserIdInfo.

Imposta data_source_type su DATA_SOURCE_TYPE_FIRST_PARTY.

Nomi delle risorse

L'API Data Manager utilizza un formato del nome della risorsa diverso rispetto all'API Google Ads.

API Google Ads

Nell'API Google Ads, un nome risorsa UserList utilizza il formato:

customers/{customer_id}/userLists/{user_list_id}

API Data Manager

Nell'API Data Manager, il nome di una risorsa UserList utilizza il formato:

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

Caricare le mappature dei campi

Utilizza i mapping nelle tabelle per mappare un AddOfflineUserDataJobOperationsRequest nell'API Google Ads al suo equivalente IngestAudienceMembersRequest nell'API Data Manager.

Campi della richiesta

AddOfflineUserDataJobOperationsRequest (API Google Ads) IngestAudienceMembersRequest (API Data Manager) Note
  • Campo customer_id
  • customer_match_user_list_metadata campo di OfflineUserDataJob
  • Intestazione della richiesta developer-token
  • Intestazione della richiesta login-customer_id
  • Intestazione della richiesta linked-customer-id
 destinations Consulta Campi cliente e segmento di pubblico.
consent da customer_match_user_list_metadata di OfflineUserDataJob consent Impostazioni predefinite facoltative per il consenso per i membri del segmento di pubblico nella richiesta. Puoi ignorare questo valore per un singolo membro del segmento di pubblico impostando il campo consent di AudienceMember.
Nessun equivalente encoding Obbligatorio:impostato sul Encoding utilizzato per i valori UserIdentifier.
Nessun equivalente encryption_info Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, vedi Crittografia.
job_id Nessun equivalente Utilizza request_id restituito nella risposta per recuperare diagnostica.
enable_partial_failure Nessun equivalente L'API Data Manager non supporta l'errore parziale. Se un campo di un IngestAudienceMembersRequest non supera la convalida, l'API Data Manager rifiuta l'intera richiesta. Recupera gli errori di elaborazione utilizzando la diagnostica.
enable_warnings Nessun equivalente L'API Data Manager non segnala avvisi nella risposta. Recupera gli avvisi di elaborazione utilizzando la diagnostica.
validate_only validate_only
operations audience_members L'elenco dei membri del segmento di pubblico. Per ulteriori dettagli, consulta la sezione Campi dei membri del pubblico.
Nessun equivalente terms_of_service Obbligatorio. Impostato per indicare che l'utente ha accettato o rifiutato i Termini di servizio per Customer Match.

Campi dei clienti e dei segmenti di pubblico

L'API Google Ads supporta il caricamento dei membri del pubblico in un solo pubblico per job.Inoltre, è obbligatoria l'intestazione della richiesta developer-token e devi impostare le intestazioni della richiesta login-customer-id e linked-customer-id per diversi scenari di autenticazione.

L'API Data Manager supporta l'invio di membri del segmento di pubblico per più segmenti di pubblico in un'unica richiesta. L'API Data Manager non richiede un token sviluppatore e specifica le informazioni di accesso e del cliente collegato utilizzando i campi di un Destination anziché le intestazioni delle richieste. Per saperne di più sulle destinazioni, consulta Configurare le destinazioni.

L'API Data Manager non supporta la rimozione di tutti i membri di un segmento di pubblico. Nell'API Google Ads, puoi rimuovere tutti i membri di un segmento di pubblico impostando il campo remove_all di un OfflineUserDataJobOperation su true.

Ecco come mappare i campi dell'API Google Ads per un singolo segmento di pubblico ai campi equivalenti in un Destination:

API Google Ads Destination (API Data Manager) Note
customer_id della richiesta operating_account Imposta account_id sull'ID cliente del pubblico. Imposta account_type di operating_account su GOOGLE_ADS.
Intestazione della richiesta developer-token Nessun equivalente Per l'API Data Manager non è necessario un token sviluppatore.
Intestazione della richiesta login-customer-id login_account Imposta account_id sull'ID cliente dell'account di accesso. Imposta account_type su GOOGLE_ADS se l'account di accesso è un account Google Ads o su DATA_PARTNER se l'account di accesso è un account partner di dati.
Intestazione della richiesta linked-customer-id linked_account Imposta account_id sull'ID cliente dell'account collegato. Imposta account_type su DATA_PARTNER.
user_list da customer_match_user_list_metadata di OfflineUserDataJob product_destination_id Obbligatorio. Imposta l'ID numerico del segmento di pubblico. Non utilizzare il nome della risorsa di UserList.
Nessun equivalente reference Un identificatore definito dall'utente per Destination. Imposta questo campo se invii membri del segmento di pubblico per più segmenti di pubblico in un'unica richiesta.

Campi dei membri del pubblico

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

Impostato per specificare il consenso per il membro del segmento di pubblico.

Entrambe le API utilizzano un oggetto Consent simile (ad_user_data, ad_personalization).

Per l'API Data Manager, puoi anche impostare il consenso per tutti i membri del segmento di pubblico in una richiesta impostando il campo consent a livello di richiesta.
transaction_attribute Nessun equivalente. Non applicabile a Customer Match.
user_attribute Nessun equivalente. Non applicabile a Customer Match.
user_identifiers
  • mobile_id_data
  • user_id_data
  • user_identifiers

Compila il campo corrispondente al tipo di dati che stai inviando per i membri del segmento di pubblico. Per maggiori dettagli, consulta la sezione Campi identificatore dell'utente.

Campi identificatore dell'utente

Nell'API Google Ads, che tu invii dati di contatto, ID dispositivo mobile o ID utente, utilizzi UserIdentifier. L'API Data Manager utilizza un approccio diverso, con campi diversi per ogni tipo di dati.

Nell'API Data Manager, compila il campo corrispondente al tipo di dati che stai inviando:

Dati di contatto

Se utilizzi dati di contatto come indirizzo email, numero di telefono o indirizzo, imposta user_data su un UserData con una voce separata in user_identifiers per ogni dato di contatto.

UserIdentifier (API Google Ads) UserIdentifier (API Data Manager) Note
address_info address Per maggiori dettagli, vedi Campi indirizzo.
hashed_email email_address Imposta l'indirizzo email formattato e sottoposto a hashing. Puoi anche criptare l'indirizzo email con hash.
hashed_phone_number phone_number Impostato sul numero di telefono formattato e sottoposto ad hashing. Puoi anche criptare il numero di telefono sottoposto ad hashing.
user_identifier_source Nessun equivalente.

Campi dell'indirizzo

Di seguito sono riportate le mappature dei campi tra OfflineUserAddressInfo nell'API Google Ads e AddressInfo nell'API Data Manager. Utilizza questi mapping se utilizzi i dati di contatto per compilare il segmento di pubblico Customer Match.

OfflineUserAddressInfo (API Google Ads) AddressInfo (API Data Manager) Note
city Nessun equivalente.
country_code region_code
hashed_first_name given_name

Impostato sul nome formattato e sottoposto ad hashing. Puoi anche criptare il nome fornito con hash.
hashed_last_name family_name

Imposta il cognome formattato e sottoposto ad hashing. Puoi anche criptare il nome dell'hash della famiglia.
hashed_street_address Nessun equivalente.
postal_code postal_code
state Nessun equivalente.

ID mobile

Se utilizzi ID mobile, imposta mobile_data su un MobileData con una voce in mobile_ids per ogni ID.

UserIdentifier (API Google Ads) MobileData (API Data Manager) Note
mobile_id mobile_ids Impostato sull'elenco degli ID dispositivo mobile per il membro del segmento di pubblico.

Nell'API Google Ads, aggiungi un UserIdentifier con mobile_id per ogni ID dispositivo mobile del membro del segmento di pubblico. Nell'API Data Manager, aggiungi un singolo MobileData con mobile_ids impostato sull'elenco di tutti gli ID mobile per il membro del segmento di pubblico.

user_identifier_source Nessun equivalente.

ID utente

Se utilizzi gli ID utente, imposta user_id_data su un UserIdData e imposta user_id sull'ID utente del membro del pubblico.

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

Nell'API Google Ads, aggiungi un UserIdentifier con third_party_user_id per ogni ID utente del membro del segmento di pubblico.

Nell'API Data Manager, imposta il campo user_id_data su un UserIdData e imposta il campo user_id sull'ID utente del membro del pubblico. Non puoi inviare più ID utente per lo stesso membro del segmento di pubblico.

user_identifier_source Nessun equivalente.
Indietro
Procedura per l'upgrade