Événements et catalogue d'événements

Un événement est une action d'un client ou du système : consultation d'une page, ajout au panier, commande, ouverture d'un e-mail. Les événements alimentent les profils, les segments, les déclencheurs de parcours et les rapports. La section Données → Événements montre ce qui arrive dans le projet en ce moment, et Données → Catalogue indique quels événements et attributs existent et comment ils sont libellés.

Les deux sections sont accessibles à tous les membres du projet. Le « Propriétaire », l'« Administrateur » et le « Gestionnaire » peuvent modifier les libellés, les types et les marquages de données personnelles dans le catalogue.

Provenance des événements

Source	Ce qu'elle transmet
Traceur sur le site	consultations de pages, actions sur les produits, connexion : voir Connexion du site
API depuis votre serveur ou votre application	commandes, inscriptions, changements de statut : voir Intégration côté serveur
Import et sources de données	profils depuis des CSV, des fichiers, S3 et Google Sheets : voir Import de fichiers et sources de données
Migration depuis une autre plateforme	historique des profils et des événements : voir Migration depuis d'autres plateformes
OneTrace.pro lui-même	entrées dans les segments, étapes de parcours, envois et ouvertures de messages, abonnements et désabonnements

Les événements sont traités quelques secondes après leur envoi. Un événement répété avec le même messageId dans les 24 heures est ignoré. L'heure d'un événement située plus d'une heure dans le futur est remplacée par l'heure de réception. Le nombre d'événements par mois est limité par le forfait du projet : voir Paramètres du projet, forfait et audit.

Flux d'événements

La page Événements affiche les événements du projet en temps réel. À l'ouverture, les 50 derniers événements des 7 derniers jours sont chargés, et les nouveaux apparaissent automatiquement en haut.

Flux d'événements avec un événement déplié

Ce que vous pouvez faire :

Filtrer par nom. Dans la liste de gauche, choisissez un événement, par exemple order_completed : le flux n'affiche plus que celui-ci. « Tous les événements » retire le filtre.
Mettre en pause. Le bouton Pause arrête le flux pour examiner les événements tranquillement ; Reprendre le relance.
Voir les propriétés. Cliquez sur une ligne pour déplier les propriétés au format JSON.
Ouvrir le profil. Le numéro #… à côté du nom mène à la fiche du profil.

À droite s'affiche l'état de la connexion : « Connecté », « Connexion… » ou « Déconnecté ». Lorsque le flux est très important, une partie des événements n'est pas affichée à l'écran et la ligne « Ignorés en raison du volume élevé : N » apparaît. Les événements eux-mêmes sont bien enregistrés : seul l'affichage est concerné.

Si vous n'avez pas le droit de voir les données personnelles, les e-mails, téléphones et propriétés personnelles des événements sont masqués. Pour en savoir plus, consultez l'article Profils.

Le flux est pratique pour vérifier l'installation : ouvrez le site dans un onglet voisin, ajoutez un produit au panier et vérifiez que l'événement arrive avec les bonnes propriétés.

Catalogue de données

Le catalogue se remplit automatiquement : dès qu'un nouvel événement, une nouvelle propriété ou un nouvel attribut arrive dans le projet, il y apparaît avec un type déterminé. Vous pouvez ouvrir le catalogue depuis le menu ou avec le bouton Catalogue de données de la page des événements.

Onglet « Événements »

Tableau des événements : Événement (nom), Libellé, Volume (nombre de réceptions) et Vu pour la dernière fois (date de la dernière réception). La flèche à gauche déplie la liste des propriétés de l'événement avec leurs types, par exemple amount: number.

Catalogue de données, onglet « Événements »

Onglet « Attributs de profil »

Les attributs sont les propriétés du client : e-mail, nom, ville, forfait, date de naissance. Colonnes : Clé, Libellé, Type et Données personnelles.

Catalogue de données, onglet « Attributs de profil »

Configurer le catalogue

Saisissez un Libellé explicite, par exemple « A passé commande » pour order_completed ou « Ville » pour city. La modification est enregistrée immédiatement.
Pour un attribut, vérifiez le Type : string (texte), number (nombre), boolean (oui/non), datetime (date et heure), list (liste), object (objet).
Cochez Données personnelles si l'attribut contient des données personnelles : passeport, adresse, date de naissance.

Utilisation :

Les libellés s'affichent dans l'éditeur de segments à côté de la clé : « Ville (city) ». Le marketeur n'a pas besoin de retenir les noms techniques.
Les conditions de segment dépendent du type : pour les nombres, « supérieur à » et « inférieur à » ; pour les dates, « avant », « après » et « au cours des derniers ». Si le type a été mal détecté, par exemple une date reçue sous forme de texte, corrigez-le.
Les attributs marqués comme données personnelles sont masqués pour les personnes qui n'ont pas le droit de voir les données personnelles. L'e-mail, le téléphone, les noms et l'adresse sont marqués automatiquement.

Événements réservés

Les noms commençant par le signe $ sont réservés à OneTrace.pro. Vous ne pouvez pas envoyer votre propre événement avec un tel nom : la requête renvoie une erreur.

Événement	Quand il apparaît
`$page`, `$identify`, `$alias`	appels `cdp.page()`, `cdp.identify()` et fusion d'identifiants
`$segment_entered`, `$segment_exited`	le profil est entré dans un segment ou en est sorti
`$journey_entered`, `$journey_completed`, `$journey_exited`, `$journey_failed`	étapes de la participation à un parcours
`$message_sent`, `$message_delivered`, `$message_failed`, `$message_skipped`, `$message_bounced`, `$message_complained`, `$message_opened`, `$message_clicked`	sort des messages envoyés
`$subscribed`, `$unsubscribed`	modification du consentement aux envois

Les événements système sont visibles dans le flux, dans le catalogue et dans l'historique du profil ; vous pouvez les utiliser dans les conditions de segment comme vos propres événements.

Conseils pour nommer les événements

Nommez les événements en caractères latins, en snake_case et au passé : order_completed, product_viewed, trial_started.
Ne mettez pas de données variables dans le nom : pas order_1001, mais order_completed avec la propriété order_id.
Transmettez les montants sous forme de nombre et non de texte avec la devise : amount: 9980.