Propriétés du contexte et de l’événement
Cet article de référence fournit des informations au sujet de
contextetevent_properties, y compris les moments dans lesquels il faut utiliser chaque propriété, y compris les différences entre leurs comportements.
Pour plus d’informations sur les propriétés d’événements personnalisés en général, consultez la rubrique Propriétés d’événements personnalisés.
Les propriétés d’entrée canvas font partie des variables de contexte canvas. Cela signifie quecanvas_entry_properties est référencé comme context. Chaque variable context comprend un nom, un type de données et une valeur qui peut inclure Liquid. Actuellement,canvas_entry_properties sont rétrocompatibles. Pour plus de détails, veuillez vous référer aux sections Contexte et Objet de contexte canvas.
Les propriétés de contexte et les propriétés d’événement fonctionnent différemment dans vos workflows canvas. Les propriétés d’événements ou d’appels API qui déclenchent l’entrée d’un utilisateur dans un Canvas sont connues sous le nom de context. Les propriétés des événements qui se produisent lorsqu’un utilisateur se déplace dans un parcours Canvas sont appelées event_properties. La différence clé est que context ne se concentre pas uniquement sur les événements en accédant également aux propriétés des charges utiles d’entrée dans les canevas déclenchés par l’API.
Veuillez vous référer au tableau suivant pour obtenir un résumé des différences entre les propriétés de contexte et les propriétés d’événement.
| Propriétés contextuelles | Propriétés de l’événement | |
|---|---|---|
| Liquid | context |
event_properties |
| Persistance | Peut être référencé par toutes les étapes Message pendant toute la durée d’un canvas créé à l’aide de Canvas. | - Elle ne peut être référencée qu’une seule fois. - Elle ne peut pas être référencée par des étapes de messagerie suivantes. |
| Comportement des toiles | Vous pouvez référencer context à toutes les étapes d’un Canvas. Pour le comportement après le lancement, reportez-vous à la section Modifier les canvas après le lancement. |
- Peut faire référence à event_properties dans la première étape Message après une étape Parcours d’action où l’action entreprise est un événement personnalisé ou un événement d’achat. - Elles ne peuvent pas se trouver après un parcours « Tous les autres » de l’étape de parcours d’action. - Il peut y avoir d’autres composants que des messages entre les parcours d’action et les étapes des messages. Si l’un de ces composants autres que Message est une étape Parcours d’action, l’utilisateur peut passer par le parcours « Tous les autres » de ce parcours d’action. |
Original Canvas editor details
Vous ne pouvez plus créer ou dupliquer des toiles à l’aide de l’éditeur original. Veuillez noter que le contexte canvas n’est pas pris en charge dans l’éditeur canvas d’origine. Cette section est donc disponible à titre de référence lorsque vous utilisez les propriétés d’entrée et les propriétés d’événement canvas pour le workflow canvas précédent.
Propriétés de l’entrée de la toile :
- Les propriétés d’entrées persistantes doivent être activées.
- Vous ne pouvez référencer les
canvas_entry_propertiesque dans la première étape complète d’un Canvas. Le Canvas doit être par événement ou déclenché par API.
Propriétés d’entrée :
- Vous pouvez référencer
event_propertiesdans toutes les étapes complètes utilisant la livraison par événement dans un Canvas. - Elles ne peuvent pas être utilisées dans les étapes complètes planifiées n’étant pas la première étape complète d’un Canvas par événement. Toutefois, si un utilisateur utilise un composant canvas, le comportement suit les règles actuelles du flux de travail canvas pour
event_properties.
Propriétés d’événement :
- Impossible d’utiliser
event_propertiesdans l’étape du message principal. Au lieu de cela, vous devez utilisercanvas_entry_propertiesou ajouter une étape de parcours d’action avec l’événement correspondant avant l’étape Message qui inclutevent_properties.
Choses à savoir
- Le contexte est uniquement disponible à titre de référence dans Liquid. Pour filtrer sur les propriétés du canvas, utilisez plutôt la segmentation des propriétés d’événement.
- Pour les canaux de message in-app, vous pouvez faire référence à
contextetevent_propertiesdans un Canvas.event_propertiesest accessible lorsqu’il est inclus dans la première étape du canvas, car il est basé sur un déclencheur. - Vous ne pouvez pas utiliser les
event_propertiesdans la première étape de message. Vous pouvez également utilisercontextou ajouter une étape Parcours d’action avec l’événement correspondant avant l’étape Message qui inclutevent_properties. - Lorsqu’une étape du parcours action contient un déclencheur “Envoi d’un message SMS entrant” ou “Envoi d’un message WhatsApp entrant”, les étapes du canvas suivantes peuvent inclure une propriété SMS ou WhatsApp Liquid. Cela reflète le fonctionnement des propriétés d’événement dans Canvases. Vous pouvez ainsi tirer parti de vos messages pour enregistrer et référencer des données first-party sur les profils utilisateurs et les envois de messages conversationnels.
L’admissibilité de l’audience est évaluée une fois à l’entrée dans canvas. Si un utilisateur est fusionné lors de son entrée, l’utilisateur identifié poursuit son parcours dans le canvas et n’est pas réévalué par rapport aux critères du segment de Canvas.
Il n’est pas nécessaire d’utiliser une étape Contexte pour référencer les propriétés de l’événement déclencheur dans les étapes du parcours d’audience ou de l’arbre décisionnel. Vous pouvez référencer les propriétés directement dans les groupes de filtres à l’aide du filtre Variable de contexte. Veuillez vous assurer de sélectionner le type de données approprié.
Horodatage des déclencheurs
Si vous utilisez des horodatages avec un type datetime provenant d’événements qui sont des déclencheurs d’actions de déclenchement pour des canevas basés sur des actions, qui sont référencés à l’aide du contexte, les horodatages sont normalisés en UTC.
Compte tenu de ce comportement, Braze vous recommande vivement d’utiliser un filtre de fuseau horaire liquide tel que l’exemple suivant pour garantir l’envoi de vos messages avec votre fuseau horaire préféré.
1
{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}
Exceptions
- Les horodatages ne sont pas normalisés à UTC dans la première étape d’un canvas si cette étape est une étape de message.
- Les horodatages ne sont pas normalisés à UTC dans toute étape du Message utilisant le canal message in-app, quel que soit son ordre dans le Canvas.
Cas d’utilisation
Pour mieux comprendre les différences entrecontextet event_properties, examinons ce scénario dans lequel les utilisateurs accèdent à un canvas basé sur une action s’ils effectuent l’événement personnalisé « ajouter un article à la liste de souhaits ».
Le contexte est configuré à l’étape de planification de l’entrée lors de la création d’un canevas et correspond au moment où un utilisateur accède à un canevas. Le contexte peut également être référencé dans n’importe quelle étape de message.
Dans ce canvas, nous avons un parcours utilisateur qui commence par une étape Parcours d’action pour déterminer si un utilisateur a ajouté un article à sa liste de souhaits. À partir de là, si l’utilisateur a ajouté un article, il constate un délai avant de recevoir le message « Nouvel article dans votre liste de souhaits ! » à l’étape Message.
La première étape Message d’un parcours client a accès à la personnalisationevent_propertiesde votre étape du parcours d’action. Dans ce cas, nous sommes en mesure d’inclure {{event_properties.${property_name}}} dans cette étape Message en tant que partie du contenu de notre message. Si un utilisateur n’ajoute pas d’élément à sa liste de souhaits, il suit le chemin « Tout le monde », ce qui signifie que l’élémentevent_propertiesne peut pas être référencé et renvoie une erreur de paramètres non valides.
Prenez en compte le fait que vous n’aurez accès aux event_properties que si votre étape de message peut être remontée jusqu’à un parcours n’étant pas « Tous les autres » dans l’étape du parcours d’action. Si l’étape Message est connectée à un chemin Tout le monde, mais qu’elle peut être retracée jusqu’à une étape Parcours d’action dans le parcours utilisateur, vous avez également toujours accès à event_properties. Pour plus d’informations sur ces comportements, veuillez consulter l’étape Message.
Modifier cette page sur GitHub