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, per massimizzare gli indicatori di interazione con l'annuncio e rafforzare i dati e il rendimento complessivo	Supportati.	Non supportato.
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 esclusivamente ai casi d'uso di Google Ads e varia in base al caso d'uso.
Crittografia	Supporta la crittografia.	Non supportato.
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, l'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 iniziali delle conversioni e i successivi aggiustamenti delle conversioni in un unico metodo.

Nell'API Google Ads:

• Per aggiustare le conversioni, devi utilizzare il metodo UploadConversionAdjustments separato nella ConversionAdjustmentUploadService.
• Se provi a 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.