Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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 delle conversioni offline e delle conversioni avanzate per i lead	Supportato.	Supportato.
Supporto per l'invio delle conversioni del tag Google Ads come origine dati aggiuntiva per le conversioni dei tag, per massimizzare gli indicatori di interazione con gli annunci e rafforzare i dati e il rendimento complessivo	Supportato.	Non supportato.
Modello dei dati	Modello di dati unificato per tutti i casi d'uso delle conversioni di Google Ads e per tutti i prodotti pubblicitari Google.	Il modello dei dati è solo per i casi d'uso di Google Ads e varia per ogni caso d'uso.
Crittografia	Supporta la crittografia.	Non supportato.
Token sviluppatore	Non necessario.	Obbligatorio.
Supporto per il caricamento degli attributi di sessione e degli 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 `ConversionAdjustmentUploadService` separato.
Quote e limiti	Quote e limiti per richiesta basati sul progetto.	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.

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

Il cliente di conversione Google Ads.

L'API Data Manager supporta questo approccio.
Qualsiasi account principale o discendente 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 da customer_id che utilizzi nelle richieste dell'API Google Ads.

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

Nell'API Google Ads:

La modifica delle conversioni richiede l'utilizzo del metodo UploadConversionAdjustments separato in ConversionAdjustmentUploadService.
Se tenti di caricare più conversioni utilizzando il metodo UploadClickConversions standard 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 IngestEvents unificato.
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.