Eseguire l'upgrade dall'API Google Ads

Esegui l'upgrade dei caricamenti delle conversioni dall'API Google Ads all'API Data Manager per accedere a diversi miglioramenti e funzionalità.

Ecco un confronto tra l'utilizzo dell'API Data Manager e dell'API Google Ads per gestire le conversioni.

	API Data Manager	API Google Ads
Supporto per l'invio di conversioni offline e conversioni avanzate per i lead	Supportati.	Supportati.
Supporto per l'invio delle conversioni del tag Google Ads come origine dati aggiuntiva per le conversioni del tag, al fine di massimizzare gli indicatori di interazione con l'annuncio e rafforzare i dati e il rendimento complessivo	Supportati.	Non supportati.
Modello dei dati	Modello di dati unificato per tutti i casi d'uso delle conversioni degli annunci Google Ads e tutti i prodotti pubblicitari di Google.	Il modello dei dati è destinato solo ai casi d'uso di Google Ads e varia in base al caso d'uso.
Crittografia	Supporta la crittografia.	Non supportati.
Token sviluppatore	Non necessario.	Obbligatorio.
Supporto per il caricamento di attributi della sessione e indirizzi IP per gli eventi	Disponibile per tutti gli utenti dell'API.	Disponibile solo per utenti API specifici.
Aggiustamenti delle conversioni	Supportato nel metodo unificato IngestEvents.	Richiede l'autorizzazione ConversionAdjustmentUploadService separata.
Quote e limiti	Quote basate sui progetti e limiti per richiesta.	Quote basate su token sviluppatore e limiti per richiesta.
Modello di errore	Utilizza un modello di fail-fast.	Utilizza un modello di errore parziale.

Differenza nei requisiti dell'account di destinazione

Nell'API Data Manager, il operating_account della destinazione deve essere il cliente di conversione Google Ads. Questo è diverso dall'API Google Ads.

Termine chiave: il cliente di conversione Google Ads è l'account Google Ads proprietario dell'azione di conversione identificata dal product_destination_id della destinazione.

L'API Google Ads supporta l'invio di conversioni per un account Google Ads utilizzando customer_id di:

1. Il cliente di conversione Google Ads.

   L'API Data Manager supporta questo approccio.

2. Qualsiasi account principale o secondario del cliente di conversione Google Ads.

   L'API Data Manager non supporta questo approccio. Se utilizzi questo comportamento nell'API Google Ads, modifica il operating_account di ogni destinazione in modo che corrisponda al proprietario dell'azione di conversione. Questo valore potrebbe essere diverso dal customer_id che utilizzi nelle richieste API Google Ads.

Aggiustamenti delle conversioni

L'API Data Manager unifica i caricamenti delle conversioni iniziali e i successivi aggiustamenti delle conversioni in un unico metodo.

Nell'API Google Ads:

• Per aggiustare le conversioni, è necessario utilizzare il metodo UploadConversionAdjustments separato in ConversionAdjustmentUploadService.
• Se tenti di caricare più conversioni utilizzando il metodo standard UploadClickConversions per la stessa azione di conversione con lo stesso ID transazione (order_id), la richiesta non andrà a buon fine.
• Devi specificare ConversionAdjustmentType nella richiesta.

Nell'API Data Manager:

• I caricamenti e gli aggiustamenti delle conversioni utilizzano l'endpoint unificato IngestEvents.
• Il caricamento di un evento con un transaction_id esistente per la stessa azione di conversione con valori di conversione o dati utente aggiornati viene gestito automaticamente come aggiustamento. L'API non restituirà un errore di ID transazione duplicato.
• Nella richiesta non è richiesto alcun tipo di aggiustamento. L'API Data Manager deduce come elaborare l'aggiustamento in base ai campi forniti nell'evento.
• A differenza dell'API Google Ads, l'API Data Manager non supporta i ritiri delle conversioni, che rimuovono completamente una conversione registrata in precedenza impostando il valore e il conteggio delle conversioni su 0. Puoi ridefinire il valore di una conversione, ma il conteggio delle conversioni rimarrà invariato.

Per maggiori dettagli, consulta Aggiustamenti delle conversioni.