Skip to content

Variables de contexte

Les variables de contexte sont des données temporaires que vous pouvez créer et utiliser dans le cadre du parcours d’un utilisateur dans un Canvas spécifique. Ils vous permettent de personnaliser les délais, de segmenter les utilisateurs de manière dynamique et d’enrichir les messages sans modifier de manière permanente les informations de profil d’un utilisateur. Les variables de contexte n’existent qu’au sein de la session Canvas et ne persistent pas entre les différents Canvas ou en dehors de la session.

Fonctionnement des variables de contexte

Les variables de contexte peuvent être définies de deux manières :

  • A l’entrée de la toile : Lorsque les utilisateurs entrent dans un Canvas, les données de l’événement ou du déclencheur API peuvent automatiquement alimenter les variables de contexte.
  • Dans une étape de Contexte : Vous pouvez définir ou mettre à jour les variables de contexte manuellement dans le canvas en ajoutant une étape Contexte.

Chaque variable contextuelle comprend

  • Un nom (tel que flight_time ou subscription_renewal_date)
  • Un type de données (comme un nombre, une chaîne de caractères, une heure ou un tableau).
  • Une valeur que vous attribuez à l’aide de Liquid ou de l’outil Ajouter une personnalisation.

Une fois définie, vous pouvez utiliser une variable contextuelle dans l’ensemble du canvas en y faisant référence sous la forme suivante : {{context.${example_variable_name}}}.

Par exemple, {{context.${flight_time}}} pourrait renvoyer l’heure du vol planifié de l’utilisateur.

Chaque fois qu’un utilisateur entre dans le canvas - même s’il l’a déjà fait auparavant - les variables contextuelles seront redéfinies en fonction des dernières données d’entrée et de la configuration du canvas. Cette approche par état permet à chaque entrée de Canvas de conserver son propre contexte indépendant, ce qui permet aux utilisateurs d’avoir plusieurs états actifs au sein d’un même parcours tout en conservant le contexte spécifique à chaque état.

Par exemple, si un client a deux vols à venir, il aura deux états de parcours distincts en cours d’exécution simultanément, chacun avec ses propres variables de contexte spécifiques au vol, comme l’heure de départ et la destination. Cela vous permet d’envoyer des rappels personnalisés sur leur vol de 14 heures pour New York tout en envoyant des mises à jour différentes sur leur vol de 8 heures pour Los Angeles demain, de sorte que chaque message reste pertinent pour la réservation spécifique.

Considérations

Vous pouvez définir jusqu’à 10 variables de contexte par étape de contexte. Chaque nom de variable peut comporter jusqu’à 100 caractères et ne doit utiliser que des lettres, des chiffres ou des traits de soulignement.

Les définitions des variables contextuelles peuvent comporter jusqu’à 10 240 caractères. Si vous transmettez des variables de contexte dans un canevas déclenché par l’API, elles partagent le même espace de noms que les variables créées dans une étape du canevas. Par exemple, si vous envoyez une variable purchased_item dans l’objet contexte de l’endpoint/canvas/trigger/send , vous pouvez la référencer en tant que {{context.${purchased_item}}}. Si vous redéfinissez cette variable dans une étape Contexte, la nouvelle valeur remplacera la valeur API pour le parcours de cet utilisateur.

Vous pouvez stocker jusqu’à 50 Ko par étape de Contexte, répartis sur un maximum de 10 variables. Si la taille totale de toutes les variables d’une étape dépasse 50 Ko, les variables qui dépassent cette limite ne seront ni évaluées ni stockées. Par exemple, si vous avez trois variables dans une étape Contexte :

  • Variable 1 : 30 KB
  • Variable 2 : 19 KB
  • Variable 3 : 2 Ko

La variable 3 ne sera pas évaluée ni stockée car la somme des variables précédentes dépasse 50 KB.

Types de données

Les variables contextuelles créées ou mises à jour au cours de l’étape peuvent se voir attribuer les types de données suivants.

Par défaut, le type de données de l’heure est en UTC. Si vous utilisez un type de données chaîne de caractères pour stocker une valeur temporelle, vous pouvez définir l’heure comme un fuseau horaire différent tel que PST.

Par exemple, si vous envoyez un message à un utilisateur la veille de son anniversaire, vous enregistrerez la variable contextuelle en tant que type de données temporel, car la logique liquide est associée à l’envoi la veille. Toutefois, si vous envoyez un message de vacances le jour de Noël (25 décembre), vous n’aurez pas besoin de référencer l’heure en tant que variable dynamique. Il est donc préférable d’utiliser un type de données de type chaîne de caractères.

Utilisation de variables contextuelles

Vous pouvez utiliser des variables de contexte partout où vous utilisez des liquides dans un canvas, comme dans les étapes Message et Mise à jour de l’utilisateur, en sélectionnant Ajouter une personnalisation.

Par exemple, supposons que vous souhaitiez informer les passagers de leur accès au salon VIP avant leur prochain vol. Ce message ne doit être envoyé qu’aux passagers ayant acheté un billet de première classe. Une variable de contexte est un moyen souple de suivre ces informations.

Les utilisateurs entreront dans la toile lorsqu’ils achèteront un billet d’avion. Pour déterminer l’admissibilité à l’accès au salon, nous créerons une variable contextuelle appelée lounge_access_granted dans une étape Contexte, puis nous ferons référence à cette variable contextuelle dans les étapes suivantes du parcours de l’utilisateur.

Variable contextuelle mise en place pour déterminer si un passager a droit à l'accès au salon VIP.

Dans cette étape du Contexte, nous utiliserons {{custom_attribute.${purchased_flight}}} pour déterminer si le type de vol qu’ils ont acheté est first_class.

Ensuite, nous allons créer une étape Message pour cibler les utilisateurs pour lesquels {{context.${lounge_access_granted}}} est true. Ce message sera une notification push qui comprendra des informations personnalisées sur le salon. En fonction de cette variable contextuelle, les passagers éligibles recevront les messages pertinents avant leur vol.

  • Les passagers du billet de première classe recevront “Profitez d’un accès exclusif au salon VIP !
  • Les passagers de la classe affaires et de la classe économique recevront “Surclassez votre vol pour bénéficier d’un accès exclusif au salon VIP.

Une étape Message avec différents messages à envoyer, selon le type de billet d'avion acheté.

Pour les parcours d’action et les critères de sortie

Vous pouvez exploiter la comparaison des filtres de propriétés avec des variables de contexte ou des attributs personnalisés dans ces actions de déclenchement : Réaliser un événement personnalisé et effectuer un achat. Ces déclencheurs d’action prennent également en charge les filtres de propriété pour les propriétés de base et les propriétés imbriquées.

  • Lors de la comparaison avec les propriétés de base, les comparaisons disponibles correspondront au type de propriété défini par l’événement personnalisé. Par exemple, les propriétés de chaînes de caractères auront des correspondances d’expression régulière exactement égales. Les propriétés booléennes seront vraies ou fausses.
  • Lors de la comparaison avec des propriétés imbriquées, les types ne sont pas prédéfinis. Vous pouvez donc sélectionner des comparaisons entre plusieurs types de données pour les booléens, les nombres, les chaînes de caractères, l’heure et le jour de l’année, comme pour les comparaisons avec des attributs personnalisés imbriqués. Si vous sélectionnez un type de données qui ne correspond pas au type de données réel de la propriété imbriquée au moment de la comparaison, l’utilisateur ne correspondra pas au parcours d’action ou aux critères de sortie.

Exemples de parcours d’action

Le parcours d’action suivant est mis en place pour trier les utilisateurs qui ont effectué l’événement personnalisé Account_Created avec la propriété de base source vers la variable contextuelle app_source_variable.

Exemple de parcours d'action faisant référence à une variable de contexte lors de l'exécution d'un événement personnalisé.

Le parcours d’action suivant est mis en place pour faire correspondre la propriété de base brand pour le nom de produit spécifique shoes à une variable de contexte promoted_shoe_brand.

Exemple de parcours d'action faisant référence à une variable de contexte lors d'un achat.

Exemples de critères de sortie

Les critères de sortie stipulent qu’à tout moment du parcours d’un utilisateur dans le Canvas, il quittera le Canvas si :

  • Ils exécutent l’événement personnalisé “ Abandon de panier” et
  • La propriété de base Item in Cart correspond à la valeur chaîne de caractères de la variable de contexte cart_item_threshold.

Critères de sortie mis en place pour quitter un utilisateur s'il effectue un événement personnalisé basé sur la variable de contexte.

Les critères de sortie stipulent qu’à tout moment du parcours d’un utilisateur dans le Canvas, il quittera le Canvas si

  • Ils effectuent un achat spécifique pour le nom du produit “livre”, et
  • La propriété d’achat “loyalty_program” est égale à l’attribut personnalisé “VIP” de l’utilisateur.

Critères de sortie mis en place pour quitter un utilisateur s'il effectue un achat.

Filtres de variables contextuelles

Vous pouvez créer des filtres qui utilisent des variables de contexte préalablement déclarées dans les étapes Parcours d’audience et Arbre décisionnel.

Les variables de contexte sont déclarées et accessibles uniquement dans la portée d’un Canvas, ce qui signifie qu’elles ne peuvent pas être référencées dans des segments. Les filtres d’audience fonctionnent de la même manière dans les parcours d’audience et les étapes décisionnelles. Les parcours d’audience représentent des groupes multiples, tandis que les étapes décisionnelles représentent des décisions binaires.

Exemple d'étape décisionnelle avec la possibilité de créer un filtre avec une variable de contexte.

De la même manière que les variables contextuelles de Canvas ont des types prédéfinis, les comparaisons entre les variables contextuelles et les valeurs statiques doivent avoir des types de données correspondants. Le filtre de variables contextuelles permet d’effectuer des comparaisons entre plusieurs types de données pour les booléens, les nombres, les chaînes de caractères, l’heure et le jour de l’année, de manière similaire aux comparaisons pour les attributs personnalisés imbriqués.

Voici un exemple de filtre de variable contextuelle comparant la variable contextuelle product_name à l’expression régulière /braze/.

Configuration d'un filtre pour la variable contextuelle "product_name" correspondant à l'expression régulière "/braze/".

Comparaison avec des variables de contexte ou des attributs personnalisés

En basculant l’option Comparer à une variable de contexte ou à un attribut personnalisé, vous pouvez construire des filtres de variables de contexte qui se comparent à des variables de contexte préalablement définies ou à des attributs personnalisés de l’utilisateur. Cela peut être utile pour effectuer des comparaisons dynamiques par utilisateur, comme celles déclenchées par l’API context, ou pour condenser une logique de comparaison complexe définie à travers des variables de contexte.

Imaginons que vous souhaitiez envoyer un rappel personnalisé aux utilisateurs après une période d’inactivité dynamique, ce qui inclut que toute personne ne s’étant pas connectée à votre appli au cours des trois derniers jours, devrait recevoir un message.

Vous disposez d’une variable de contexte re_engagement_date définie comme {{now | minus: 3 | append: ' days'}}. Notez que 3 days peut être un montant variable qui est également stocké en tant qu’attribut personnalisé de l’utilisateur. Ainsi, si le re_engagement_date se trouve après le last_login_date (stocké en tant qu’attribut personnalisé sur le profil utilisateur), un message lui sera envoyé.

Une configuration de filtre avec des attributs personnalisés comme type de personnalisation pour la variable de contexte "re_engagement_date" après l'attribut personnalisé "last_login_date".

Le filtre suivant compare la variable contextuelle reminder_date à la variable contextuelle appointment_deadline. Cela peut aider à regrouper les utilisateurs dans une étape de parcours d’audience afin de déterminer s’ils doivent recevoir des rappels supplémentaires avant la date limite de leur rendez-vous.

Une configuration de filtre avec des variables de contexte comme type de personnalisation pour la variable de contexte "reminder_date" sur la variable de contexte "appointment_deadline".

Normalisation de la cohérence des fuseaux horaires

Bien que la plupart des propriétés d’événement utilisant le type d’horodatage soient déjà en UTC dans Canvas, il y a quelques exceptions. Avec l’ajout de Canvas Context, toutes les propriétés d’événement d’horodatage par défaut dans les canevas basés sur l’action seront systématiquement en UTC. Cette modification s’inscrit dans le cadre d’un effort plus large visant à garantir une expérience plus prévisible et plus cohérente lors de la modification des étapes du canvas et des messages. Notez que ce changement aura un impact sur toutes les toiles basées sur des actions, que la toile spécifique utilise une étape du canvas ou non.

Articles connexes
Github   Modifier cette page sur GitHub
New Stuff!