Actualiser les données du profil dans Canvas avant l’envoi

Quand un parcours dure des jours ou des semaines, les données du profil peuvent changer après l’entrée de l’utilisateur dans le Canvas. Utilisez une étape Contexte pour rechercher l’objet correspondant sur le profil, puis orientez la communication avec des parcours d’audience ou un arbre décisionnel.

À propos de cet exemple

ClaimsJumpr, une marque d’assurance fictive, lance un Canvas par événement lorsqu’une police arrive à 28 jours de son renouvellement. Pendant ces 28 jours, ClaimsJumpr envoie plusieurs rappels. Après son entrée dans le Canvas, l’assuré peut modifier le renouvellement automatique de cette police. Les messages qui s’appuient uniquement sur les propriétés d’entrée du Canvas risquent donc d’indiquer un statut erroné.

Chaque profil utilisateur stocke les polices dans un attribut personnalisé de type tableau d’objets (policies). Chaque objet contient le policy_id unique présent dans l’événement déclencheur, ainsi qu’une valeur auto_renewal (opted_in ou opted_out). Dans cet exemple, une étape Contexte est ajoutée avant les étapes Message suivantes. Liquid lit ainsi l’objet actuel dans policies en le faisant correspondre au policy_id stocké dans le contexte du Canvas (l’événement d’entrée).

Ce scénario :

1. Conserve le policy_id d’entrée dans le contexte du Canvas.
2. Utilise une étape Contexte et le filtre Liquid where pour sélectionner l’objet correspondant dans policies.
3. Stocke auto_renewal dans une variable de contexte (auto_renewal) de type String.
4. Oriente le contenu des messages à l’aide des filtres de variables de contexte des Parcours d’audience ou de l’Arbre décisionnel, et non en dupliquant une logique Liquid d’annulation dans cet article.

Considérations

• Testez le Canvas dans un espace de travail hors production, y compris avec des profils où auto_renewal est absent d’un objet.
• Les valeurs policy_id dans policies doivent être uniques pour que where renvoie un seul objet.
• Si un autre Canvas utilise une étape Mise à jour utilisateur pour écrire policies à partir du même événement déclencheur, le profil risque de ne pas être mis à jour avant le premier message. Pour la première étape Message après l’entrée, utilisez les propriétés de contexte d’entrée. Utilisez cette étape Contexte pour les étapes suivantes, une fois que la mise à jour du profil a eu le temps de s’appliquer.
• Les noms de variables de contexte ne peuvent contenir que des lettres, des chiffres et des traits de soulignement (jusqu’à 100 caractères). Vous pouvez définir jusqu’à 10 variables par étape Contexte.
• Le code Liquid de cet article est fourni à titre d’exemple. Prévisualisez les parcours utilisateur et effectuez des envois de test avec vos propres noms et valeurs d’attributs.

Configuration

Cet exemple suppose les éléments suivants :

Étape 1 : Placer une étape Contexte avant les messages suivants

Dans le Canvas, ajoutez une étape Contexte juste avant les étapes Message qui doivent refléter le statut actuel du renouvellement automatique. Ne vous fiez pas uniquement aux propriétés d’entrée pour ces envois ultérieurs.

Étape 2 : Définir la variable de contexte

Dans l’étape Contexte :

1. Définissez Nom de la variable de contexte sur auto_renewal.
2. Définissez le type de données sur Chaîne de caractères.
3. Saisissez du code Liquid qui sélectionne la police correspondante, puis renvoie auto_renewal. N’entourez pas la source de assign de balises {{ }} supplémentaires.

1
2

{% assign matched_policies = custom_attribute.${policies} | where: "policy_id", context.${policy_id} %}
{{ matched_policies[0].auto_renewal }}

context.${policy_id} est la propriété de l’événement d’entrée, disponible en tant que variable de contexte. where conserve les objets dont le policy_id correspond à cette valeur. L’étape Contexte enregistre le champ auto_renewal de la première correspondance.

4. Sélectionnez Aperçu et vérifiez la valeur pour un utilisateur test dont policies contient ce policy_id.

Pour connaître les limites relatives au nom, au type et au code Liquid, consultez Contexte et Variables de contexte.

Étape 3 : Créer des branches à partir de la variable de contexte

Après l’étape Contexte, répartissez les utilisateurs à l’aide d’un filtre Parcours d’audience ou Arbre décisionnel sur auto_renewal (par exemple, égal à opted_in ou à opted_out). Placez le rappel correspondant sur chaque parcours.

Conseil

Pour la configuration des filtres et la correspondance des types de données, consultez Filtres de variables de contexte. Pour comprendre comment les groupes sont évalués, consultez Parcours d’audience et Arbre décisionnel.

Si vous interrompez un envoi dans une étape Message au lieu de créer des branches, l’utilisateur passe tout de même à l’étape suivante du Canvas. Pour plus de détails, consultez Interrompre des messages et Progression des utilisateurs.

Étape 4 : Prévisualiser et tester

Utilisez l’aperçu des parcours utilisateur et des envois de test pour les cas suivants :

• auto_renewal avec la valeur opted_in et opted_out sur l’objet correspondant
• Un policy_id absent de policies (valeur de contexte vide)
• Un objet sans auto_renewal

Vérifiez que les rappels ultérieurs correspondent au profil, et pas seulement au statut au moment de l’entrée dans le Canvas.

Articles connexes

• Contexte
• Variables de contexte
• Propriétés d’entrée du canvas
• Parcours d’audience
• Arbre décisionnel
• Étape Message
• Interrompre des messages
• Tableau d’objets
• Mise à jour de l’utilisateur