Mappature di campi

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

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.

Campi di 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 i campi relativi ai clienti e alle azioni 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: imposta l'elemento 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 valore request_id restituito nella risposta per recuperare la diagnostica.
partial_failure Nessun equivalente L'API Data Manager utilizza un modello di errore con interruzione rapida. Se un campo di un IngestEventsRequest non supera la convalida, 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 delle azioni di conversione e dei clienti

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 i diversi scenari di autenticazione.

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.

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 di conversione Google Ads. Questo potrebbe essere diverso dal customer_id nella richiesta API Google Ads. 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.
conversion_action di ClickConversion product_destination_id Imposta l'ID numerico dell'azione di conversione. Non utilizzare il nome della risorsa 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, consulta 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 valore reference corrispondente della destinazione.
conversion_date_time event_timestamp
Per maggiori dettagli, consulta Formato del 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 user_properties.customer_type Impostato su un valore nell'enum CustomerType.
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, consulta Aggiungi attributi della sessione.
session_attributes_key_value_pairs experimental_fields Per maggiori dettagli, consulta Aggiungi attributi della sessione.
user_identifiers user_data.user_identifiers Per maggiori dettagli, consulta 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 Impostalo sull'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 ogni azione di conversione. L'API Data Manager supporta l'invio di conversioni per più azioni di conversione in una singola richiesta, nonché l'utilizzo di questo campo destination_references per indicare quali destinazioni devono ricevere una variabile personalizzata specifica.
conversion_custom_variable variable Impostato sul nome della variabile anziché sul nome di una 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 con hash 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 Imposta il 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, mentre l'API Data Manager non li supporta per l'invio di eventi di conversione come origine dati aggiuntiva.

Campi di risposta

UploadClickConversionResponse (API Google Ads) IngestEventsResponse (API Data Manager) Note
job_id Nessun equivalente Utilizza il valore request_id restituito nella risposta per recuperare la diagnostica.
partial_failure_error Nessun equivalente L'API Data Manager utilizza un modello di errore con interruzione rapida. Se un campo di un IngestEventsRequest non supera la convalida, 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 della risposta.
results Nessun equivalente L'API Data Manager elabora gli eventi in modo asincrono. Controlla i risultati dell'elaborazione utilizzando la diagnostica.