Mettre à niveau l'API Google Ads

Passez de l'API Google Ads à l'API Data Manager pour importer vos conversions. Vous pourrez ainsi profiter de 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
Assistance pour l'envoi des conversions hors connexion et du suivi avancé des conversions pour les prospects Compatible. Compatible.
Prise en charge de l'envoi des conversions de la 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 de renforcer 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 est réservé aux cas d'utilisation Google Ads et diffère pour chacun d'eux.
Chiffrement Compatible avec le chiffrement. Non compatible.
Jeton de développeur Facultatif. Obligatoire.
Prise en charge de l'importation 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 Prise en charge dans la méthode IngestEvents unifiée. Nécessite l'ConversionAdjustmentUploadService distinct.
Quotas et limites Quotas et limites par requête basés sur les projets. Quotas basés sur le jeton de développeur et limites par requête.
Modèle d'erreur Utilise un modèle d'échec rapide. Utilise un modèle de défaillance partielle.

Différences au niveau des exigences du compte de destination

Dans l'API Data Manager, le operating_account de la destination doit être Google Ads conversion customer. Elle est différente de l'API Google Ads.

L'API Google Ads permet d'envoyer des conversions pour un compte Google Ads à l'aide de l'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 du 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 conversions ultérieurs dans 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 tentez 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.
  • Si vous importez un événement avec un transaction_id existant pour la même action de conversion, mais avec des valeurs de conversion ou des données utilisateur mises à jour, il sera automatiquement traité 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 demande. L'API Data Manager déduit la manière de 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 rétractations de conversions, qui suppriment complètement une conversion enregistrée précédemment 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.

Suivant
Procédure de mise à jour