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.
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 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 valore request_id restituito nella risposta per recuperare la diagnostica.
partial_failure
Nessun equivalente
L'API Data Manager utilizza un modello di errore fast-fail. Se un campo di un IngestEventsRequest non supera la convalida, l'API Data Manager rifiuta l'intera richiesta.
Campi relativi ai clienti e alle azioni di conversione
Nell'API Google Ads, imposti le intestazioni della richiestalogin-customer-id e linked-customer-id per diversi scenari di autenticazione.
Nell'API Data Manager, specifichi i dati del cliente collegato e di accesso 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:
L'API Data Manager non utilizza token sviluppatore. Inoltre, l'API Google Ads non li richiede più.
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 a 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
Impostato sull'ID numerico dell'azione di conversione. Non utilizzare il nome della risorsa ConversionAction.
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.
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é su un nome di risorsa.
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 quando invia eventi di conversione come origine dati aggiuntiva.
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 fast-fail. Se un campo di un IngestEventsRequest non supera la convalida, l'API Data Manager rifiuta l'intera richiesta.
