Propriétés de contexte et d’événement
Cet article de référence couvre les informations relatives à
contextetevent_properties, notamment quand utiliser chaque propriété et les différences de comportement.
Pour des informations générales sur les propriétés d’événements personnalisés, consultez 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 que canvas_entry_properties est référencé en tant que context. Chaque variable context comprend un nom, un type de données et une valeur pouvant inclure du Liquid. Actuellement, canvas_entry_properties reste rétrocompatible. Pour plus de détails, consultez les sections Contexte et Objet de contexte Canvas.
Les propriétés de contexte et les propriétés d’événement fonctionnent différemment au sein de vos workflows Canvas. Les propriétés des événements ou des appels API qui déclenchent l’entrée d’un utilisateur dans un Canvas sont appelées context. Les propriétés des événements qui se produisent lorsqu’un utilisateur progresse dans un parcours Canvas sont appelées event_properties. La différence principale est que context ne se limite pas aux événements : il permet également d’accéder aux propriétés des PAYLOAD d’entrée dans les Canvas déclenchés par API.
Consultez le tableau suivant pour un résumé des différences entre les propriétés de contexte et les propriétés d’événement.
| Propriétés de contexte | Propriétés d’événement | |
|---|---|---|
| Liquid | context |
event_properties |
| Persistance | Peuvent être référencées par toutes les étapes Message pendant toute la durée d’un Canvas. | - Ne peuvent être référencées qu’une seule fois. - Ne peuvent pas être référencées par les étapes Message suivantes. |
| Comportement dans Canvas | Vous pouvez référencer context dans n’importe quelle étape d’un Canvas. Pour le comportement après le lancement, consultez Modifier les Canvas après le lancement. |
- Vous pouvez référencer event_properties dans la première étape Message après une étape Parcours d’actions où l’action effectuée est un événement personnalisé ou un événement d’achat. - Ne peut pas se trouver après le parcours Tous les autres de l’étape Parcours d’actions. - D’autres composants non-Message peuvent se trouver entre les étapes Parcours d’actions et Message. Si l’un de ces composants non-Message est une étape Parcours d’actions, l’utilisateur peut emprunter le parcours Tous les autres de ce parcours d’actions. |
Détails de l’éditeur Canvas d’origine
Vous ne pouvez plus créer ni dupliquer de Canvas avec l’éditeur d’origine. Notez 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 pour l’utilisation des propriétés d’entrée Canvas et des propriétés d’événement dans l’ancien workflow Canvas.
Propriétés d’entrée Canvas :
- Les propriétés d’entrée persistantes doivent être activées.
- Vous ne pouvez référencer
canvas_entry_propertiesque dans la première étape complète d’un Canvas. Le Canvas doit être basé sur une action ou déclenché par API.
Propriétés d’entrée :
- Vous pouvez référencer
event_propertiesdans n’importe quelle étape complète utilisant la livraison par événement dans un Canvas. - Ne peuvent pas être utilisées dans les étapes complètes planifiées autres que la première étape complète d’un Canvas basé sur une action. Cependant, si un utilisateur utilise un composant Canvas, le comportement suit les règles actuelles du workflow Canvas pour
event_properties.
Propriétés d’événement :
- Vous ne pouvez pas utiliser
event_propertiesdans l’étape Message initiale. Vous devez plutôt utilisercanvas_entry_propertiesou ajouter une étape Parcours d’actions avec l’événement correspondant avant l’étape Message qui inclutevent_properties.
Points importants
- Le contexte n’est disponible que pour référence dans Liquid. Pour filtrer sur les propriétés au sein du Canvas, utilisez plutôt la segmentation par propriétés d’événement.
- Pour les canaux de messages in-app, vous pouvez référencer
contextetevent_propertiesdans un Canvas.event_propertiesest accessible lorsqu’il est inclus dans la première étape du Canvas, car celle-ci est basée sur un déclencheur. - Vous ne pouvez pas utiliser
event_propertiesdans l’étape Message initiale. Vous pouvez plutôt utilisercontextou ajouter une étape Parcours d’actions avec l’événement correspondant avant l’étape Message qui inclutevent_properties. - Lorsqu’une étape Parcours d’actions contient un déclencheur « A envoyé un message entrant SMS » ou « A envoyé un message entrant WhatsApp », les étapes Canvas suivantes peuvent inclure une propriété Liquid SMS ou WhatsApp. Cela reflète le fonctionnement des propriétés d’événement dans les Canvas. Vous pouvez ainsi exploiter vos messages pour enregistrer et référencer des données first-party sur les profils utilisateur et la messagerie conversationnelle.
L’éligibilité de l’audience est évaluée une seule fois à l’entrée dans le Canvas. Si un utilisateur est fusionné pendant l’entrée, l’utilisateur identifié continue dans le Canvas et n’est pas réévalué par rapport aux critères de segment du 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é.
Horodatages pour les déclencheurs
Si vous utilisez des horodatages avec un type datetime provenant d’événements qui déclenchent des Canvas basés sur une action, référencés via context, les horodatages sont normalisés en UTC.
Compte tenu de ce comportement, Braze recommande fortement d’utiliser un filtre Liquid de fuseau horaire comme dans l’exemple suivant pour garantir que vos messages sont envoyés 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 en UTC dans la première étape d’un Canvas si cette étape est une étape Message.
- Les horodatages ne sont pas normalisés en UTC dans les étapes Message utilisant le canal de message in-app, quel que soit leur ordre dans le Canvas.
Cas d’utilisation
Pour mieux comprendre les différences entre context et event_properties, considérons ce scénario où les utilisateurs entrent dans un Canvas basé sur une action lorsqu’ils effectuent l’événement personnalisé « ajouter un article à la liste de souhaits ».
Le contexte est configuré dans l’étape Planification d’entrée lors de la création d’un Canvas et correspond au moment où un utilisateur entre dans un Canvas. Le contexte peut également être référencé dans n’importe quelle étape Message.
Dans ce Canvas, le parcours utilisateur commence par une étape Parcours d’actions pour déterminer si un utilisateur a ajouté un article à sa liste de souhaits. Si c’est le cas, l’utilisateur passe par un délai avant de recevoir le message « Nouvel article dans votre liste de souhaits ! » depuis l’étape Message.
La première étape Message d’un parcours utilisateur a accès aux event_properties personnalisées de votre étape Parcours d’actions. Dans ce cas, nous pouvons inclure {{event_properties.${property_name}}} dans cette étape Message comme partie du contenu de notre message. Si un utilisateur n’ajoute pas d’article à sa liste de souhaits, il emprunte le parcours Tous les autres, ce qui signifie que les event_properties ne peuvent pas être référencées et génèrent une erreur de paramètres invalides.
Notez que vous n’aurez accès aux event_properties que si votre étape Message peut être retracée jusqu’à un parcours autre que Tous les autres dans une étape Parcours d’actions. Si l’étape Message est connectée à un parcours Tous les autres mais peut être retracée jusqu’à une étape Parcours d’actions dans le parcours utilisateur, vous conservez tout de même l’accès aux event_properties. Pour plus d’informations sur ces comportements, consultez Étape Message.