Schéma d’événements
Le schéma d’événements décrit les événements que le projet doit recevoir et leurs propriétés : order_completed avec un montant obligatoire de type nombre, currency uniquement EUR ou USD. OneTrace.pro compare chaque événement au schéma et signale les écarts : une faute de frappe dans le nom de l’événement, un montant envoyé sous forme de texte, une propriété manquante. Les erreurs de marquage du site ou d’une intégration sont repérées tout de suite, et non quand un segment ou un rapport a déjà été mal calculé.
Un événement non conforme au schéma est tout de même accepté et enregistré dans le profil : aucune donnée n’est perdue, même si l’erreur vient du schéma lui-même. Le schéma d’événements est disponible à partir du forfait « Croissance ».
Décrire les événements
Ouvrez le Catalogue de données, puis l’onglet Schéma d’événements. Les rôles disposant du droit « Gérer le catalogue d'événements », c’est-à-dire « Gestionnaire » et les rôles supérieurs, peuvent modifier le schéma ; les autres voient le schéma et les écarts.
- Cliquez sur Ajouter les événements actuels : tous les événements du catalogue sont ajoutés au schéma avec leurs propriétés et les types constatés. Vous pouvez aussi ajouter les événements un par un avec le bouton Ajouter un événement.
- Vérifiez les propriétés de chaque événement :
| Colonne | Ce qu’elle définit |
|---|---|
| Propriété | La clé de la propriété telle que le site ou le serveur l’envoie, par exemple amount |
| Type | Texte, nombre, oui/non, date et heure, liste ou objet. Une valeur de date et heure convient aussi à une propriété de type texte |
| Obligatoire | Un événement sans cette propriété ou avec une valeur vide constitue un écart |
| Valeurs autorisées | Séparées par des virgules, uniquement pour le texte et les nombres. Une valeur absente de la liste constitue un écart ; la casse compte : eur et EUR sont des valeurs différentes |
| Description | Pour les développeurs : ce que signifie la propriété |
- Retirez les événements et les propriétés qui ne doivent plus arriver : s’ils arrivent, ce sera un écart « Événement non décrit » ou « Propriété non décrite ».
- Cliquez sur Enregistrer le schéma et activez Vérifier les événements selon le schéma.
Les modifications s’accumulent à l’écran et sont enregistrées ensemble. Après l’enregistrement, les compteurs d’écarts repartent de zéro : les précédents concernent l’ancien schéma. Dans l’onglet Événements, un événement du schéma qui n’est encore jamais arrivé est indiqué « Pas encore reçu », et les événements du schéma portent la mention « Dans le schéma ».

Les événements système de la plateforme ($identify, $page, $message_sent, etc.), ainsi que les identify et les consultations de pages et d’écrans de l’application, ne sont pas vérifiés : leur schéma est défini par la plateforme.
Écarts
| Écart | Exemple |
|---|---|
| Événement non décrit | product_viewd est arrivé au lieu de product_viewed |
| Propriété non décrite | order_completed est arrivé avec la propriété coupon, absente du schéma |
| Propriété obligatoire absente | add_to_cart sans quantity |
| Type incorrect | Le montant est arrivé sous forme de texte "1250" au lieu du nombre 1250 |
| Valeur non autorisée | currency = eur, alors que le schéma prévoit EUR et USD |
Les écarts des 7 derniers jours s’affichent au-dessus de la liste des événements du schéma : combien de fois et quand pour la dernière fois, avec un exemple, le type de la valeur ou la valeur non autorisée elle-même. Sans le droit de voir les données personnelles, l’exemple est masqué. Si un événement n’est pas décrit à cause d’une erreur du schéma et non du marquage, cliquez sur Ajouter au schéma : il est ajouté au brouillon avec les propriétés du catalogue.
Les mêmes écarts et le graphique des événements avec écarts sur 24 heures figurent dans la section Diagnostic.

Import, export et API
Exporter en JSON télécharge le schéma enregistré, Importer un JSON charge un fichier dans le brouillon : vérifiez-le, puis enregistrez-le. C’est ainsi qu’on transfère un même schéma d’un projet à l’autre : par exemple, vers toutes les boutiques d’une enseigne ou d’un projet de test vers le projet de production.
Via l’API publique, le schéma se lit (GET /api/v1/event-schema) et se remplace en entier (PUT /api/v1/event-schema, autorisation de clé « Modifier le schéma d’événements »), et les écarts de la semaine s’obtiennent avec la requête GET /api/v1/event-schema/violations. Le format du fichier et de l’API est le même :
{
"enabled": true,
"events": [
{
"name": "order_completed",
"label": "A passé commande",
"properties": [
{ "key": "amount", "type": "number", "required": true },
{ "key": "currency", "type": "string", "required": true, "values": ["EUR", "USD"] }
]
}
]
}
Les événements absents du document sortent du schéma, mais restent dans le catalogue de données avec leurs libellés et leurs statistiques. Un document sans events ne fait qu’activer ou désactiver la vérification.