Skip to content

Propriétés d’événement personnalisé

Cet article décrit les propriétés d’événement personnalisé, leur format attendu, comment les utiliser pour l’envoi de messages et la segmentation, ainsi que le stockage des 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.

Les propriétés d’événement personnalisé ne sont pas stockées sur le profil Braze et ne consomment donc pas de points de donnée (voir Points de donnée pour les exceptions).

Format attendu

Les valeurs des propriétés doivent être un objet : les clés sont les noms des propriétés (chaînes de caractères non vides, 255 caractères maximum, sans $ en début), et les valeurs sont les valeurs des propriétés. Pour les types de données pris en charge, les exigences de format et les limites de PAYLOAD, consultez Types de données.

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

Clés réservées

Vous ne pouvez pas utiliser de 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 renvoie l’erreur « Invalid ‘properties’ field ».

Utilisation 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 affiner davantage votre audience pour une campagne ou un Canvas particulier. Par exemple, si vous avez une application e-commerce et souhaitez envoyer un message à un utilisateur lorsqu’il abandonne son panier, vous pouvez ajouter une propriété d’événement personnalisé price pour améliorer votre audience cible et permettre une personnalisation accrue de la campagne.

Filtres de propriétés d'événement personnalisé pour un panier abandonné. Deux filtres sont combinés avec un opérateur AND pour envoyer cette campagne aux utilisateurs qui ont abandonné leur panier avec un prix compris entre 100 et 200 dollars

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

Filtres de propriétés d'événement personnalisé pour un panier abandonné. Un filtre est sélectionné si un article du panier a un prix supérieur à 100 dollars.

Personnaliser les messages

Vous pouvez également utiliser les propriétés d’événement personnalisé pour la personnalisation dans le modèle de message. 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 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 en utilisant 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înent la distribution des messages in-app en tant que messages in-app modélisés, consultez la Foire aux questions.

Considérations relatives aux filtres

  • Appels API : Lors d’appels API utilisant le filtre « 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 vide ».
  • Nombres entiers : Lors du filtrage sur une propriété d’événement personnalisé de type nombre dont la valeur est très grande, n’utilisez pas le filtre « exactement ». Si un nombre est trop grand, il peut être arrondi à une certaine longueur, et votre filtre ne fonctionnera pas comme prévu.

Segmentation

Utilisez la segmentation par propriétés d’événement pour cibler les utilisateurs en fonction des événements personnalisés réalisé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 d’événement pour les é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 accédant à 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 consultation maximum de 30 jours.

Ajouter des propriétés d’événement pour la segmentation

Vous avez besoin de l’autorisation utilisateur « Edit Custom Event Property Segmentation » 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 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. Activez le bouton Activer la segmentation pour ajouter la propriété d’événement à la segmentation. Des options de filtrage supplémentaires seront alors disponibles lors de la segmentation.

Les filtres de segmentation par propriétés d’événement incluent :

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

Un groupe de filtres avec « Abandoned Cart » ayant la propriété « number of items » 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 son activation, et les propriétés d’événement ne sont disponibles qu’à partir de cette date.

Points de donnée

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ée distincts, en plus du point de donnée comptabilisé 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 Canvas et propriétés d’événement

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

Les propriétés d’entrée de Canvas correspondent aux propriétés que vous mappez pour les canvas basés sur des actions ou déclenchés par API. Notez que l’objet canvas_entry_properties a une taille maximale limite de 50 KB.

Vous pouvez faire référencecontextà n’importe quelle étape de message avec ce format Liquid : context.${property_name}. Notez que les événements doivent être des événements personnalisés ou des événements d’achat pour être utilisés de cette manière.

Cas d’utilisation

Supposons qu’un magasin de détail, RetailApp, ait la demande suivante : \"context\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}.

RetailApp peut extraire le nom du produit (chaussures) dans un message à l’aide de ce Liquid : {{context.${product_name}}}.

RetailApp peut également déclencher l’envoi de messages spécifiques pour différentes propriétés d’ product_name dans un canvas qui cible les utilisateurs après qu’ils aient déclenché un événement d’achat. Par exemple, ils peuvent envoyer des messages différents aux utilisateurs qui ont acheté des chaussures et à ceux qui ont acheté autre chose en ajoutant le liquide suivant dans une étape Message.

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 %}
Expand for original Canvas editor

Vous ne pouvez plus créer ou dupliquer des toiles à l’aide de l’éditeur original. Cette section n’est disponible qu’à titre de référence. Pour les canevas créés à l’aide de l’éditeur d’origine, les propriétés d’entrée du canevas ne peuvent être référencées que dans la première étape complète d’un canevas.

Les propriétés d’événement font référence aux propriétés que vous définissez pour les événements personnalisés et les achats. Ces event_properties peuvent être utilisés dans des campagnes avec livraison/distribution par événement et Canvases.

Dans Canvas, les propriétés d’événement personnalisé et d’événement d’achat peuvent être utilisées dans Liquid dans n’importe quelle étape Message qui suit une étape du parcours d’action. Veuillez vous assurer d’utiliser {{event_properties.${property_name}}} si vous faites référence à ces propriétés d’événement. Ces événements doivent être des événements personnalisés ou d’achat pour être utilisés ainsi dans le composant de message.

Dans la première étape du message suivant un parcours d’action, vous pouvez utiliser les propriétés d’événement associées à l’événement référencé dans ce parcours d’action. Cependant, ces propriétés d’événement ne peuvent être utilisées que si l’utilisateur a réellement effectué l’action (et n’a pas été classé dans le groupe « Tout le monde »). Vous pouvez disposer d’autres étapes (n’étant pas un autre parcours d’action ou une étape de message) entre ce parcours d’action et l’étape de message.

Expand for original Canvas editor

Vous ne pouvez plus créer ou dupliquer des toiles à l’aide de l’éditeur original. Cette section n’est disponible qu’à titre de référence. Dans l’éditeur Canvas d’origine, les propriétés d’événement ne peuvent pas être utilisées dans les étapes complètes de planification. Cependant, vous pouvez utiliser les propriétés d’événement dans la première étape complète d’un canevas basé sur une action, même si la planification de l’étape complète est en cours.

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 (des 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 des envois 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 à augmenter la précision du ciblage et rendre les messages encore plus personnalisés. Les propriétés d’événement personnalisé peuvent être stockées dans Braze à court et à long terme.

Vous pouvez segmenter en fonction des valeurs des propriétés d’événement de deux manières :

  1. Sur 30 jours : Vous pouvez utiliser la segmentation par propriétés d’événement basée sur la fréquence et la récence de valeurs spécifiques de propriétés d’événement dans les segments Braze. Cette option a un impact sur l’utilisation des données.

  2. Au-delà de 30 jours : Pour couvrir la segmentation par 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 pas d’impact sur l’utilisation des données.

Contactez votre gestionnaire de la satisfaction client Braze pour obtenir des recommandations sur la meilleure approche en fonction de vos besoins spécifiques.
New Stuff!