Aggiustamenti delle conversioni

Utilizza il metodo IngestEvents per apportare aggiustamenti alle conversioni Google Ads registrate in precedenza. Nell'API Data Manager, un aggiustamento può ridefinire un valore di conversione o integrare i dati utente.

Se esegui la migrazione dall'API Google Ads, consulta Eseguire l'upgrade dall'API Google Ads per confrontare il modo in cui vengono gestiti gli aggiustamenti in ogni API.

Tipi di conversione supportati

Puoi modificare i seguenti tipi di conversione Google Ads:

Come funzionano gli aggiustamenti

All'interno della stessa azione di conversione, Google Ads abbina gli eventi utilizzando transactionId:

  • Se transactionId corrisponde a una conversione esistente per la stessa azione di conversione, l'API Data Manager considera la richiesta come un aggiustamento della conversione.
  • Se transactionId non corrisponde a una conversione esistente, Google Ads crea una nuova conversione. Vedi Eventi non corrispondenti.

Inviare un aggiustamento

Per modificare una conversione esistente, invia una richiesta IngestEvents che includa:

  • Lo stesso transactionId dell'evento originale.
  • La stessa destinazione e la stessa azione di conversione dell'evento originale.
  • I valori aggiornati per i campi che vuoi modificare.
  • Tutti i campi richiesti per un evento, incluso almeno un identificatore, come adIdentifiers o userData. Consulta i requisiti relativi a eventi e identificatori per le conversioni offline o le conversioni multicanale.

Ti consigliamo di inviare gli stessi identificatori che hai inviato o acquisito con l'evento originale. Se transactionId non corrisponde a una conversione esistente, Google Ads utilizza questi identificatori per attribuire la nuova conversione.

Non è necessario specificare un tipo di aggiustamento. L'API Data Manager deduce come elaborare la richiesta in base a transactionId e ai campi che fornisci.

Per ulteriori informazioni sull'invio di richieste di importazione, consulta le guide all'invio di eventi per le conversioni offline o conversioni multicanale.

Campi supportati

La seguente tabella elenca il modo in cui Google Ads applica ogni campo quando un evento corrisponde a una conversione esistente:

Campo Comportamento
conversionValue, currency Sovrascritta. Il nuovo valore sostituisce quello registrato.
userData Integrato se l'evento originale non aveva dati utente, altrimenti ignorato.
Tutti gli altri campi, ad esempio adIdentifiers.gclid Non aggiornato. Google Ads conserva i valori registrati con l'evento originale. I campi obbligatori devono comunque essere presenti.

Valori di conversione

Invia un nuovo conversionValue e currency per ridefinire il valore di una conversione registrata. Il nuovo valore sostituisce quello registrato in precedenza nei report e nelle offerte, senza incrementare il conteggio delle conversioni.

Dati utente

Ecco come Google Ads gestisce i userData, ad esempio un indirizzo email o un numero di telefono:

  • Integrazione in caso di dati mancanti:se l'evento originale è stato acquisito senza dati utente, l'aggiustamento allega i dati utente per migliorare l'attribuzione.

  • Ignorato se presente:se il tag Google o un caricamento precedente ha già acquisito i dati utente, i nuovi dati utente vengono ignorati. I dati utente esistenti non vengono sovrascritti o aggiunti.

Altri campi

Gli identificatori e i metadati diversi da valore di conversione, valuta e dati utente, come adIdentifiers.gclid, non possono essere aggiornati per gli eventi corrispondenti. Google Ads conserva i valori registrati con l'evento originale.

Devi comunque includere tutti i campi obbligatori, ad esempio almeno un identificatore. L'API Data Manager li convalida per ogni evento.

Eventi non corrispondenti

Se transactionId non corrisponde a un evento esistente, la richiesta viene trattata come caricamento di una nuova conversione anziché come aggiustamento.

Google Ads tenta di attribuire la nuova conversione a un clic sull'annuncio utilizzando gli identificatori che hai fornito, ad esempio adIdentifiers.gclid o userData.