API de conversions Microsoft Ads avec UET
Testez l’API de conversions Microsoft Ads avec UET. Huit essais pour vérifier le consentement, les doublons et la valeur avant de piloter les enchères.

Ajoutez l’API de conversions Microsoft Ads à la balise UET si votre serveur peut confirmer un achat que le navigateur observe mal. Commencez par un seul objectif. Les deux voies doivent respecter le choix du visiteur, partager l’identifiant du même achat et transmettre une valeur cohérente. Vérifiez ces trois conditions avant de laisser le nouveau signal piloter les enchères.
Microsoft a annoncé la disponibilité générale de son API de conversions (CAPI) le 28 octobre 2026. Si votre boutique mesure déjà les achats via UET, le premier travail consiste à déterminer ce que l’envoi côté serveur améliorerait. Une page de confirmation rechargée, un paiement validé après la fermeture de l’onglet et un refus de suivi donnent trois réponses différentes. Annonce Microsoft Advertising
Choisir ce que le serveur doit apporter
Universal Event Tracking (UET) est la balise Microsoft Advertising qui observe des actions dans le navigateur. Avec CAPI, le serveur de la boutique ou un connecteur peut transmettre un événement issu du système qui gère la commande. La confirmation côté serveur est utile, par exemple, si un prestataire de paiement répond après que le client a quitté la boutique. Le serveur connaît alors l’état du paiement au moment où il change. Fonctionnement de la balise UET
| Situation | Décision pour le premier pilote |
|---|---|
| La balise mesure déjà un achat confirmé et les écarts sont expliqués. | Gardez UET. Documentez cette référence avant d’ajouter une intégration à maintenir. |
| Le navigateur manque des achats pourtant confirmés par la boutique. | Testez UET et CAPI sur le même achat. Le serveur fournit la confirmation et les deux voies utilisent la même référence d’événement. |
| Le serveur confirme l’achat, mais la balise déclenche trop tôt. | Corrigez le déclenchement ou retirez ce déclencheur navigateur pour l’achat. Vérifiez séparément les autres objectifs qui utilisent UET. |
Un connecteur peut émettre le signal serveur alors qu’un module de boutique ou un gestionnaire de balises émet déjà le même événement. Avant de choisir un outil, demandez une démonstration sur une transaction représentative. L’intégrateur doit pouvoir montrer les deux émissions, les associer à la même commande et désactiver l’une d’elles séparément. Si la définition de la conversion reste floue, commencez par la section mesure du guide de la landing page.
Fixer un contrat d’événement à trois registres
Choisissez une phrase que le marketing et la personne qui gère les commandes interprètent de la même façon. Par exemple, « l’achat existe quand le système de commande enregistre le paiement comme confirmé ». Vérifiez cette règle sur un paiement refusé et sur un paiement dont la confirmation arrive après le retour du client sur la boutique. Un passage sur l’URL de remerciement peut correspondre à plusieurs états de paiement.
| Registre | Preuve à conserver pour l’essai |
|---|---|
| Commande | Référence interne, statut payé, heure de confirmation, devise et montant selon la convention convenue. |
| Transmission | Clé d’événement, voie navigateur ou serveur, état du choix, décision d’émettre ou de bloquer et résultat du traitement. Masquez les données personnelles dans le dossier de recette. |
| Objectif Microsoft Ads | Balise associée, action reconnue, règle de comptage, fenêtre d’attribution et rapport à consulter après traitement. |
Microsoft indique d’utiliser le même identifiant de balise (tagId), le même identifiant d’événement et le même nom d’événement lorsque les deux voies transmettent la même conversion. Le navigateur envoie cet identifiant dans event_id, le serveur dans eventId. Créez la clé à partir d’une référence stable que vos deux chemins peuvent retrouver, sans information personnelle dans sa valeur. Réutilisez-la au rechargement et lors d’une nouvelle tentative d’envoi. Deux achats distincts doivent conserver deux clés, même lorsqu’ils appartiennent au même client. Documentation de la déduplication UET et CAPI
Fixez aussi ce que le montant représente. Si la boutique compte le total TTC avec livraison et que l’équipe acquisition raisonne en chiffre d’affaires hors taxes après remise, le même achat produit deux lectures économiques. Écrivez la convention retenue et testez une remise, puis rapprochez le montant transmis avec la commande. La marge peut rester dans votre reporting interne pour décider du budget.
Vérifier le choix au moment où l’événement part
Pour ce pilote, adoptez une règle simple : aucun achat n’est envoyé à des fins publicitaires sans accord vérifiable. Contrôlez le déclencheur navigateur, la décision du serveur et le connecteur éventuel. Quand le serveur reçoit la confirmation de paiement, il doit pouvoir vérifier l’état applicable. S’il ne peut pas le retrouver, gardez la commande dans le registre métier et bloquez son envoi publicitaire.
Microsoft documente un point qui mérite un test explicite : sans le champ adStorageConsent, CAPI traite par défaut l’état comme accordé. Le code D signale un refus au fournisseur. Pour le pilote décrit ici, faites appliquer le blocage avant l’envoi et vérifiez que le réglage côté navigateur suit la même décision. Le mode de consentement de la balise transmet le choix recueilli. La CNIL rappelle les exigences de recueil préalable pour les traceurs concernés, de refus et de retrait. Faites valider le périmètre du traitement et les données réellement transmises avant d’étendre le dispositif. Signaux de consentement CAPI · Aide Microsoft sur la balise UET · Règles de la CNIL sur les cookies et traceurs
Une reprise après incident mérite sa propre vérification. Supposons que la commande soit payée à 14 h, qu’un incident retarde l’envoi et que le client retire son accord à 14 h 05. À la reprise de la file, l’ancien accord ne suffit plus pour le pilote. La décision de blocage doit rester explicable sans recopier dans les journaux l’adresse e-mail du client, le contenu du panier ou les paramètres complets de sa visite.
Rejouer huit essais avant de modifier les enchères
Faites d’abord les essais techniques dans une configuration isolée des objectifs utilisés pour les enchères. Désignez une personne pour la boutique et une pour le compte publicitaire. Utilisez des commandes de test pour observer les déclenchements et les réponses du serveur. Pour vérifier ensuite l’attribution, examinez un lot borné de transactions légitimes dans le cadre prévu. Les essais techniques et l’attribution répondent à deux questions différentes.
| Essai | Résultat attendu |
|---|---|
| Achat confirmé avec accord | Les deux voies pointent vers le même événement et le même montant. Pour un achat éligible à l’attribution, le rapport de l’objectif ne doit retenir qu’une conversion. |
| Retour sur la confirmation ou répétition serveur | Toute nouvelle tentative conserve la clé. Votre registre d’envoi distingue les tentatives du nombre d’achats. |
| Deux achats distincts | Les références diffèrent. Vérifiez que la règle de comptage choisie permet de distinguer les deux ventes dans la situation observée. |
| Paiement refusé ou en attente | Aucun événement d’achat ne part. Testez ensuite le passage de « en attente » à « payé ». |
| Absence de choix et refus explicite | Rejouez les deux états. La commande aboutit et les deux voies respectent le blocage prévu. |
| Retrait avant reprise | Un événement encore en attente d’envoi reste bloqué. La file documente cette décision sans relancer indéfiniment l’événement. |
| Identifiant d’attribution absent | Le paiement reste dans le total métier. Documentez les données disponibles et l’incertitude d’attribution. |
| Échec de transmission | Un échec temporaire se reprend avec la même clé. Un rejet de validation est isolé pour correction et reste visible dans le bilan du lot. |
Un réglage « unique » peut limiter le comptage à une conversion de l’objectif par clic publicitaire. Il peut donc masquer un problème dans le test de deux achats. Relevez le réglage avant l’essai et choisissez un cas compatible avec l’objectif. Pour les achats, comparez en particulier la règle de comptage avec la définition d’une vente que votre équipe utilise. Documentation Microsoft sur les paramètres d’objectif
Expliquer un écart avant de juger le canal
Lisez les trois registres dans l’ordre. La boutique confirme la vente. La transmission indique si l’événement a été bloqué, accepté ou rejeté. Le rapport d’objectif renseigne ensuite les conversions que Microsoft a pu attribuer dans la configuration observée. Si une requête est acceptée et que le rapport reste vide, examinez la correspondance avec l’objectif, les identifiants autorisés, l’horodatage et la fenêtre d’attribution. Quand les chiffres divergent, alignez aussi fuseau, période et devise avant d’en chercher la cause. Diagnostic des conversions dans Microsoft Advertising
Prenons un exemple fictif. Une boutique observe 12 commandes payées dans son lot de recette. Deux sont exclues de l’envoi publicitaire conformément aux choix enregistrés. Les dix autres produisent neuf émissions navigateur et dix émissions serveur, avec neuf clés partagées. Le registre doit donc retrouver dix achats transmis pour dix clés, même si les deux voies totalisent dix-neuf émissions. Supposons que le rapport n’en attribue que sept à une campagne. Les trois autres restent des ventes de la boutique. L’équipe enquête sur la règle de comptage, la présence d’un clic éligible ou le délai de remontée avant de conclure à une perte de signal.
L’équipe commerciale peut utiliser un objectif différent, comme un devis accepté plusieurs semaines après le formulaire. Définissez alors le changement d’état dans le logiciel de gestion de la relation client (CRM) et traitez ce signal séparément de l’achat web. Le guide sur les conversions hors ligne Google Ads illustre la conception d’un tel flux pour Google. Et si la question devient « la campagne a-t-elle créé des ventes supplémentaires ? », le guide sur l’incrémentalité explique comment poser cette autre mesure.
Décider de conserver, d’élargir ou de suspendre le pilote
Élargissez le pilote quand les huit essais sont documentés, que chaque blocage est respecté et que les écarts observés ont une explication. Désignez la personne qui suit les alertes et notez quel réglage retirer si le nouveau flux produit des doublons ou des montants incohérents. Si un achat test alimente un objectif existant utilisé par les enchères, revoyez l’isolation du pilote avant de continuer. Vérifiez la sélection effective des objectifs au niveau des campagnes concernées. Aide Microsoft sur les stratégies d’enchères
Si le gain observable est faible ou que personne ne peut exploiter les écarts, garder une seule voie reste une décision raisonnable. Si l’équipe trouve un problème avant même la confirmation de commande, élargissez le diagnostic avec la grille d’audit de site. Pour un diagnostic d’acquisition et de visibilité, apportez une commande anonymisée, le nom de l’objectif et les deux traces d’envoi. Ce premier rapprochement permet de choisir le contrôle à renforcer avant d’investir dans un connecteur ou de changer le budget.

