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:
- Conversioni multiorigine: conversioni registrate dal tag Google del tuo sito web per un'azione di conversione
WEBSITE. - Conversioni offline e conversioni avanzate per i lead:
Eventi offline caricati in precedenza per un'azione di conversione
UPLOAD_CLICKS.
Come funzionano gli aggiustamenti
All'interno della stessa azione di conversione, Google Ads abbina gli eventi utilizzando
transactionId:
- Se
transactionIdcorrisponde a una conversione esistente per la stessa azione di conversione, l'API Data Manager considera la richiesta come un aggiustamento della conversione. - Se
transactionIdnon 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
transactionIddell'evento originale. - La stessa destinazione e la stessa azione di conversione dell'evento originale.
- I valori aggiornati per i campi che vuoi modificare.
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 saperne di più sull'invio di richieste di importazione, consulta Inviare eventi.
Campi supportati
La tabella seguente elenca i campi che puoi modificare e la modalità di applicazione degli aggiornamenti:
| 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 |
Ignorato |
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 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
ignora questi campi e mantiene i valori registrati con l'evento originale.
Eventi non corrispondenti
Se transactionId non corrisponde a un evento esistente, la richiesta viene trattata
come caricamento di una nuova conversione anziché come correzione.
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.