Événements personnalisés
Cet article décrit les événements et propriétés personnalisés, l’historique des événements du profil utilisateur, les filtres de segmentation associés, les propriétés d’entrée dans Canvas, les analyses pertinentes, et plus encore. Pour en savoir plus sur les événements Braze en général, consultez la page Événements.
Les événements personnalisés sont des actions effectuées par vos utilisateurs ou des mises à jour les concernant. Lorsque des événements personnalisés sont enregistrés, ils peuvent déclencher autant de Campaigns de suivi que vous le souhaitez, de tout type. Vous pouvez ensuite utiliser des filtres de segmentation pour segmenter les utilisateurs selon la date et la fréquence de ces événements personnalisés. Les événements personnalisés sont donc particulièrement adaptés au suivi des interactions utilisateur à forte valeur au sein de votre application.
Cas d’usage
Voici quelques cas d’usage courants des événements personnalisés :
- Déclencher une Campaign ou un Canvas en fonction d’un événement personnalisé à l’aide de la livraison par événement
- Segmenter les utilisateurs selon le nombre de fois qu’ils ont effectué un événement personnalisé, la dernière fois que l’événement s’est produit, et d’autres critères similaires
- Utiliser l’analyse des événements personnalisés du tableau de bord pour visualiser un agrégat de la fréquence de chaque événement
- Trouver des analyses supplémentaires à l’aide des rapports d’entonnoir et de rétention
- Exploiter les propriétés d’entrée persistantes pour utiliser les métadonnées de votre événement client à des fins de personnalisation dans vos étapes Canvas
- Générer des analyses plus avancées avec Currents
- Configurer des critères de sortie pour définir quand les utilisateurs doivent quitter votre Canvas
Événements recommandés à suivre
Lorsque vous planifiez votre stratégie d’événements personnalisés, pensez à suivre les types d’événements suivants : ils favorisent souvent l’engagement et vous aident à comprendre le parcours de vos utilisateurs.
Attribution marketing
Suivez la façon dont les utilisateurs découvrent votre application ou votre site web en enregistrant des événements personnalisés qui capturent les détails de vos campagnes marketing. Lorsque des utilisateurs arrivent depuis des campagnes e-mail, des publicités payantes ou les réseaux sociaux, capturez les paramètres UTM en tant que propriétés d’événement :
- Nom de l’événement :
campaign_visitoumarketing_click - Propriétés à suivre :
utm_source(origine du trafic, par exemplefacebookounewsletter),utm_medium(type de canal, par exempleemailoupaid_social),utm_campaign(identifiant de campagne spécifique),utm_content(lien ou création spécifique) etutm_term(mots-clés de recherche payante)
Vous pouvez ainsi segmenter les utilisateurs selon leur canal d’acquisition, mesurer les performances des campagnes et déclencher des messages de suivi ciblés en fonction des campagnes qui ont généré des conversions.
Comportement de recherche
Suivez les recherches effectuées par les utilisateurs dans votre application ou sur votre site web pour comprendre ce qu’ils cherchent et identifier les lacunes de votre contenu :
- Nom de l’événement :
search_submitted - Propriétés à suivre :
search_query(le terme de recherche saisi),results_count(nombre de résultats renvoyés),selected_result(le résultat sur lequel l’utilisateur a cliqué, le cas échéant)
Utilisez ces données pour créer des segments d’utilisateurs intéressés par des sujets spécifiques, déclencher des recommandations personnalisées ou repérer les recherches populaires qui renvoient peu de résultats.
Engagement avec les fonctionnalités
Suivez l’utilisation des fonctionnalités clés pour comprendre lesquelles apportent de la valeur :
- Étapes du tutoriel ou de l’onboarding : enregistrez l’achèvement de chaque étape pour identifier où les utilisateurs abandonnent
- Découverte des fonctionnalités : suivez la première utilisation des fonctionnalités importantes
- Interactions avec le contenu : enregistrez les moments où les utilisateurs enregistrent, partagent ou ajoutent du contenu à leurs favoris
- Contenu généré par les utilisateurs : suivez les moments où les utilisateurs créent, modifient ou publient du contenu
Jalons de conversion
Au-delà de l’achat lui-même, suivez les micro-conversions qui mènent au chiffre d’affaires :
- Ajout à la liste de souhaits ou aux favoris : identifiez les produits que les utilisateurs envisagent d’acheter
- Comparaisons de produits : suivez les produits que les utilisateurs comparent côte à côte
- Débuts et finalisations de formulaires : mesurez les abandons dans les parcours en plusieurs étapes
- Réservations de rendez-vous ou de créneaux : suivez le comportement de planification
Bonnes pratiques
Lorsque vous implémentez des événements personnalisés :
- Utilisez une nomenclature cohérente : établissez une convention de nommage (comme
snake_caseoucamelCase) et appliquez-la à tous vos événements - Concentrez-vous sur les actions des utilisateurs : suivez ce que font les utilisateurs, pas ce que votre système fait en arrière-plan
- Gardez des propriétés d’événement plates : évitez les objets profondément imbriqués dans les propriétés d’événement
- Utilisez des noms explicites : choisissez des noms d’événements qui décrivent clairement l’action, par exemple
video_completedplutôt quevid_end
Pour des schémas d’événements eCommerce prédéfinis, consultez la page Événements recommandés pour l’eCommerce.
Gestion des événements personnalisés
Vous pouvez gérer, créer ou mettre sur liste de blocage des événements personnalisés dans le tableau de bord en accédant à Paramètres des données > Événements personnalisés.
Résolution des problèmes liés aux attributs ou événements personnalisés en double
Si vous voyez deux entrées de données personnalisées avec le même nom visible, l’une des entrées peut contenir un espace invisible au début ou à la fin.
Pour résoudre ce problème :
- Accédez à Data Settings > Custom Attributes ou Custom Events, puis localisez les deux entrées qui semblent avoir le même nom.
- Vérifiez si l’un des noms contient un espace masqué :
- Faites un clic droit sur chaque nom et sélectionnez Inspecter.
- Vérifiez la valeur textuelle HTML dans les outils de développement de votre navigateur.
- Comparez les valeurs (par exemple,
emailpar rapport à ` email`). - Si nécessaire, consultez Inspecter et modifier les pages et les styles avec Chrome DevTools.
- Décidez quel nom doit rester comme clé canonique, et standardisez l’orthographe et la casse exactes.
- Si une entrée contient des espaces au début ou à la fin et a été créée directement dans le tableau de bord, cessez d’utiliser cette entrée et passez à la clé canonique :
- Mettez à jour tous les workflows du tableau de bord, les imports CSV et les runbooks internes pour utiliser la clé canonique.
- Bloquez les données personnalisées pour l’entrée incorrecte lorsque vous êtes prêt à la retirer.
- Vérifiez vos chemins d’ingestion :
- Les payloads API et SDK suppriment automatiquement les espaces au début et à la fin.
- Les noms créés dans le tableau de bord ne sont pas automatiquement nettoyés ; une saisie manuelle et une gouvernance sont donc nécessaires.
Sélectionnez le menu à côté d’un événement personnalisé pour effectuer les actions suivantes :
Mise sur liste de blocage
Vous pouvez mettre sur liste de blocage des événements personnalisés individuels via le menu des actions, ou sélectionner jusqu’à 100 événements et les bloquer en masse.
Lorsque vous bloquez un événement personnalisé :
- Les données futures ne seront pas collectées pour cet événement.
- Les données existantes ne seront pas disponibles à moins que cet événement ne soit débloqué.
- Cet événement n’apparaîtra pas dans les filtres ni dans les graphiques.
De plus, si un événement personnalisé bloqué est actuellement référencé par des filtres ou des déclencheurs dans d’autres zones de Braze, une fenêtre modale d’avertissement s’affiche. Elle indique que toutes les instances des filtres ou déclencheurs qui y font référence seront supprimées et archivées.
Pour en savoir plus sur la mise sur liste de blocage et la suppression des données personnalisées, consultez Mettre des données personnalisées sur liste de blocage.
Ajouter des descriptions
Vous pouvez ajouter une description à un événement personnalisé après sa création si vous disposez de l’autorisation utilisateur Manage Events, Attributes, Purchases. Sélectionnez Modifier la description pour l’événement personnalisé et saisissez le texte de votre choix, par exemple une note pour votre équipe.
Ajouter des étiquettes
Vous pouvez ajouter des étiquettes à un événement personnalisé après sa création si vous disposez de l’autorisation utilisateur « Manage Events, Attributes, Purchases ». Ces étiquettes peuvent ensuite servir à filtrer la liste des événements.
Exporter des données
Pour exporter la liste des événements personnalisés sous forme de fichier CSV, sélectionnez Tout exporter en haut de la page. Le fichier CSV est généré et un lien de téléchargement vous est envoyé par e-mail.

Le tableau de bord n’impose aucune limite fixe quant au nombre d’événements personnalisés ou d’attributs personnalisés distincts que vous pouvez définir ou stocker sur un profil. Les limites pratiques dépendent de la structure des données, du volume d’ingestion et des performances de l’espace de travail. Si vous prévoyez de suivre un très grand catalogue d’événements ou d’attributs, collaborez avec l’équipe chargée de votre compte Braze sur la modélisation et l’hygiène des données (par exemple, la mise sur liste de blocage des données inutilisées).
Consulter les rapports d’utilisation
Le rapport d’utilisation répertorie tous les Canvas, Campaigns et Segments qui utilisent un événement personnalisé spécifique. Cette liste n’inclut pas les utilisations dans Liquid.
Vous pouvez consulter jusqu’à 100 rapports d’utilisation à la fois. Pour cela, cochez les cases à côté des événements personnalisés concernés, puis sélectionnez Afficher le rapport d’utilisation.
Enregistrer des événements personnalisés
Les événements personnalisés nécessitent une configuration supplémentaire. Consultez la documentation de votre plateforme ci-dessous pour connaître les méthodes permettant d’enregistrer des événements personnalisés, ainsi que la façon d’y ajouter des propriétés et des quantités.
Développer pour afficher la documentation par plateforme
Stockage des événements personnalisés
Toutes les données stockées dans le profil utilisateur, y compris les métadonnées des événements personnalisés (première ou dernière occurrence, nombre total et X sur Y au cours des 30 derniers jours), sont conservées indéfiniment tant que chaque profil est actif.
Consulter l’historique des événements d’un utilisateur
L’onglet Historique des événements du profil d’un utilisateur affiche ses événements personnalisés et ses achats récents. Il vous permet de vérifier que votre intégration enregistre correctement les événements et de résoudre les problèmes propres à un utilisateur directement dans le tableau de bord.
Pour consulter l’historique des événements d’un utilisateur :
- Accédez à Audience > Rechercher des utilisateurs, puis sélectionnez un utilisateur pour ouvrir son profil.
- Sélectionnez l’onglet Historique des événements.
L’onglet affiche les événements personnalisés et les achats de l’utilisateur des 30 derniers jours, dans la limite de ses 100 événements les plus récents, classés du plus récent au plus ancien.
Chaque événement comprend les informations suivantes :
- Type d’événement : indique s’il s’agit d’un événement personnalisé ou d’un achat.
- Nom de l’événement : le nom de l’événement tel qu’il a été enregistré.
- Heure : le moment où l’événement s’est produit.
- Propriétés : l’ensemble des propriétés d’événement pour cette occurrence, au format JSON.
Voici quelques cas d’usage courants :
- Vérifier que votre intégration SDK ou API envoie les événements comme prévu, pendant le développement ou après une nouvelle version.
- Comprendre pourquoi un utilisateur est entré ou non dans une Campaign ou un Canvas déclenché par un événement.
- Examiner une demande d’assistance concernant un utilisateur précis sans configurer d’exportation de données.

Pour consulter l’onglet Historique des événements, vous devez disposer des autorisations utilisateur Rechercher des utilisateurs, Afficher les données personnelles et Afficher les propriétés d’événement utilisateur, car les propriétés d’événement peuvent contenir des données personnelles. Pour en savoir plus, consultez la page Autorisations des utilisateurs de l’entreprise.
Filtres de segmentation
Le tableau suivant présente les filtres disponibles pour segmenter les utilisateurs en fonction des événements personnalisés.
| Options de segmentation | Filtre déroulant | Options de saisie |
|---|---|---|
| Vérifier si l’événement personnalisé s’est produit plus de X fois | PLUS DE | NOMBRE |
| Vérifier si l’événement personnalisé s’est produit moins de X fois | MOINS DE | NOMBRE |
| Vérifier si l’événement personnalisé s’est produit exactement X fois | EXACTEMENT | NOMBRE |
| Vérifier si l’événement personnalisé s’est produit pour la dernière fois après la date X | APRÈS | HEURE |
| Vérifier si l’événement personnalisé s’est produit pour la dernière fois avant la date X | AVANT | HEURE |
| Vérifier si l’événement personnalisé s’est produit pour la dernière fois il y a plus de X jours | PLUS DE | NOMBRE DE JOURS (nombre positif) |
| Vérifier si l’événement personnalisé s’est produit pour la dernière fois il y a moins de X jours | MOINS DE | NOMBRE DE JOURS (nombre positif) |
| Vérifier si l’événement personnalisé s’est produit plus de X fois (max. = 50) | PLUS DE | au cours des Y derniers jours (Y = 1,3,7,14,21,30) |
| Vérifier si l’événement personnalisé s’est produit moins de X fois (max. = 50) | MOINS DE | au cours des Y derniers jours (Y = 1,3,7,14,21,30) |
| Vérifier si l’événement personnalisé s’est produit exactement X fois (max. = 50) | EXACTEMENT | au cours des Y derniers jours (Y = 1,3,7,14,21,30) |
Analyses
Braze enregistre le nombre de fois où chaque événement personnalisé s’est produit, ainsi que la date de sa dernière exécution par chaque utilisateur, afin de permettre la segmentation. Pour la configuration du rapport, les filtres et les options d’exportation, consultez la page Rapport sur les événements personnalisés.
La page Rapport sur les événements personnalisés présente la fréquence globale de chaque événement personnalisé. Les lignes grises superposées à la série temporelle indiquent la dernière fois qu’une Campaign a été envoyée. Elles vous aident à voir l’effet de vos Campaigns sur l’activité des événements personnalisés.

Vous pouvez aussi utiliser les Filtres pour ventiler vos événements personnalisés par heure, par utilisateurs actifs mensuels (MAU), par Segments ou par formules de KPI.


Incrémentez des attributs personnalisés pour tenir un compteur sur une action utilisateur, de la même manière qu’un événement personnalisé. Toutefois, les données d’attributs personnalisés ne peuvent pas être affichées sous forme de série temporelle. Utilisez cette méthode pour enregistrer les actions utilisateur qui n’ont pas besoin d’être analysées dans une série temporelle.
Pourquoi les analyses d’événements personnalisés ne s’affichent pas
Les Segments créés à partir de données d’événements personnalisés ne peuvent pas afficher les données historiques antérieures à leur création.
Propriétés d’événement personnalisé
Les propriétés d’événement personnalisé sont des métadonnées ou des attributs d’événement personnalisé qui décrivent une occurrence spécifique d’un événement. Ces propriétés peuvent être utilisées pour affiner les conditions de déclenchement, augmenter la personnalisation des messages, suivre les conversions et générer des analyses plus sophistiquées via l’exportation de données brutes.
Pour en savoir plus, consultez Propriétés d’événement personnalisé.