Propriétés de contexte et d’événement

Cet article de référence couvre les informations relatives à context et event_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.

Important

La terminologie et l’espace de noms Liquid affichés dépendent des fonctionnalités disponibles dans votre espace de travail :

• Si le tableau de bord affiche Context Variables, référencez les propriétés d’entrée avec context, par exemple {{context.${property_name}}}. Vous pouvez également créer ou mettre à jour des variables avec une étape Context.
• Si le tableau de bord affiche Canvas Entry Properties, référencez-les avec canvas_entry_properties, par exemple {{canvas_entry_properties.${property_name}}}. L’étape Context et le filtre Context Variable ne sont pas disponibles.
  
  Pour en savoir plus, consultez les sections Contexte et Propriétés de contexte et d’événement. Si vous avez besoin d’accéder au contexte Canvas, contactez votre gestionnaire de la satisfaction client.

Les propriétés de contexte et les propriétés d’événement fonctionnent différemment au sein de vos flux de travail Canvas. Dans les espaces de travail disposant du contexte 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 disponibles sous la forme context. Si votre espace de travail affiche plutôt Canvas Entry Properties, les mêmes données d’entrée utilisent l’ancien espace de noms canvas_entry_properties. Les propriétés des événements qui se produisent lorsqu’un utilisateur progresse dans un parcours Canvas sont appelées event_properties.

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.

Informations importantes

• Vous pouvez référencer le contexte en Liquid. Si Variable de contexte est disponible comme filtre dans votre espace de travail, vous pouvez également utiliser le contexte dans les filtres Canvas pris en charge. Sinon, utilisez la segmentation par propriétés d’événement.
• Pour les canaux de messages in-app, vous pouvez référencer context et event_properties dans un Canvas. event_properties est 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 event_properties dans l’étape Message initiale. À la place, vous pouvez utiliser context ou ajouter une étape de parcours d’action avec l’événement correspondant avant l’étape Message qui inclut event_properties.
• Lorsqu’une étape de parcours d’action 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. De cette façon, vous pouvez tirer parti de vos messages pour enregistrer et référencer des données first-party sur les profils utilisateur et la communication conversationnelle.

Remarque

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 à travers le Canvas et n’est pas réévalué par rapport aux critères de segment du Canvas.

Conseil

Si le filtre Context Variable est disponible dans votre espace de travail, vous n’avez pas besoin d’une étape Contexte pour référencer les propriétés de l’événement déclencheur dans les étapes Parcours d’audience ou Arbre décisionnel. Vous pouvez référencer les propriétés directement dans les groupes de filtres. Veillez à sélectionner le type de données approprié.

Horodatages

Tous les horodatages dans Canvas sont normalisés en UTC. Compte tenu de ce comportement, Braze recommande fortement d’utiliser un filtre de fuseau horaire Liquid, comme dans l’exemple suivant, afin que vos messages soient envoyés dans votre fuseau horaire préféré.

1

{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}

Cas d’usage

Pour mieux comprendre les différences entre context et event_properties, considérons ce scénario où les utilisateurs entrent dans un Canvas par événement lorsqu’ils effectuent l’événement personnalisé « ajouter un article à la liste de souhaits ».

Les données d’entrée sont configurées dans l’étape Planification d’entrée et correspondent au moment où un utilisateur entre dans un Canvas. Dans les espaces de travail avec Canvas Context, ces données sont disponibles en tant que context et peuvent être référencées dans n’importe quelle étape de message. Dans les autres espaces de travail, le tableau de bord nomme ces données Propriétés d’entrées Canvas et utilise canvas_entry_properties.

Dans ce Canvas, nous avons un parcours utilisateur qui commence par une étape de 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 observe un délai avant de recevoir un message « Nouvel article dans votre liste de souhaits ! » de l’étape de message.

La première étape de message dans un parcours utilisateur a accès aux event_properties personnalisées de votre étape de parcours d’action. Dans ce cas, nous pouvons inclure {{event_properties.${property_name}}} dans cette étape de message en tant que contenu du message. Si un utilisateur n’ajoute pas d’article à sa liste de souhaits, il passe par le parcours Everyone Else, 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 de message peut être reliée à un parcours autre que Everyone Else dans une étape de parcours d’action. Si l’étape de message est connectée à un parcours Everyone Else mais peut être reliée à une étape de parcours d’action dans le parcours utilisateur, vous avez toujours accès aux event_properties. Pour plus d’informations sur ces comportements, consultez Étape de message.