Événements personnalisés

Cet article décrit les événements/ 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 de vos utilisateurs. 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 réception/distribution basée sur l’action.
• Segmentation des utilisateurs en fonction du nombre de fois qu’ils ont effectué un événement personnalisé, de la date à laquelle l’événement s’est produit pour la dernière fois, etc.
• L’utilisation du tableau de bord d’analyse/analytique personnalisé des événements permet de visualiser un agrégat de la fréquence de chaque événement.
• Trouver des analyses/analytiques supplémentaires en utilisant les 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érer des analyses/analytiques plus sophistiquées avec Currents (si utilisé comme adjectif)
• Mise en place d’ événements d’exception Canvas pour définir quand les utilisateurs ne doivent pas passer à l’étape suivante de 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’à 10 é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/boîte de dialogue 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 fournissez les informations que vous souhaitez, par exemple une note à l’intention de votre équipe.

Ajout d’étiquettes

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

Consultation des rapports d’utilisation

Le rapport d’utilisation répertorie toutes les toiles, campagnes et segments utilisant un événement personnalisé spécifique. La liste ne comprend pas les utilisations du liquide.

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

Exporter 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. Vous y 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 d’é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.

Analyse

Braze note 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 la rubrique Analytics > Custom Events Report (si vous utilisez un événement personnalisé).

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 voir comment vos campagnes ont affecté 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’analyse/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ées sont des métadonnées ou des attributs d’événement personnalisés 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/analytiques 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 ne consomment donc pas de points données (voir Points 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 les valeurs des propriétés. Les noms de propriétés doivent être des chaînes de caractères non vides de moins de 255 caractères, 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 une charge utile de propriété d’événement allant jusqu’à 100 Ko.

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.

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ées 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é de cart value pour améliorer votre public cible et permettre une plus grande personnalisation de la campagne.

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

Personnaliser des messages

Vous pouvez également utiliser des propriétés d’événement personnalisé pour personnaliser les messages. Toute campagne utilisant livraison par événement avec un événement déclencheur peut utiliser les propriétés d’événement personnalisées 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é pour 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 rubrique Foire aux questions.

Considérations relatives aux filtres

• Appels API : Lorsque vous faites des appels API et que vous utilisez le filtre « is blank » (est vide), une propriété de l’événement personnalisée est considérée comme « vide » si elle est exclue de l’appel. Par exemple, si vous deviez inclure "event_property": "", alors vos utilisateurs seraient considérés comme « non vides ».
• Entiers : Lorsque vous filtrez selon une quantité de propriétés d’événement personnalisé et que cette valeur est très importante, n’utilisez pas le filtre « exactement ». Si la quantité est trop importante, elle peut être arrondie à une certaine longueur et votre filtre ne fonctionnera donc pas comme vous l’attendez.

Segmentation

Utilisez la segmentation des propriétés d’événements pour cibler les utilisateurs en fonction des événements personnalisés pris 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 de 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.

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 le bien A d’une valeur B, X fois au cours des Y derniers jours.
• Ajoute la capacité de segmenter sur 1, 3, 7, 14, 21 et 30 jours.

Les données ne sont enregistrées pour une propriété d’événement donnée qu’après avoir été activées par votre gestionnaire de la satisfaction client, et les propriétés d’événement ne sont disponibles qu’à partir de cette date.

Points de données

En ce qui concerne les inscriptions, 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 de l’événement Canvas

Vous pouvez utiliser canvas_entry_properties et event_properties dans vos parcours utilisateurs Canvas. 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.

• propriétés d'entrée de canvas
• propriétés d'événement

1
2
3
4
5
6
{% if  {{canvas_entry_properties.${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 %}

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 de propriété d’événement personnalisé

Les propriétés de l’événement personnalisé sont conçues pour vous aider améliorer le ciblage et à personnaliser davantage vos messages. Les propriétés de l’événement personnalisé 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 deux manières :

1. Sur 30 jours : Le personnel d’assistance de Braze peut activer la segmentation des propriétés d’événement en fonction de la fréquence et de la récurrence des valeurs de propriétés d’événement spécifiques au sein des segments de Braze. Si vous souhaitez exploiter les propriétés d’événement au sein des segments, contactez votre gestionnaire de compte Braze ou votre gestionnaire satisfaction client. Cette option aura un impact sur l’utilisation des données.
   
   
2. 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’aura pas d’incidence sur l’utilisation des données.

Contactez votre gestionnaire du succès des clients Braze pour obtenir des recommandations sur la meilleure approche en fonction de vos besoins spécifiques.