Passer au contenu

Cours d’apprentissage BrazeÉ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

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_visit ou marketing_click
  • Propriétés à suivre : utm_source (origine du trafic, par exemple facebook ou newsletter), utm_medium (type de canal, par exemple email ou paid_social), utm_campaign (identifiant de campagne spécifique), utm_content (lien ou création spécifique) et utm_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_case ou camelCase) 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_completed plutôt que vid_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 :

  1. Accédez à Data Settings > Custom Attributes ou Custom Events, puis localisez les deux entrées qui semblent avoir le même nom.
  2. Vérifiez si l’un des noms contient un espace masqué :
    1. Faites un clic droit sur chaque nom et sélectionnez Inspecter.
    2. Vérifiez la valeur textuelle HTML dans les outils de développement de votre navigateur.
    3. Comparez les valeurs (par exemple, email par rapport à ` email`).
    4. Si nécessaire, consultez Inspecter et modifier les pages et les styles avec Chrome DevTools.
  3. Décidez quel nom doit rester comme clé canonique, et standardisez l’orthographe et la casse exactes.
  4. 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.
  5. 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.

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 :

  1. Accédez à Audience > Rechercher des utilisateurs, puis sélectionnez un utilisateur pour ouvrir son profil.
  2. 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.

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.

Graphique du nombre d’événements personnalisés sur la page Événements personnalisés du tableau de bord, montrant les tendances d’un événement personnalisé

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.

Filtres du graphique des événements personnalisés

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é.

New Stuff!