Événements personnalisés

Cet article décrit les événements et propriétés personnalisés, les filtres de segmentation associés, les propriétés d’entrée dans Canvas, les analyses pertinentes, etc. Pour en savoir plus sur les événements de Braze en général, consultez la rubrique É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 un nombre et un type quelconque de campagnes de suivi. Vous pouvez ensuite utiliser des filtres de segmentation pour segmenter les utilisateurs en fonction de la fréquence et du caractère récent de ces événements personnalisés. Les événements personnalisés sont donc les mieux adaptés au suivi des interactions utilisateur de grande valeur au sein de votre application.

Cas d’utilisation

Parmi les cas courants d’utilisation d’événements personnalisés figurent les situations suivantes :

• Déclenchement d’une campagne ou d’un Canvas sur la base d’un événement personnalisé à l’aide de la livraison par événement
• Segmentation des utilisateurs en fonction du nombre de fois qu’ils ont effectué un événement personnalisé, de la date du dernier événement, etc.
• Utilisation de l’analytique des événements personnalisés du tableau de bord pour afficher un agrégat de la fréquence de chaque événement
• Recherche d’analyses supplémentaires à l’aide des rapports d’entonnoir et de rétention
• Exploitation des propriétés d’entrées persistantes pour utiliser les métadonnées de votre événement client à des fins de personnalisation dans vos étapes du canvas
• Génération d’analyses plus sophistiquées avec Currents
• Mise en place de critères de sortie pour définir quand les utilisateurs doivent quitter votre Canvas

Gestion des événements personnalisés

Vous pouvez gérer, créer ou mettre en liste de blocage des événements personnalisés dans le tableau de bord en sélectionnant Paramètres des données > Événements personnalisés.

Sélectionnez le menu situé à côté d’un événement personnalisé pour effectuer les actions suivantes :

Mise en liste de blocage

Vous pouvez mettre en liste de blocage des événements personnalisés individuels via le menu d’actions, ou sélectionner et mettre en liste de blocage jusqu’à 100 événements en bloc.

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 tant que l’événement n’aura pas été débloqué.
• Cet événement n’apparaîtra pas dans les filtres ou les graphiques.

En outre, 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, expliquant que toutes les instances des filtres ou des déclencheurs qui y font référence seront supprimées et archivées.

Ajout de 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 les informations souhaitées, par exemple une note à l’intention de votre équipe.

Ajout d’étiquettes

Vous pouvez ajouter des étiquettes à un événement personnalisé après sa création si vous disposez de l’autorisation utilisateur « Gérer les événements, attributs et achats ». Les étiquettes peuvent ensuite être utilisées pour filtrer la liste des événements.

Consultation des rapports d’utilisation

Le rapport d’utilisation répertorie tous les Canvas, campagnes et segments utilisant un événement personnalisé spécifique. La liste ne comprend pas les utilisations de Liquid.

Vous pouvez afficher jusqu’à 100 rapports d’utilisation à la fois en cochant les cases correspondant à plusieurs événements personnalisés, puis en sélectionnant Afficher le rapport d’utilisation.

Exportation des données

Pour exporter la liste des événements personnalisés sous forme de fichier CSV, sélectionnez le bouton Exporter tout en haut de la page. Le fichier CSV sera généré et un lien de téléchargement vous sera envoyé par e-mail.

Journalisation des événements personnalisés

Les événements personnalisés nécessitent une configuration supplémentaire. Consultez la liste ci-dessous pour accéder à la documentation de chaque plateforme, où vous trouverez des informations sur les méthodes utilisées pour enregistrer les événements personnalisés et sur la manière d’ajouter des propriétés et des quantités à vos événements personnalisés.

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 dans Y sur 30 jours), sont conservées indéfiniment tant que chaque profil est actif.

Filtres de segmentation

Le tableau suivant montre les filtres disponibles pour la segmentation des utilisateurs en fonction d’événements personnalisés.

Analytique

Braze enregistre le nombre de fois où des événements personnalisés se sont produits et la dernière fois qu’ils ont été effectués par chaque utilisateur, à des fins de segmentation. Consultez ces analyses en vous rendant dans Analytics > Custom Events Report.

Sur la page Rapport sur les événements personnalisés du tableau de bord, vous pouvez visualiser globalement la fréquence de chaque événement personnalisé. Les lignes grises superposées à la série chronologique indiquent la dernière fois qu’une campagne a été envoyée, ce qui est utile pour visualiser l’impact de vos campagnes sur l’activité des événements personnalisés.

Vous pouvez également utiliser des filtres pour décomposer vos événements personnalisés par heure, par moyenne mensuelle d’utilisateurs (MAU), par segment ou par formule d’indicateur clé de performance.

Pourquoi l’analytique des événements personnalisés ne s’affiche-t-elle pas ?

Les segments créés avec des données d’événements personnalisés ne peuvent pas afficher les données historiques antérieures à leur création.

Propriétés de l’é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 qualifier davantage les conditions de déclenchement, accroître la personnalisation des messages, suivre les conversions et générer des analyses plus sophistiquées grâce à l’exportation de données brutes.

Les propriétés d’événement personnalisé ne sont pas stockées dans le profil Braze et, par conséquent, ne consomment pas de points de données (voir Points de données pour les exceptions).

Format attendu

Les valeurs des propriétés doivent être un objet dont les clés sont les noms des propriétés et les valeurs sont les valeurs des propriétés. Les noms de propriétés doivent être des chaînes de caractères non vides de 255 caractères maximum, qui ne commencent pas par un symbole de dollar ($).

Les valeurs de propriété peuvent être l’un des types de données suivants :

Les objets de propriété d’événement qui contiennent des valeurs de tableau ou d’objet peuvent avoir un PAYLOAD de propriété d’événement allant jusqu’à 100 Ko.

Les types de données des valeurs de propriété sont détectés et traités de manière similaire aux valeurs d’attributs personnalisés, avec deux différences importantes :

• Conversion chaîne vers date/heure : Les valeurs de chaîne correspondant à un format de date/heure reconnu sont automatiquement converties en type datetime. Cela signifie que certaines valeurs de chaîne ne peuvent pas être stockées telles quelles dans les propriétés d’événement.
• Pas de coercition de type : Il n’y a pas de coercition automatique de type pour les propriétés d’événement. Si un filtre de déclenchement attend une valeur numérique 5, une valeur de chaîne "5" ne correspondra pas. Il en va de même pour les modèles Liquid et les données d’événements Currents.

Ces comportements s’appliquent également aux propriétés d’événement d’achat.

Vous pouvez modifier le type de données de votre propriété d’événement personnalisé, mais soyez conscient des conséquences d’un changement de type de données après la collecte des données.

Clés réservées

Il n’est pas possible d’utiliser des clés réservées comme noms de propriétés d’événement. L’utilisation d’une clé réservée dans l’objet properties renverra l’erreur « Champ ‘properties’ non valide ».

Utiliser des propriétés d’événement personnalisé

Les propriétés d’événement personnalisé peuvent être utilisées pour qualifier les déclencheurs de campagne, suivre les conversions et personnaliser les messages.

Déclencher des messages

Utilisez les propriétés d’événement personnalisé pour restreindre davantage votre audience dans le cadre d’une campagne ou d’un Canvas particulier. Par exemple, si vous avez une application de commerce électronique et que vous souhaitez envoyer un message à un utilisateur lorsqu’il abandonne son panier, vous pouvez ajouter une propriété d’événement personnalisé item price pour améliorer votre audience cible et permettre une personnalisation accrue de la campagne.

Les propriétés d’événement personnalisé imbriquées sont également prises en charge dans la livraison par événement.

Personnaliser des messages

Vous pouvez également utiliser des propriétés d’événement personnalisé pour personnaliser les messages. Toute campagne utilisant la livraison par événement avec un événement déclencheur peut utiliser les propriétés d’événement personnalisé de cet événement pour la personnalisation des messages.

Par exemple, si vous avez une application de jeu et que vous souhaitez envoyer un message aux utilisateurs qui ont terminé un niveau, vous pourriez personnaliser davantage votre message avec une propriété indiquant le temps qu’il a fallu aux utilisateurs pour terminer ce niveau. Dans cet exemple, le message est personnalisé pour trois segments différents à l’aide de la logique conditionnelle. La propriété d’événement personnalisé appelée time_spent peut être incluse dans le message en appelant {{event_properties.${time_spent}}}.

1
2
3
4
5
6
7
{% if {{event_properties.${time_spent}}} < 600 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}

Pour une liste complète des étiquettes Liquid qui entraîneront l’envoi de messages in-app sous forme de messages in-app modélisés, reportez-vous à la Foire aux questions.

Considérations relatives aux filtres

• Appels API : Lorsque vous effectuez des appels API et que vous utilisez le filtre « is blank » (est vide), une propriété d’événement personnalisé est considérée comme « vide » si elle est exclue de l’appel. Par exemple, si vous incluez "event_property": "", vos utilisateurs seront considérés comme « non vides ».
• Nombres entiers : Lorsque vous filtrez selon une propriété d’événement personnalisé numérique et que la valeur est très grande, n’utilisez pas le filtre « exactement ». Si le nombre est trop grand, il peut être arrondi à une certaine longueur et votre filtre ne fonctionnera donc pas comme prévu.

Segmentation

Utilisez la segmentation des propriétés d’événement pour cibler les utilisateurs en fonction des événements personnalisés effectués et des propriétés associées à ces événements. Cela augmente vos options de filtrage lors de la segmentation par achat et événements personnalisés.

Les propriétés des événements personnalisés sont mises à jour en temps réel pour tout segment qui les utilise. Vous pouvez gérer les propriétés en allant dans Paramètres des données > Événements personnalisés et en sélectionnant Gérer les propriétés pour l’événement personnalisé associé. Les propriétés d’événement personnalisé utilisées dans certains filtres de segment ont un historique de 30 jours maximum.

Ajout de propriétés d’événement pour la segmentation

Vous devez disposer de l’autorisation utilisateur « Modifier la segmentation des propriétés d’événement personnalisées » pour créer des segments basés sur la récence et la fréquence des propriétés d’événement.

Par défaut, vous pouvez avoir 20 propriétés d’événement segmentables par espace de travail. Contactez votre Account Manager Braze pour augmenter cette limite.

Pour ajouter des propriétés d’événement pour la segmentation, procédez comme suit :

1. Accédez à votre événement personnalisé et sélectionnez Gérer les propriétés.
2. Activez le bouton Activer la segmentation pour ajouter la propriété d’événement à la segmentation. Vous pourrez alors accéder à des options de filtrage supplémentaires lors de la segmentation.

Les filtres de segmentation des propriétés d’événement sont les suivants :

• A réalisé un événement personnalisé avec la propriété A et la valeur B, X fois au cours des Y derniers jours.
• A effectué des achats avec la propriété A d’une valeur B, X fois au cours des Y derniers jours.
• Permet de segmenter sur une période de 1 à 30 jours.

Les données ne sont enregistrées pour une propriété d’événement donnée qu’après son activation, et les propriétés d’événement ne sont disponibles qu’à partir de cette date.

Points de données

En ce qui concerne l’utilisation de l’abonnement, les propriétés d’événement personnalisé activées pour la segmentation avec les filtres suivants sont toutes comptées comme des points de données séparés, qui viennent s’ajouter au point de données consommé par l’événement personnalisé lui-même :

• X Custom Event Property in Y Days
• X Purchase Property in Y Days

Propriétés d’entrée et propriétés d’événement Canvas

Vous pouvez utiliser les propriétés d’entrée et les propriétés d’événement Canvas dans vos parcours utilisateur Canvas.

• canvas entry properties
• event properties

1
2
3
4
5
6
{% if  {{context.${product_name}}} == "shoes" %}
  Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
  Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}

Reportez-vous aux propriétés d’entrée dans le canvas et aux propriétés d’événement pour plus d’informations et d’exemples.

Objets imbriqués

Vous pouvez utiliser des objets imbriqués (objets à l’intérieur d’un autre objet) pour envoyer des données JSON imbriquées en tant que propriétés d’événements personnalisés et d’achats. Ces données imbriquées peuvent être utilisées pour créer des modèles d’informations personnalisées dans les messages, déclencher l’envoi de messages et segmenter les utilisateurs.

Pour en savoir plus, consultez notre page dédiée aux objets imbriqués.

Stockage des propriétés d’événement personnalisé

Les propriétés d’événement personnalisé sont conçues pour vous aider à améliorer le ciblage et à personnaliser davantage vos messages. Elles peuvent être stockées dans Braze à court et à long terme.

Vous pouvez effectuer une segmentation basée sur les valeurs des propriétés d’événement de plusieurs manières :

• Sur 30 jours : Vous pouvez utiliser la segmentation des propriétés d’événement en fonction de la fréquence et de la récence de valeurs spécifiques des propriétés d’événement au sein des segments Braze. Cette option a une incidence sur l’utilisation des données.
  
  
• Sur 30 jours et au-delà : Pour couvrir la segmentation des propriétés d’événement à court et à long terme, vous pouvez utiliser les extensions de segments. Cette fonctionnalité segmente les utilisateurs en fonction des événements personnalisés et des propriétés d’événement suivis au cours des deux dernières années. Cette option n’a aucune incidence sur l’utilisation des données.
  
  
• Canvas avec tableaux d’attributs personnalisés : Créez et lancez un Canvas déclenché par l’événement personnalisé. Configurez une étape Mise à jour de l’utilisateur qui utilise Ajouter un élément pour ajouter la propriété d’événement à un tableau d’attributs personnalisés sur le profil utilisateur, puis segmentez les utilisateurs à l’aide de filtres sur ce tableau d’attributs personnalisés plutôt que sur les filtres de propriétés d’événement. Cette option a une incidence sur l’utilisation des données, car chaque mise à jour du tableau d’attributs personnalisés consomme des points de données. Pour les détails d’implémentation, consultez les étapes de mise à jour de l’utilisateur dans Canvas et les tableaux d’attributs personnalisés.

Contactez votre Customer Success Manager Braze pour obtenir des recommandations sur la meilleure approche en fonction de vos besoins spécifiques.