Les événements envoyés par votre serveur : compter ce que le navigateur n'envoie pas

Un événement envoyé par une page dépend du navigateur du visiteur. Un bloqueur, ou un navigateur piloté par un programme, n'envoie rien : le compte est créé chez vous, et l'objectif ne bouge pas. Votre serveur, lui, sait que le compte existe. Il peut le dire lui-même à Bearing. Cette page s'adresse à un développeur.

Le mettre en place

1. Ouvrez Accès IA, puis Les clés, et créez une clé Pour le serveur de votre site. Elle ne fait qu'envoyer des événements et ne lit rien. Gardez-la sur votre serveur, jamais dans une page.
2. Dans la page, quand le visiteur fait l'action, prenez le jeton de visite et envoyez-le à votre serveur avec le reste de votre formulaire. Le jeton est créé dans la mémoire de la page, n'est jamais enregistré sur l'appareil du visiteur, et sert seulement à ce qu'un événement rejoigne la visite où il a eu lieu.
3. Sur votre serveur, une fois l'action faite, envoyez l'événement à Bearing avec la clé et le jeton.

// Dans la page, avec votre formulaire :
const token = window.bearing && window.bearing.token ? window.bearing.token() : "";

curl -X POST https://bearingstats.com/api/v1/events \
  -H "Authorization: Bearer bst_…" \
  -H "Content-Type: application/json" \
  -d '{"site": "exemple.fr", "name": "inscription", "token": "…", "id": "…"}'

• site : le domaine de votre site, ou son identifiant.
• name : le nom de l'événement, tel que l'onglet Événements le montre sous Installation et réglages. Un événement qui n'est pas encore dans votre liste apparaît comme Détecté.
• token : ce que bearing.token() a renvoyé. Ne l'envoyez pas quand la page n'en avait pas (le script était bloqué).
• props : des détails, comme pour un événement envoyé par une page (jusqu'à 30 valeurs courtes). Jamais de donnée personnelle.
• id : facultatif, votre propre référence pour cette action. La même n'est comptée qu'une fois : un nouvel envoi ne compte jamais double. Bearing n'en garde qu'une empreinte.

Comment c'est compté

• Avec un jeton que Bearing connaît, l'événement rejoint sa visite : la conversion prend la source et la campagne de cette visite, même si votre serveur la confirme plus tard. Si la page envoie aussi l'événement, la visite compte toujours pour une seule conversion, mais l'onglet Événements compte deux réceptions : une fois que votre serveur confirme un événement, cessez de l'envoyer depuis la page.
• Sans jeton, ou avec un jeton que Bearing n'a jamais reçu parce que le navigateur n'a rien envoyé, l'événement est compté sans visite mesurée. Il est dans le chiffre de l'objectif et dans le graphique ; il n'a pas de source et n'entre pas dans le taux de conversion. Bearing dit combien il y en a : c'est la taille de ce que les navigateurs ne lui ont pas dit.
• Chaque événement compte dans votre offre, comme un événement envoyé par une page.
• Les pages vues ne peuvent pas être envoyées ainsi : un serveur ne fait pas une visite.

Ce que Bearing répond

Contrairement au script, votre serveur détient une clé : la réponse dit donc ce qui s'est passé.

{ "counted": true, "visit": true }     l'événement a rejoint sa visite
{ "counted": true, "visit": false }    compté, sans visite mesurée
{ "counted": false, "test": true }     un essai : voir plus bas
{ "counted": false, "duplicate": true } cet id a déjà été reçu

Une erreur vient avec une phrase qui dit quoi changer : 401 pour une clé absente ou révoquée, 404 pour un site qui n'est pas dans votre compte, 400 pour un message que Bearing ne sait pas lire, 429 quand trop de choses arrivent d'un coup.

L'essayer sans toucher à vos chiffres

Faites l'action depuis un navigateur où vous avez exclu vos propres visites. Le jeton de ce navigateur le dit, et ce que votre serveur envoie avec lui est un essai : rien n'est compté, la réponse dit test, et l'événement affiche essai reçu dans l'onglet Événements. Vous savez alors que tout le chemin marche, de la page à votre serveur puis à Bearing.

Les paiements ne passent pas par ici : connectez Stripe et Bearing les lit lui-même.