API de conversion

1. Pourquoi passer par le serveur ?

Un pixel dans le navigateur doit surmonter trois obstacles pour signaler une conversion : un bloqueur de publicités, un réglage de protection contre le suivi et la fermeture de l’onglet avant son déclenchement. Un appel côté serveur échappe aux trois, puisqu’il n’a pas lieu dans le navigateur.

MousePlayer sait déjà quand l’un de vos objectifs a été atteint : c’est leur raison d’être. Les API de conversion transmettent simplement cette information au réseau publicitaire depuis notre serveur.

2. Ce que nous envoyons, et ce que nous n’envoyons jamais

Le seul élément qui identifie le visiteur dans ces appels est le cookie ou l’identifiant de clic défini par le réseau lui-même. Aucune autre donnée sur la personne ne quitte notre serveur.

Réseau	Identifiant utilisé	Origine
Meta	_fbp, _fbc	Cookies propriétaires définis par le pixel Meta
LinkedIn	li_fat_id	Cookie propriétaire défini par le LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp est un cookie, ttclid provient de l’URL du clic publicitaire
Google Ads	gclid, wbraid, gbraid	Depuis l’URL du clic publicitaire, ou ensuite depuis le cookie _gcl_aw par la suite
Microsoft Advertising	msclkid	Depuis l’URL du clic publicitaire, ou depuis le cookie _uetmsclkid défini par la balise UET

Uniquement avec consentement

Chacun de ces appels est soumis au même contrôle de consentement que l’enregistrement. Une session sans consentement ne produit aucun signalement de conversion, quel que soit l’état du commutateur dans les paramètres du projet.

3. Google Ads utilise trois identifiants, pas un seul

Cela surprend souvent, autant le préciser. Google utilise gclid pour un clic publicitaire individuel. Lorsque la protection contre le suivi d’Apple empêche d’attribuer un clic individuel, Google envoie wbraid ou gbraid à la place, qui représentent un groupe de clics.

Les trois s’excluent mutuellement : Google refuse une conversion qui en contient deux. Nous en envoyons exactement un, et gclid a priorité lorsque plusieurs sont présents, car il est le plus précis.

Ils n’apparaissent qu’une fois dans l’URL

L’identifiant ne figure dans l’adresse que sur la première page après le clic publicitaire. La balise Google le stocke ensuite dans le cookie _gcl_aw . Nous lisons ce cookie en solution de repli : sans lui, une conversion sur la troisième page de la visite ne trouverait plus aucun identifiant.

4. Configuration

Meta, LinkedIn et TikTok

Deux champs chacun : l’identifiant du pixel ou de la règle de conversion, et un jeton d’accès créé dans l’interface du réseau. Les deux sont stockés sous forme chiffrée avec AES-256-GCM et ne sont plus affichés après l’enregistrement.

Google Ads en exige six

Google fait exception, et mieux vaut comprendre pourquoi avant de commencer : contrairement aux trois autres, Google ne délivre pas de simple jeton d’accès. L’accès passe par OAuth avec un jeton d’actualisation, et l’Ads API exige en plus un jeton de développeur.

Champ	Où le trouver
Identifiant client	En haut à droite dans Google Ads. Uniquement les chiffres, sans les tirets.
Identifiant de l’action de conversion	Objectifs et conversions, puis l’action à laquelle vous souhaitez attribuer la conversion.
Jeton de développeur	Dans votre compte administrateur Google Ads, Centre API.
Identifiant client et secret OAuth	Google Cloud Console, Identifiants, client OAuth de type « Application de bureau ».
Jeton d’actualisation	Vous le générez vous-même une fois pour la portée adwords.

LinkedIn propose deux voies ; choisissez la plus courte

Dans Campaign Manager : Données, Gestionnaire de signaux, API directe, Générer un jeton d’accès. C’est la voie destinée aux annonceurs qui envoient leurs propres données : aucune application développeur ni validation. Le jeton n’expire pas, et Campaign Manager ne l’affichera pas une seconde fois ; copiez-le immédiatement.

L’autre voie, une application développeur demandée via le portail développeurs LinkedIn, s’adresse aux plateformes qui envoient des données pour de nombreux annonceurs. Elle exige la vérification de la page de l’entreprise et l’approbation d’un cas d’usage ; rien de tout cela n’est nécessaire ici.

Microsoft Advertising est le plus simple

Après Google Ads, vous vous attendez aux mêmes démarches : OAuth, jeton de développeur, validation. C’est l’inverse : deux champs. L’identifiant de la balise UET que vous utilisez déjà dans le navigateur et un jeton à copier dans Microsoft Advertising, sous la balise UET, « Utiliser l’API de conversion », « Copier le jeton ». Aucune demande à déposer.

Utilisez le même identifiant que celui de votre balise dans le navigateur. C’est ce qui permet à Microsoft de reconnaître l’événement côté serveur et celui du navigateur comme une seule conversion plutôt que deux.

5. Quand une conversion est signalée

Exactement une fois par objectif et par session. MousePlayer élimine les doublons avant l’envoi de l’appel, et les données transmises contiennent aussi un identifiant permettant au réseau de refaire cette vérification. Un visiteur qui ajoute cinq articles au panier produit une conversion, pas cinq.

Ce que vous verrez dans votre compte publicitaire

La conversion contient le nom de votre objectif, sa valeur et sa devise si vous les avez définies, ainsi que l’heure à laquelle elle a eu lieu. En fonctionnement normal, elle arrive en moins d’une minute.

Si rien n’arrive

• Aucun identifiant de clic. Le visiteur n’est pas arrivé par une publicité de ce réseau, ou est arrivé avant que le pixel ait défini son cookie. Rien n’est envoyé : c’est le comportement prévu, pas une erreur.
• Aucun consentement. Le contrôle de consentement est intervenu en premier.
• Le réseau a accepté l’appel, mais refusé la conversion. Google, TikTok et plusieurs autres répondent avec HTTP 200 et une erreur dans le corps de la réponse. Nous lisons ce corps, pas seulement le statut, et la raison apparaît dans le journal de livraison.