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 Esegui l'upgrade dall'API Google Ads per confrontare il modo in cui vengono gestiti gli aggiustamenti in ciascuna 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.

Nota: gli aggiustamenti alle conversioni per le vendite in negozio non sono supportati.

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 tratta la richiesta come un aggiustamento della conversione.
• Se il transactionId non corrisponde a una conversione esistente, Google Ads crea una nuova conversione. Consulta la sezione Eventi non corrispondenti.

Invia un aggiustamento

Per aggiustare 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 obbligatori 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 da più origini.

Punto chiave: l'API Data Manager convalida ogni evento quando riceve la richiesta, prima di cercare un transactionId corrispondente. Un aggiustamento deve soddisfare gli stessi requisiti di campo e identificatore di un nuovo evento. In caso contrario, la richiesta non va a buon fine e viene visualizzato un errore, ad esempio NO_IDENTIFIERS_PROVIDED.

Ti consigliamo di inviare gli stessi identificatori che hai inviato o acquisito con l'evento originale. Se il 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 saperne di più sull'invio di richieste di importazione, consulta le guide all'invio di eventi per le conversioni offline o le conversioni da più origini.

Campi supportati

La tabella seguente 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	Integrati se l'evento originale non conteneva dati utente, altrimenti ignorati.
Tutti gli altri campi, come 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 il valore registrato in precedenza nei report e nelle offerte, senza incrementare il conteggio delle conversioni.

Nota: durante il periodo di prova iniziale di 14 giorni per le conversioni multisorgente, gli aggiornamenti del valore sono disattivati. Il valore del tag non verrà sovrascritto nei report di Google Ads fino al termine del periodo di prova.

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.

  Nota: per un rendimento ottimale, ti consigliamo di caricare i dati offline supplementari entro 24 ore dall'evento originale.

• Ignorati se presenti: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 né aggiunti.

Altri campi

Gli identificatori e i metadati diversi dal valore di conversione, dalla valuta e dai 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 il transactionId non corrisponde a un evento esistente, la richiesta viene trattata come un caricamento di una nuova conversione anziché come un 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.

Nota: durante il periodo di prova iniziale di 14 giorni per le conversioni multisorgente, le conversioni appena create vengono visualizzate nei report, ma non vengono utilizzate per le offerte. Al termine del periodo di prova, diventano automaticamente disponibili per le offerte.