](https://learning.braze.com/custom-events-and-attributes){: style=”float:right;width:120px;border:0;” class=”noimgborder”} É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 entreprises 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

Voici quelques cas d’utilisation courants d’événements personnalisés :

• 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 à l’aide des rapports d’entonnoir et de rétention (si utilisés).
• 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 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 allant dans 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 :

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/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 de l’événement personnalisé et modifiez 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’à 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.

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.

Enregistrement 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 présente les filtres disponibles pour segmenter les utilisateurs en fonction des événements personnalisés.

Analyse/analytique (si utilisé comme adjectif)

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.

Graphique du nombre d’événements personnalisés sur la page des événements personnalisés dans le tableau de bord montrant les tendances pour un événement personnalisé.](/docs/fr/assets/img_archive/custom_event_analytics_example.png?345ada8684baf98a23ceb1a80341f24b “custom_event_analytics_example.png”)

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.

!Filtres personnalisés pour le graphe des événements](/docs/fr/assets/img/custom_events_report_filters.png?1d90154e20771cf6113270af7a715ef1){: style=”max-width:40%;”}

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 d’é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 n’enregistrent 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 non vides de 255 caractères au maximum, sans signe de dollar ($).

Les valeurs des propriétés peuvent correspondre à 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.

Utilisation des propriétés d’événement personnalisées

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.

Messages déclenchés

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 item price pour améliorer votre public cible et permettre une personnalisation accrue de la campagne.

!Filtres personnalisés de propriétés d’événement pour une carte abandonnée. Deux filtres sont combinés avec un opérateur AND pour envoyer cette campagne aux utilisateurs qui ont abandonné leur carte avec un prix d’article compris entre 100 et 200 dollars.](/docs/fr/assets/img_archive/customEventProperties.png?ea43a1d707eeb105300cf9be90e5934c “customEventProperties.png”)

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

!Filtres personnalisés de propriétés d’événement pour une carte abandonnée. Un filtre est sélectionné si l’un des articles du panier a un prix supérieur à 100 dollars.](/docs/fr/assets/img_archive/customEventPropertiesNested.png?bc1654df91b2b3ade45a725b2e5a38d2 “customEventPropertiesNested.png”)

Personnaliser les messages

Vous pouvez également utiliser des propriétés d’événement personnalisées pour la personnalisation du modèle d’envoi de 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é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 obtenir 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 effectuez des appels API et que vous utilisez le filtre “is blank”, 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 vierges”.
• Entiers : Lorsque vous filtrez pour un nombre de propriétés d’événement personnalisé et que ce nombre est très grand, n’utilisez pas le filtre “exactement”. Si un nombre est trop grand, il peut être arrondi à une certaine longueur, de sorte que votre filtre ne fonctionnera pas comme prévu.

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ées utilisées dans certains filtres de segmentation ont un historique maximum de 30 jours.

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

Vous devez disposer des autorisations utilisateur “Gérer la segmentation personnalisée des événements” pour créer des segments basés sur la récurrence et la fréquence des événements.

Par défaut, vous pouvez avoir 20 propriétés d’événement segmentation par espace de travail. Contactez votre gestionnaire de compte 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. Cochez la case Activer la segmentation pour ajouter la propriété d’événement pour la segmentation. Vous pouvez 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 le bien A d’une valeur B, X fois au cours des Y derniers jours.
• Ajoute la possibilité de segmentation dans un délai de 1 à 30 jours.

!Un groupe de filtre qui a ‘Abandon de panier’ avec la propriété ‘number of itmes’ et la valeur 2 plus d’une fois au cours des 30 derniers jours calendaires.

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 l’utilisation des abonnements, 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 distincts en plus du point de données compté 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 dans le canvas et propriétés d’événement

You can use Canvas entry properties and event properties in your Canvas user journeys.

• canvas entry properties
• event properties

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 %}

Refer to Canvas entry properties and event properties for more information and examples.

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 modéliser des 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 personnalisé des propriétés d’événement

Les propriétés d’événement personnalisées sont conçues pour vous aider à améliorer la précision du ciblage et à rendre les messages encore plus personnalisés. Les propriétés d’événements personnalisés 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. Dans les 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. Dans les 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 satisfaction client de Braze pour obtenir des recommandations sur la meilleure approche en fonction de vos besoins spécifiques.