Mappature di campi

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

Campi della richiesta

UploadClickConversionRequest (API Google Ads) IngestEventsRequest (API Data Manager) Note
  • customer_id
  • Intestazione della richiesta developer-token
  • Intestazione della richiesta login-customer_id
  • Intestazione della richiesta linked-customer-id
  • conversion_action
destinations Consulta Campi cliente e azione di conversione.
Nessun equivalente consent Impostazioni predefinite facoltative per il consenso per gli eventi nella richiesta. Puoi eseguire l'override di questo valore per un singolo evento impostando il campo consent di Event.
Nessun equivalente encoding Obbligatorio:impostato su 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 la diagnostica.
partial_failure Nessun equivalente L'API Data Manager non supporta l'errore parziale. Se la convalida di un campo di IngestEventsRequest non va a buon fine, l'API Data Manager rifiuta l'intera richiesta.
validate_only validate_only
conversions events L'elenco delle conversioni o degli eventi. Per maggiori dettagli, consulta la sezione Campi di conversione.

Campi cliente e azione di conversione

L'API Google Ads richiede 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 non richiede un token sviluppatore e specifica le informazioni di accesso e sul cliente collegato utilizzando i campi di un Destination anziché le intestazioni della richiesta. Per ulteriori informazioni sulle destinazioni, consulta Configurare le destinazioni.

Ecco come mappare i campi dell'API Google Ads per un singolo conversion_action 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 dell'account conversioni Google Ads. Imposta account_type di operating_account su GOOGLE_ADS.

L'API Data Manager potrebbe richiedere un ID cliente diverso da quello utilizzato per l'API Google Ads. Per ulteriori dettagli, consulta la sezione Differenza nei requisiti dell'account di destinazione.

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.
conversion_action di un ClickConversion product_destination_id Imposta l'ID numerico dell'azione di conversione. Non utilizzare il nome della risorsa di ConversionAction.
Nessun equivalente reference Un identificatore definito dall'utente per Destination. Imposta questo campo se invii conversioni per più azioni di conversione in un'unica richiesta.

Campi di conversione

ClickConversion (API Google Ads) Event (API Data Manager) Note
cart_data cart_data Per maggiori dettagli, vedi Campi dei dati del carrello.
consent consent 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 gli eventi in una richiesta impostando il campo consent a livello di richiesta.
conversion_action destination_references Se invii conversioni per più azioni di conversione in un'unica richiesta, imposta questo campo sul reference corrispondente della destinazione.
conversion_date_time event_timestamp
Per maggiori dettagli, vedi Formato per il timestamp.
conversion_environment Nessun equivalente
conversion_value conversion_value Impostato sul valore della valuta, non sul valore in micro. Ad esempio, per un valore di conversione di 5,23 $, utilizza il valore 5.23.
currency_code currency
custom_variables custom_variables Per maggiori dettagli, consulta Campi delle variabili personalizzate.
customer_type
Nessun equivalente event_source
Nessun equivalente event_device_info
external_attribution_data Nessun equivalente
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
Nessun equivalente last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes Per maggiori dettagli, vedi Aggiungere attributi di sessione.
session_attributes_key_value_pairs experimental_fields Per maggiori dettagli, vedi Aggiungere attributi di sessione.
user_identifiers user_data.user_identifiers Per maggiori dettagli, vedi Campi identificatore dell'utente.
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

Campi dei dati del carrello

CartData (API Google Ads) CartData (API Data Manager) Note
feed_country_code merchant_feed_label Imposta l'etichetta del feed.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Campi degli articoli per i dati del carrello

Item (API Google Ads) Item (API Data Manager) Note
product_id merchant_product_id
quantity quantity
unit_price unit_price
Nessun equivalente item_id
Nessun equivalente additional_item_parameters

Campi delle variabili personalizzate

CustomVariable (API Google Ads) CustomVariable (API Data Manager) Note
Nessun equivalente destination_references L'API Google Ads richiede richieste separate per azione di conversione. L'API Data Manager supporta l'invio di conversioni per più azioni di conversione in un'unica richiesta, nonché l'utilizzo di questo campo destination_references per indicare quali destinazioni devono ricevere una variabile personalizzata specifica.
conversion_custom_variable variable Imposta il nome della variabile anziché un nome di risorsa.
value value

Campi identificatore dell'utente

UserIdentifier (API Google Ads) UserIdentifier (API Data Manager)
address_info address Segui le linee guida sulla formattazione e sull'hashing. Puoi anche criptare gli attributi sottoposti ad hashing di un indirizzo.
hashed_email email_address Imposta l'indirizzo email formattato e sottoposto ad hashing. Puoi anche criptare l'indirizzo email sottoposto ad hashing.
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.
Altri campi:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
Non pertinente Nessuna delle due API supporta questi identificatori per le conversioni offline o le conversioni avanzate per i lead e l'API Data Manager non supporta questi identificatori quando invia eventi di conversione come origine dati aggiuntiva.

Campi di risposta

UploadClickConversionResponse (API Google Ads) IngestEventsResponse (API Data Manager) Note
job_id Nessun equivalente Utilizza request_id restituito nella risposta per recuperare la diagnostica.
partial_failure_error Nessun equivalente L'API Data Manager non supporta l'errore parziale. Se la convalida di un campo di IngestEventsRequest non va a buon fine, l'API Data Manager rifiuta l'intera richiesta.
request-id intestazione della risposta request_id L'ID richiesta viene restituito come campo di risposta nell'API Data Manager anziché come intestazione di risposta.
results Nessun equivalente L'API Data Manager elabora gli eventi in modo asincrono. Controlla i risultati dell'elaborazione utilizzando la diagnostica.