Mettre à niveau l'API Google Ads

Migrez vos importations de conversions de l'API Google Ads vers l'API Data Manager pour accéder à plusieurs améliorations et fonctionnalités.

Voici une comparaison entre l'utilisation de l'API Data Manager et de l'API Google Ads pour gérer les conversions.

	API Data Manager	API Google Ads
Compatibilité avec l'envoi de conversions hors connexion et le suivi avancé des conversions pour les prospects	Compatible.	Compatible.
Possibilité d'envoyer les conversions de balise Google Ads en tant que source de données supplémentaire pour vos conversions de balise, afin de maximiser les signaux d'interaction avec les annonces et d'améliorer vos données et vos performances globales	Compatible.	Non compatible.
Modèle de données	Modèle de données unifié pour tous les cas d'utilisation des conversions Google Ads et tous les produits publicitaires Google.	Le modèle de données n'est destiné qu'aux cas d'utilisation Google Ads et diffère pour chaque cas d'utilisation.
Chiffrement	Compatible avec le chiffrement.	Non compatible.
Jeton de développeur	Facultatif.	Obligatoire.
Possibilité d'importer des attributs de session et des adresses IP pour les événements	Disponible pour tous les utilisateurs de l'API.	Disponible uniquement pour certains utilisateurs de l'API.
Ajustements des conversions	Compatible avec la méthode unifiée IngestEvents.	Nécessite l'option ConversionAdjustmentUploadService distincte.
Quotas et limites	Quotas par projet et limites par requête.	Quotas basés sur les jetons de développeur et limites par requête
Modèle d'erreur	Utilise un modèle d'échec rapide.	Utilise un modèle d'échec partiel.

Différence entre les exigences des comptes de destination

Dans l'API Data Manager, le operating_account de la destination doit être le client de conversion Google Ads. Ce n'est pas le cas avec l'API Google Ads.

Terme clé : Le client de conversion Google Ads est le compte Google Ads propriétaire de l'action de conversion identifiée par le product_destination_id de la destination.

L'API Google Ads permet d'envoyer des conversions pour un compte Google Ads à l'aide de l'élément customer_id de l'un des éléments suivants :

1. Le client de conversion Google Ads.

   L'API Data Manager est compatible avec cette approche.

2. Tout compte parent ou descendant du client de conversion Google Ads.

   L'API Data Manager n'est pas compatible avec cette approche. Si vous utilisez ce comportement dans l'API Google Ads, remplacez le operating_account de chaque destination par le propriétaire de l'action de conversion. Il peut être différent de l'customer_id que vous utilisez dans vos requêtes API Google Ads.

Ajustements des conversions

L'API Data Manager unifie les importations de conversions initiales et les ajustements de conversion ultérieurs en une seule méthode.

Dans l'API Google Ads :

• Pour ajuster les conversions, vous devez utiliser la méthode UploadConversionAdjustments distincte dans ConversionAdjustmentUploadService.
• Si vous essayez d'importer plusieurs conversions à l'aide de la méthode UploadClickConversions standard pour la même action de conversion avec le même ID de transaction (order_id), la requête échouera.
• Vous devez spécifier ConversionAdjustmentType dans la requête.

Dans l'API Data Manager :

• Les importations et les ajustements de conversions utilisent le point de terminaison unifié IngestEvents.
• L'importation d'un événement avec un transaction_id existant pour la même action de conversion avec des valeurs de conversion ou des données utilisateur mises à jour est automatiquement traitée comme un ajustement. L'API ne renverra pas d'erreur d'ID de transaction en double.
• Aucun type d'ajustement n'est requis dans la requête. L'API Data Manager déduit comment traiter l'ajustement en fonction des champs fournis dans l'événement.
• Contrairement à l'API Google Ads, l'API Data Manager n'accepte pas les retraits de conversion, qui suppriment complètement une conversion précédemment enregistrée en définissant sa valeur et son nombre de conversions sur 0. Vous pouvez reformuler la valeur d'une conversion, mais le nombre de conversions restera le même.

Pour en savoir plus, consultez Ajustements des conversions.