Mappature di campi

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

• Mappature dei campi di gestione dei segmenti di pubblico contiene le mappature dei campi per la creazione, l'aggiornamento e il recupero dei segmenti di pubblico.

• Mappature dei campi di importazione contiene le mappature dei campi per l'aggiunta o la rimozione di membri del segmento di pubblico.

Autenticazione

L'API Data Manager richiede credenziali con un ambito diverso rispetto all'API Google Ads. Segui i passaggi descritti in Configura l'accesso API per generare nuove credenziali che includono l'ambito dell'API Data Manager.

Mappature dei campi di Gestione segmenti di pubblico

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

UserList (API Google Ads)	UserList (API Data Manager)	Note
resource_name	name	Per maggiori dettagli, consulta 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	La durata della permanenza di un membro del segmento di pubblico nell'elenco dopo l'aggiunta. Il valore deve corrispondere a giorni interi. Se non viene impostato, il valore predefinito è il massimo. Formatta il valore utilizzando il formato timestamp.
size_for_display	size_info.display_network_members_count
size_range_for_display	Nessun equivalente.	Utilizza l'attributo size_info.display_network_members_count per le informazioni sulla taglia.
size_for_search	size_info.search_network_members_count
size_range_for_search	Nessun equivalente.	Utilizza l'attributo size_info.search_network_members_count per le informazioni sulla taglia.
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 utilizzato per Customer Match.
crm_based_user_list	ingested_user_list_info	Obbligatorio. Consulta le informazioni sul segmento di pubblico Customer Match.
Nessun equivalente.	ingested_user_list_info.pair_id_info	Non utilizzato per Customer Match.
Nessun equivalente.	ingested_user_list_info.partner_audience_info	Non utilizzato per Customer Match.
logical_user_list	Nessun equivalente.	Non utilizzato per Customer Match.
logical_user_list	Nessun equivalente.	Non utilizzato per Customer Match.
lookalike_user_list	Nessun equivalente.	Non utilizzato per Customer Match.
rule_based_user_list	Nessun equivalente.	Non utilizzato per Customer Match.
similar_user_list	Nessun equivalente.	Non utilizzato per Customer Match.

Informazioni sui segmenti di pubblico Customer Match

Nell'API Google Ads, devi impostare il campo crm_based_user_list su un valore CrmBasedUserListInfo quando crei un segmento di pubblico Customer Match.

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

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, il nome di una risorsa UserList utilizza il seguente formato:

customers/{customer_id}/userLists/{user_list_id}

API Data Manager

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

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

Carica mappature dei campi

Utilizza le mappature nelle tabelle per mappare un AddOfflineUserDataJobOperationsRequest nell'API Google Ads alla richiesta IngestionService equivalente nell'API Data Manager.

Campi di richiesta

Queste mappature utilizzano IngestAudienceMembersRequest nell'API Data Manager come riferimento, ma puoi utilizzarle anche se stai convertendo la richiesta API Google Ads in una RemoveAudienceMembersRequest o in una RemoveAllAudienceMembersRequest.

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 relativi a clienti e segmenti di pubblico.
consent dal customer_match_user_list_metadata di OfflineUserDataJob	consent	Impostazioni predefinite facoltative per il consenso dei membri del segmento di pubblico nella richiesta. Puoi eseguire l'override di questo valore per un singolo membro del segmento di pubblico impostando il campo consent di AudienceMember.
Nessun equivalente	encoding	Obbligatorio: imposta il valore su Encoding utilizzato per i valori UserIdentifier.
Nessun equivalente	encryption_info	Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, consulta Crittografia.
job_id	Nessun equivalente	Utilizza il request_id restituito nella risposta per recuperare la diagnostica.
enable_partial_failure	Nessun equivalente	L'API Data Manager utilizza un modello di errore fast-fail. 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 da aggiungere o rimuovere. Per i dettagli, consulta la sezione Campi dell'operazione.
Nessun equivalente	terms_of_service	Obbligatorio. Impostato per indicare che l'utente ha accettato o rifiutato i Termini di servizio di Customer Match.

Campi relativi a clienti e segmenti di pubblico

L'API Google Ads supporta solo il caricamento dei membri del segmento di pubblico in un segmento di pubblico per job.Inoltre, è richiesta 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 una singola richiesta. L'API Data Manager non richiede un token sviluppatore e i dati del cliente collegato e di accesso vengono specificati utilizzando i campi di un Destination anziché le intestazioni della richiesta. Per saperne di più sulle destinazioni, consulta Configura le destinazioni.

Nell'API Google Ads, puoi rimuovere tutti i membri di un segmento di pubblico impostando il campo remove_all di un OfflineUserDataJobOperation su true.

Nell'API Data Manager, puoi farlo inviando un RemoveAllAudienceMembersRequest. Per maggiori dettagli, consulta la guida Rimuovi tutti i membri.

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 segmento di pubblico. Imposta account_type di operating_account su GOOGLE_ADS.
Intestazione della richiesta developer-token	Nessun equivalente	Per l'API Data Manager non è richiesto 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	Se accedi alla operating_account utilizzando un link partner, imposta account_id sull'ID cliente dell'account collegato e imposta account_type su DATA_PARTNER. In caso contrario, non impostare il campo linked_account.
user_list dal customer_match_user_list_metadata di OfflineUserDataJob	product_destination_id	Obbligatorio. Impostato sull'ID numerico del segmento di pubblico. Non utilizzare il nome della risorsa 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 dell'operazione

L'API Data Manager contiene metodi separati per l'aggiunta e la rimozione dei membri del segmento di pubblico. Al contrario, AddOfflineUserDataJobOperationsRequest nell'API Google Ads contiene un elenco di operations, ognuno dei quali aggiunge un membro, rimuove un membro o rimuove tutti i membri in base al tipo di operazione. Ecco la mappatura di ogni tipo di operazione al metodo corrispondente nell'API Data Manager:

OfflineUserDataJobOperation (API Google Ads)	IngestionService (API Data Manager)	Note
create	IngestAudienceMembers	Per maggiori dettagli, consulta la sezione Campi dei membri del segmento di pubblico.
remove	RemoveAudienceMembers	Per maggiori dettagli, consulta la sezione Campi dei membri del segmento di pubblico.
remove_all	RemoveAllAudienceMembers	Per maggiori dettagli, consulta Rimuovi tutti i membri del segmento di pubblico.

Campi dei membri del segmento di pubblico

UserData (API Google Ads)	AudienceMember (API Data Manager)	Note
consent	consent	Imposta 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_data user_id_data composite_data user_data ip_data	Compila il campo corrispondente al tipo di dati che stai inviando per i membri del segmento di pubblico. Per maggiori dettagli, consulta Campi identificatore dell'utente.

Campi identificatore dell'utente

Nell'API Google Ads, indipendentemente dal fatto che tu stia inviando dati di contatto, identità digitali o ID utente, utilizza 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: