Intégration de l’API de conversions Google Ads (CAPI)

Renvoyez à Google Ads les conversions générées par vos partenaires sous forme de conversions hors ligne, associées au clic d’origine sur l’annonce : Smart Bidding optimise alors sur de vraies ventes, et non sur des visites de page de destination.

Présentation

Lorsqu’un internaute clique sur une annonce Google, Google ajoute un identifiant de clic (GCLID) à l’URL de destination, et AffClix l’enregistre avec le clic. Lorsque ce clic aboutit plus tard à une conversion — une vente, un lead, une inscription — et que la conversion est approuvée, AffClix l’importe dans Google Ads avec ce même GCLID, via l’importation de conversions hors ligne de Google.

La configuration se fait une fois par action de conversion : vous connectez votre compte Google, choisissez le compte Ads et l’action de conversion dans une liste, puis les objectifs à envoyer. Aucun code à installer sur le site de l’annonceur, aucun identifiant OAuth ni jeton de développeur à créer.

Pourquoi cette intégration est importante

  • Des enchères fondées sur de vrais résultats : Smart Bidding (Maximiser les conversions, CPA cible, ROAS cible) apprend des ventes conclues par vos partenaires, pas des clics.
  • Des conversions invisibles pour une balise navigateur : les ventes confirmées plus tard, hors ligne ou sur un autre appareil parviennent quand même à Google.
  • Insensible aux bloqueurs et aux limites de cookies : l’envoi se fait de serveur à serveur, donc ni ITP, ni les bannières de consentement, ni les bloqueurs ne peuvent le perdre.
  • Uniquement les conversions approuvées : les conversions en attente, refusées ou réduites ne sont jamais transmises, Google optimise donc sur le chiffre d’affaires que vous conservez.
  • De vraies valeurs de revenu : chaque envoi contient le montant de la vente et sa devise, pour un ROAS cible calculé sur des chiffres réels.
  • Aucun doublon : chaque conversion est envoyée une seule fois par destination et, si un ID de commande est présent, Google peut écarter toute répétition.
  • Une traçabilité complète : chaque tentative est enregistrée avec la réponse de Google dans le rapport CAPI Delivery.

Prérequis

  • Un forfait AffClix incluant Conversions API. Si Integrations → Conversions API n’apparaît pas dans votre menu, votre forfait ne l’inclut pas.
  • Un compte Google disposant au moins d’un accès Standard au compte Google Ads qui diffuse les annonces.
  • Le marquage automatique activé dans ce compte Google Ads, afin que chaque clic sur une annonce porte un GCLID.
  • Une action de conversion hors ligne de type Track conversions from clicks (suivi des conversions issues de clics) — voir l’étape 1.
  • Un trafic Google Ads qui atteint l’annonceur via un lien de suivi AffClix, pour qu’AffClix enregistre le clic et son GCLID.
  • Des conversions de ce trafic qui arrivent dans AffClix par postback, pixel ou intégration e-commerce, et qui sont approuvées.

Regarder la démonstration

Une démonstration de deux minutes de la configuration, enregistrée dans le tableau de bord AffClix.

Étape 1 : Créez une action de conversion hors ligne dans Google Ads

Google n’accepte les conversions hors ligne que pour une action de conversion créée pour les recevoir. Les autres types — balises de site web, application, appels — n’apparaissent pas dans la liste AffClix.

01

Ouvrez les actions de conversion

Connectez-vous à Google Ads, allez dans Goals → Summary (Objectifs → Récapitulatif) et cliquez sur + Create conversion action.

02

Choisissez une importation hors ligne

Sélectionnez Conversions offline → Import → CRMs, files, or other data sources → Track conversions from clicks, puis continuez. Si Google propose de connecter une source de données, choisissez de le faire plus tard : AffClix importe via l’API.

03

Définissez la catégorie, le nom et la valeur

Choisissez la catégorie correspondant à l’événement, par exemple Purchase (Achat) ou Submit lead form (Envoi de formulaire pour prospects), et un nom que vous reconnaîtrez dans AffClix, comme AffClix – Vente. Sélectionnez Use different values for each conversion pour enregistrer le montant réel de la vente.

04

Choisissez le mode de comptabilisation

Utilisez Every (Toutes) pour les achats et One (Une) pour les leads et inscriptions, puis enregistrez.

05

Répétez pour chaque événement suivi séparément

Créez une action de conversion par événement que vous voulez voir dans sa propre colonne Google Ads — par exemple une pour les ventes et une pour les leads.

06

Vérifiez le marquage automatique

Allez dans Admin → Account settings → Auto-tagging et vérifiez qu’il est activé. Sans lui, les clics ne portent pas de GCLID et rien ne peut être associé.

Laissez quelques heures à une nouvelle action de conversion

Google peut mettre quelques heures avant d’accepter les importations sur une action de conversion nouvellement créée. Les conversions envoyées pendant ce délai sont refusées et apparaissent en échec dans le rapport CAPI Delivery.

Étape 2 : Connectez Google Ads dans AffClix

01

Ouvrez Conversions API

Dans le tableau de bord AffClix, allez dans Integrations → Conversions API et cliquez sur Add destination.

La page Conversions API d’AffClix listant les destinations de conversion avec plateforme, nom, portée et statut.
Integrations → Conversions API liste chaque destination avec sa portée et son statut.
02

Choisissez Google Ads

Sélectionnez la vignette Google Ads. Le formulaire qui suit est conçu pour la plateforme choisie ; Change platform vous ramène aux vignettes.

Le sélecteur de plateforme du formulaire de nouvelle destination, avec les vignettes Meta, TikTok et Google Ads.
Choisissez d’abord la plateforme ; le formulaire s’adapte à elle.
03

Nommez la destination et définissez sa portée

Donnez-lui un nom comme Google Ads – Ventes. Laissez Campaign ID vide pour envoyer les conversions de toutes les campagnes, ou saisissez l’ID d’une campagne pour n’envoyer que les siennes. API version et Timeout peuvent garder leurs valeurs par défaut.

04

Connectez Google Ads

Cliquez sur Connect Google Ads et connectez-vous avec le compte Google qui a accès au compte Ads. Google affiche l’accès demandé par AffClix — vos données Google Ads, qu’AffClix utilise uniquement pour lister vos comptes et actions de conversion et pour importer les conversions. Acceptez et vous revenez au formulaire. AffClix ne voit jamais votre mot de passe Google.

La carte d’identifiants Google Ads avec l’indicateur en trois étapes, la liste « Set up in Google Ads first » et le bouton Connect Google Ads.
Avant la connexion, la carte indique ce qui doit déjà exister dans Google Ads.
05

Choisissez le compte et l’action de conversion

Sélectionnez le Google Ads account, puis la Conversion action créée à l’étape 1. L’indicateur d’étapes en haut de la carte passe au vert à mesure que chaque étape est terminée.

Vous utilisez un compte administrateur (MCC) ?

Connectez-vous avec l’accès administrateur. Les comptes qu’il gère sont listés et peuvent être choisis ; le compte administrateur lui-même est affiché mais ne peut pas être choisi, car les conversions appartiennent au compte qui a diffusé les annonces. AffClix envoie automatiquement l’ID administrateur avec chaque importation.

Étape 3 : Choisissez les objectifs à envoyer

Chaque destination importe dans une seule action de conversion Google. La table de correspondance des événements détermine lesquels de vos objectifs AffClix lui sont envoyés.

01

Associez les objectifs

Dans Event Mapping & Matching, choisissez un objectif sous Your goal — la liste affiche les objectifs actifs de votre espace de travail ; tapez pour rechercher — et saisissez un libellé sous Platform event, par exemple Purchase. Pour Google, ce libellé sert uniquement de repère : Google enregistre l’action de conversion choisie à l’étape 2.

La carte Event Mapping & Matching avec un objectif associé à un événement de plateforme et les options de clés de correspondance.
Associez des objectifs à la destination et choisissez les signaux d’identité partagés.
02

Tout envoyer ou seulement certains objectifs

La correspondance par défaut, *, envoie toutes les conversions approuvées. Pour n’envoyer que les ventes, remplacez-la par une seule ligne pour votre objectif de vente. Un objectif sans ligne dédiée, et sans ligne *, n’est pas envoyé.

03

Gardez Click IDs sélectionné

Sous Match keys to send, laissez toutes les clés décochées — tous les signaux disponibles sont alors envoyés — ou vérifiez que Click IDs est coché. Google associe uniquement sur l’identifiant de clic.

Décocher Click IDs bloque tous les envois vers Google

Si vous cochez d’autres clés de correspondance mais pas Click IDs, le GCLID n’est pas transmis et toutes les conversions de cette destination échouent avec « no click identifier ».

Suivez ventes et leads séparément

Créez une deuxième destination pointant vers votre action de conversion « lead », avec une correspondance pour l’objectif lead uniquement. Les destinations sont indépendantes : un même compte Google Ads peut recevoir plusieurs actions de conversion.

Étape 4 : Enregistrez et testez

01

Enregistrez

Vérifiez que Active est activé et cliquez sur Create destination.

02

Envoyez un test

Dans la liste Conversions API, cliquez sur Send test event pour la destination. Pour Google, cela confirme qu’AffClix peut s’authentifier sur votre compte Ads. Google n’offre pas de mode test pour les importations hors ligne : la première conversion réelle reste la preuve définitive.

03

Vérifiez la première importation réelle

Après la prochaine conversion approuvée issue d’un clic Google, ouvrez Reports → Delivery Logs → CAPI Delivery et cherchez une ligne Delivered. Dans Google Ads, la conversion apparaît sous l’action de conversion, généralement en quelques heures ; comptez jusqu’à un jour pour la mise à jour des colonnes de campagne.

Exemple concret

Un distributeur d’électronique diffuse des annonces Google sur le Réseau de Recherche qui dirigent les acheteurs vers sa boutique via un lien de suivi AffClix. Il configure une destination, « Google Ads – Ventes », associée à son objectif de vente.

  1. Un acheteur clique sur l’annonce. Google ajoute gclid=Cj0KCQ… à l’URL et AffClix l’enregistre avec le clic.
  2. Deux jours plus tard, l’acheteur achète un ordinateur portable à 24 999 ₹. Le postback de la boutique enregistre la vente dans AffClix, en attente de validation.
  3. L’annonceur approuve la vente. AffClix l’importe aussitôt dans Google Ads avec le GCLID, la valeur 24 999 et la devise INR.
  4. Google attribue l’achat au clic d’origine sur l’annonce, et le ROAS cible enchérit désormais sur cette recherche en s’appuyant sur la valeur réelle de la vente.

Résultat : Google Ads rapporte les ventes réellement conservées par le distributeur — les retours et commandes refusées ne sont jamais envoyés — et les enchères progressent sur les recherches qui génèrent du chiffre d’affaires.

Gérer et surveiller l’intégration

  • Mettre en pause sans supprimer : utilisez l’interrupteur de la ligne de destination, ou désactivez Active dans le formulaire.
  • Modifier ce qui est envoyé : modifiez la destination à tout moment ; la nouvelle correspondance s’applique aux conversions approuvées à partir de ce moment.
  • Alertes d’identifiants : AffClix vérifie chaque destination toutes les heures. Si Google commence à refuser les envois parce que l’accès a été retiré ou révoqué, la ligne affiche Reconnect credentials et le propriétaire de l’espace de travail reçoit un e-mail.
  • Reconnecter : ouvrez la destination et cliquez sur Reconnect Google Ads. Le compte, l’action de conversion et la correspondance sont conservés.
  • Statut CAPI de chaque conversion : dès qu’une destination existe, le rapport de conversions affiche une colonne CAPI indiquant Delivered, Failed ou Partial.

Journaux CAPI Delivery

Chaque tentative d’envoi est enregistrée dans Reports → Delivery Logs → CAPI Delivery. Filtrez par date, plateforme, destination et statut.

Le rapport CAPI Delivery listant les tentatives d’envoi avec plateforme, événement, statut et code de réponse.
Reports → Delivery Logs → CAPI Delivery enregistre chaque tentative.
ColonneCe qu’elle indique
Platform / EventLa destination et le libellé d’événement envoyé.
StatusDelivered, ou Failed avec le motif.
Response codeLe code de statut HTTP renvoyé par Google.
Attempts / RetryableLe nombre de tentatives, et si l’échec était temporaire — limites de débit, erreurs Google, réseau — et sera retenté.
ErrorLe message de Google pour un envoi en échec.

Dépannage

SymptômeCause probableQue faire
La liste des comptes est videLe compte Google utilisé n’a accès à aucun compte Google Ads.Reconnectez-vous avec un compte Google disposant au moins d’un accès Standard, ou demandez au propriétaire du compte de l’inviter.
La liste des actions de conversion est videLe compte n’a aucune action de conversion « Track conversions from clicks ».Créez-en une (étape 1), puis rouvrez la destination.
Failed: no click identifierLe clic n’avait pas de GCLID : marquage automatique désactivé, trafic ne provenant pas de Google Ads, ou Click IDs non coché dans les clés de correspondance.Activez le marquage automatique, vérifiez que l’annonce fait passer le trafic par le lien de suivi AffClix et cochez Click IDs.
Failed : action de conversion introuvable ou désactivéeL’action a été supprimée, ou elle vient tout juste d’être créée.Vérifiez qu’elle est activée dans Google Ads ; attendez quelques heures après sa création.
La ligne affiche Reconnect credentialsL’accès a été révoqué, ou l’utilisateur Google a perdu l’accès au compte Ads.Ouvrez la destination et cliquez sur Reconnect Google Ads.
Les conversions sont dans AffClix mais pas dans GoogleElles ne sont pas encore approuvées, ou le clic est antérieur à la fenêtre de conversion après clic de l’action (90 jours maximum).Approuvez les conversions ; si besoin, allongez la fenêtre dans les paramètres de l’action de conversion.

Avancé : utiliser votre propre projet Google Cloud

Les agences qui gèrent l’accès Google Ads via leur propre projet Google Cloud peuvent ouvrir Advanced — use my own Google Cloud project dans le formulaire et saisir directement l’ID client, l’ID administrateur, l’ID de l’action de conversion, l’ID client OAuth, le code secret client et le jeton d’actualisation. Les secrets sont chiffrés et ne sont plus jamais affichés ; lors d’une modification, laissez un champ secret vide pour conserver la valeur enregistrée. Google n’exige plus de jeton de développeur.

Conclusion

Avec Google Ads connecté, chaque conversion approuvée générée par vos partenaires est importée en lien avec le clic d’origine sur l’annonce : Google Ads rapporte de vraies ventes et Smart Bidding optimise en conséquence. Configurez-la une fois par action de conversion, puis surveillez le rapport CAPI Delivery jusqu’au premier envoi réussi.

Remarque

Seules les conversions approuvées sont envoyées à Google Ads. Les conversions en attente, refusées ou réduites ne sont jamais importées ; une conversion approuvée plus tard est importée au moment de son approbation.

À lire aussi : Présentation de la Conversions API · API Conversions de Meta · Google Ads avec le WebSDK

Rate this article
★★★★★
Thanks for rating!

Was this article helpful?