Débloquer le volume d'événements avec le token de statistiques

Votre tableau de bord Pixel Insights peut vous indiquer immédiatement la qualité de votre signal de suivi. Pour voir aussi sa quantité (combien d'événements vous avez réellement envoyés, et s'ils sont arrivés par le navigateur, par le serveur, ou seulement par l'un des deux), Facebook demande un second token.

Ce guide vous explique comment l'obtenir. Cela prend une vingtaine de minutes, une seule fois, et rien dans votre configuration actuelle ne change pendant ce temps.

Disponible depuis la v3.0.0

Cette étape est facultative

Si vous ne la faites jamais, rien ne casse et rien ne cesse de fonctionner. Vos événements continuent d'être envoyés, vos scores de qualité de correspondance continuent de se mettre à jour et le tableau de bord fonctionne exactement comme aujourd'hui. La seule différence est que la section Volume d'événements affiche des chiffres d'exemple clairement identifiés à la place des vôtres.

Ce qu'apporte le token de statistiques

Une fois connectée, la section Volume d'événements du tableau de bord passe des exemples à votre boutique réelle, sur les sept derniers jours :

Carte	Ce qu'elle vous indique
Événements envoyés	Combien d'événements de chaque type ont réellement atteint Facebook (PageView, ViewContent, AddToCart, Purchase et les autres), du plus fréquent au moins fréquent
Navigateur vs serveur	Combien d'événements proviennent du navigateur du visiteur et combien de votre serveur
Par appareil	Ordinateur, mobile et tablette, afin de comparer avec le trafic dont vous connaissez l'existence

Elle renseigne aussi le panneau Fiche du pixel : le nom de votre pixel, la date de son dernier événement reçu, son taux de correspondance approximatif et l'activation ou non de la correspondance avancée automatique de Facebook.

Pourquoi la répartition navigateur vs serveur est celle qui vaut la peine d'être connue

C'est le chiffre que la plupart des propriétaires de boutique n'ont jamais vu pour leur propre boutique, et c'est la raison d'être de cette section.

Votre module envoie la plupart des événements deux fois, volontairement : une fois depuis le navigateur du visiteur et une fois depuis votre serveur, puis Facebook élimine le doublon. Cette redondance est ce qui maintient votre suivi en état de marche lorsqu'une extension de navigateur, un bloqueur de publicités ou un réglage de confidentialité empêche la moitié navigateur d'arriver.

Les deux chiffres devraient donc être raisonnablement proches. Un écart important signifie que les événements n'atteignent Facebook que par une seule voie :

• Serveur très au-dessus du navigateur : c'est normal, et généralement une bonne nouvelle. Cela signifie que la moitié serveur fait exactement le travail pour lequel elle a été ajoutée : couvrir les visiteurs dont le navigateur était bloqué.
• Navigateur très au-dessus du serveur : mérite d'être examiné. Votre API de Conversions ne porte pas sa part, et tout visiteur utilisant un bloqueur de publicités est donc invisible.
• L'un des deux à zéro ou presque : l'une des deux moitiés ne fonctionne pas du tout.

Rien de cela n'est visible à partir des scores de qualité de correspondance, et c'est pourquoi la section volume vaut les vingt minutes.

Avant de commencer

Vous devez être administrateur du Business Manager propriétaire de votre pixel, et vous avez besoin de l'utilisateur système que vous utilisez déjà pour l'API de Conversions. Si quelqu'un d'autre a configuré votre pixel, c'est le moment de le lui demander.

Vous n'avez pas besoin d'écrire de code, de publier quoi que ce soit ni de soumettre quoi que ce soit à Facebook pour validation.

Pas à pas

1. Créer une application

Rendez-vous sur developers.facebook.com → Mes applications → Créer une application.

• Pour le cas d'usage, choisissez Créer et gérer des publicités avec l'API Marketing. C'est celui qui porte les autorisations dont vous avez besoin ; un autre choix ne les proposera pas par la suite.
• Associez l'application au même Business Manager que celui qui possède votre pixel.

L'application n'est qu'un conteneur sur lequel un token est émis. Vous ne la rouvrirez jamais.

2. Ajouter l'application à votre entreprise

Paramètres de l'entreprise → Comptes → Applications → Ajouter.

Si votre nouvelle application n'apparaît pas dans la liste, utilisez Demander l'accès à un ID d'application et collez l'ID d'application affiché en haut de son tableau de bord dans Meta for Developers. Une application tout juste créée a parfois besoin d'un rafraîchissement de la page pour apparaître.

3. Attribuer l'application à votre utilisateur système : c'est l'étape que l'on oublie

Paramètres de l'entreprise → Utilisateurs → Utilisateurs système → sélectionnez votre utilisateur → Attribuer des actifs.

1. Applications → votre nouvelle application → Contrôle total → Enregistrer.
2. Attribuer des actifs à nouveau → Ensembles de données → votre pixel → Contrôle total → Enregistrer.

Si vous sautez l'attribution de l'application

Le générateur de token ne vous proposera simplement pas les autorisations dont vous avez besoin, sans explication. Presque tous ceux qui sont bloqués à l'étape 4 le sont ici. Attribuez d'abord l'application, puis l'ensemble de données.

Facebook a renommé les pixels en Ensembles de données dans cette partie de l'interface. Si vous cherchez « Pixels » sans le trouver, c'est pour cette raison.

4. Générer le token

Toujours sur l'utilisateur système, cliquez sur Générer un nouveau token.

• Sélectionnez l'application créée à l'étape 1.
• Cochez ads_read et ads_management.

Copiez le token immédiatement : Facebook ne l'affiche qu'une seule fois et ne le montrera plus. Si vous le perdez, en générer un autre est sans conséquence.

5. Le coller dans le module

Sur le tableau de bord Pixel Insights, dans la section Volume d'événements, collez-le dans Collez votre token de statistiques et cliquez sur Débloquer.

Le module vérifie le token auprès de Facebook avant de l'enregistrer. Un token qui ne peut pas lire vos données est rejeté sur-le-champ, avec la raison, plutôt que d'être stocké puis d'échouer discrètement plus tard.

Vos deux tokens

Le module conserve deux emplacements distincts, et l'un n'écrase jamais l'autre :

Emplacement	Alimente
Token de lecture : celui de deux minutes depuis le Gestionnaire d'événements	Qualité de correspondance, couverture des événements, diagnostics, conversions supplémentaires de l'API de Conversions
Token de statistiques : celui de ce guide	Volume d'événements, navigateur vs serveur, appareils, fiche du pixel

Aucun n'est un prérequis de l'autre, et aucun n'est votre token de l'API de Conversions : celui-ci se trouve ailleurs et n'est jamais touché par quoi que ce soit sur cet écran.

Si vous ne renseignez que l'emplacement statistiques, le module l'utilisera aussi pour la qualité de correspondance, car l'autorisation plus large la couvre. L'inverse n'est pas vrai : le token de lecture rapide ne peut pas lire le volume, et il s'agit d'une restriction de Facebook, non d'une limite du module.

Le supprimer

Supprimer le token de statistiques sur le tableau de bord le déconnecte. La section volume revient aux chiffres d'exemple et tout le reste continue sans changement.

Vos événements continuent d'être envoyés tout au long du processus. Supprimer l'un ou l'autre des tokens Insights n'a aucun effet sur le suivi : ces tokens ne font que lire.

Quand quelque chose ne fonctionne pas

Ce que vous voyez	Ce que cela signifie
La section volume affiche toujours « Chiffres d'exemple, pas ceux de votre boutique »	Le token n'a pas été enregistré. Consultez le message sous le champ pour en connaître la raison.
Le token est rejeté car il ne peut pas lire vos données	Presque toujours l'attribution de l'application à l'étape 3. Attribuez l'application à l'utilisateur système, puis générez un nouveau token : un token existant ne gagne pas d'autorisations rétroactivement.
Les chiffres de volume sont tous à zéro	Le token fonctionne, mais le pixel n'a réellement reçu aucun événement sur la période. Envoyez un événement de test et vérifiez à nouveau.
Le token a cessé de fonctionner au bout d'un moment	Il a été régénéré ou révoqué dans les Paramètres de l'entreprise. Générez-en un nouveau et collez-le à nouveau.
Le taux de correspondance n'est pas affiché	Facebook n'en a pas encore calculé pour votre pixel. Il apparaît de lui-même dès qu'il y a assez de données.

Questions fréquentes

Q : Dois-je le faire ? R : Non. C'est entièrement facultatif. Le tableau de bord fonctionne sans cela et votre suivi n'est pas affecté : vous voyez simplement des chiffres d'exemple dans la section Volume d'événements à la place des vôtres.

Q : La création d'une application Facebook va-t-elle casser quelque chose ou coûter quelque chose ? R : Non. L'application est gratuite, n'est jamais publiée, ne nécessite aucune validation et ne fait rien par elle-même. Elle n'existe que pour qu'un token puisse être émis dessus.

Q : Cela remplace-t-il mon token de l'API de Conversions ? R : Non. Ce sont trois identifiants différents à trois endroits différents. Ajouter, modifier ou supprimer un token Insights ne touche jamais le token qui envoie vos événements.

Q : Pourquoi le module ne peut-il pas simplement utiliser le token que j'ai déjà ? R : Facebook traite l'envoi et la lecture comme des autorisations distinctes, et n'ajoute pas d'autorisation de lecture à un token existant. Lire spécifiquement les données de volume exige une autorisation plus large que celle que peut porter le token rapide du Gestionnaire d'événements.

Q : Le token expire-t-il ? R : Non. Les tokens générés de cette manière n'ont pas de date d'expiration. Ils cessent de fonctionner uniquement si quelqu'un les régénère ou les révoque dans les Paramètres de l'entreprise.

Q : Pourquoi seulement sept jours de données ? R : C'est la fenêtre que demande le tableau de bord, car c'est celle qui répond à « mon suivi est-il en bonne santé en ce moment ». Facebook conserve davantage, mais une fenêtre plus longue rend bien plus difficile le repérage d'un changement introduit hier.

Q : Où le token est-il stocké ? R : Dans la configuration de votre boutique, comme n'importe quel autre réglage, et il n'est jamais envoyé qu'à Facebook. Il apparaît aussi dans le champ Token de statistiques avancé de la section API de Conversions : toute personne ayant accès aux paramètres de votre module peut donc le lire. Traitez-le comme n'importe quel autre identifiant et régénérez-le dans les Paramètres de l'entreprise si vous devez un jour le révoquer.

Q : Puis-je le coller dans le formulaire de paramètres plutôt que sur le tableau de bord ? R : Vous le pouvez, mais le tableau de bord est préférable : il vérifie le token auprès de Facebook avant de l'enregistrer, de sorte qu'un token qui ne fonctionnera pas vous le signale immédiatement au lieu de vous laisser avec une section vide et sans explication. Laisser l'un ou l'autre champ de token vide et enregistrer ne supprime jamais un token enregistré.

Dois-je le faire ?

Non. C'est entièrement facultatif. Le tableau de bord fonctionne sans cela et votre suivi n'est pas affecté : vous voyez simplement des chiffres d'exemple dans la section Volume d'événements à la place des vôtres.

La création d'une application Facebook va-t-elle casser quelque chose ou coûter quelque chose ?

Non. L'application est gratuite, n'est jamais publiée, ne nécessite aucune validation et ne fait rien par elle-même. Elle n'existe que pour qu'un token puisse être émis dessus.

Cela remplace-t-il mon token de l'API de Conversions ?

Non. Ce sont trois identifiants différents à trois endroits différents. Ajouter, modifier ou supprimer un token Insights ne touche jamais le token qui envoie vos événements.

Pourquoi le module ne peut-il pas simplement utiliser le token que j'ai déjà ?

Facebook traite l'envoi et la lecture comme des autorisations distinctes, et n'ajoute pas d'autorisation de lecture à un token existant. Lire spécifiquement les données de volume exige une autorisation plus large que celle que peut porter le token rapide du Gestionnaire d'événements.

Le token expire-t-il ?

Non. Les tokens générés de cette manière n'ont pas de date d'expiration. Ils cessent de fonctionner uniquement si quelqu'un les régénère ou les révoque dans les Paramètres de l'entreprise.

Pourquoi seulement sept jours de données ?

C'est la fenêtre que demande le tableau de bord, car c'est celle qui répond à "mon suivi est-il en bonne santé en ce moment". Facebook conserve davantage, mais une fenêtre plus longue rend bien plus difficile le repérage d'un changement introduit hier.

Où le token est-il stocké ?

Dans la configuration de votre boutique, comme n'importe quel autre réglage, et il n'est jamais envoyé qu'à Facebook. Il apparaît aussi dans le champ **Token de statistiques avancé** de la section API de Conversions : toute personne ayant accès aux paramètres de votre module peut donc le lire. Traitez-le comme n'importe quel autre identifiant et régénérez-le dans les Paramètres de l'entreprise si vous devez un jour le révoquer.

Puis-je le coller dans le formulaire de paramètres plutôt que sur le tableau de bord ?

Vous le pouvez, mais le tableau de bord est préférable : il vérifie le token auprès de Facebook avant de l'enregistrer, de sorte qu'un token qui ne fonctionnera pas vous le signale immédiatement au lieu de vous laisser avec une section vide et sans explication. Laisser l'un ou l'autre champ de token vide et enregistrer ne supprime jamais un token enregistré.