Cet article vous guidera à travers les paramètres et la manière d'utiliser les placeholders et les séparations de segments (segment split) pour la DataDocs.
Introduction
Lorsque vous souhaitez utiliser des DataDocs dans Journeys ou Campaign Manager, vous devez indiquer au départ les documents que vous souhaitez utiliser pour le flux. Les documents ciblés pour chaque contact seront disponibles pour les placeholders (pour rendre le contenu) ou les segment splits*.
Pour les départs déclenchés par l'API, vous devez inclure les documents dans votre appel..
Pour tous les départs exécutés par un segment, vous ciblerez les documents sur le filtre DataDocs (DataDocs filter).
Important! Le segment de départ ciblera vos contacts spécifiques et le filtre DataDocs récupérera tous les documents filtrés et les stockera pour chaque contact pour l'ensemble de votre flux.
Vous pouvez choisir d'inclure les conditions de votre filtre dans votre segment de départ, mais sachez que toutes les conditions de votre filtre doivent alors correspondre à un contact. Par exemple, en fonction de votre flux, vous pourriez avoir besoin de construire un segment qui inclut les DataDocs et de les refléter dans le filtre.
Placeholders
Pour afficher les données, vous devez vous référer à documents :
{{documents}} Welcome to {{event}}! {{/documents}}
Chaque document pointé par le filtre dans le départ sera rendu, c'est-à-dire que si deux documents sont trouvés, le code ci-dessus sera rendu de la manière suivante :
Welcome to Mongoose FC - Pumba FC
Welcome to Circus Salsa
Si votre filtre pointe vers des documents de différents types et que vous souhaitez les afficher différemment, vous pouvez spécifier un contenu différent à l'aide de l'identifiant du type :
{{#documents typeId="38"}}Welcome to {{event}}{{/documents}}
{{#documents typeId="39"}}Your issue #{{ticketId}} is {{ticket.status}}.{{/documents}}
Welcome to Mongoose FC - Pumba FC
Your support ticket ABC-123 is in progress.
Les documents filtrés seront affichés tels qu'ils étaient lors de leur entrée dans le flux, même si les documents ont été mis à jour.
Si, par la suite, vous avez mis à jour les documents et que vous souhaitez rendre la version actualisée, vous utilisez la fonction snapshot="CURRENT":
{{#documents snapshot="CURRENT"}} Your issue #{{tickedId}} is {{ticket.status}}. {{/documents}}
Your support ticket ABC-123 is solved.
Pour afficher les données dans un objet JSON, il suffit d'écrire le entity_name.attribute_name, par exemple :
{{event_details.location}}
Vous pouvez bien sûr transformer vos données en utilisant les handlebar helpers:
{{date "MMMM d" event_date}}
Segment splits
Si un contact a entré un flux avec des données qui ont été mises à jour pendant le trajet, le handlebar affichera toujours les données entrantes (sauf indication contraire). Cependant, les divisions de segments évalueront toujours les conditions sur la base des données actuelles. Cela signifie que vous pouvez configurer des divisions de segments pour déterminer le reste du flux sur la base de vos données actualisées.
Exemple
Ce journey enverra des courriels avant un événement sportif.
Le segment de départ cible tous les contacts qui devraient participer au journey.
Le filtre DataDocs sur le démarreur stocke tous les documents dont la date d'événement est dans sept jours et dont la catégorie est "sport" (pour tous les contacts correspondant aux critères du démarreur) :
Si un contact possède plusieurs documents correspondant à la condition, tous les documents suivront le contact dans son journey.
Le premier courriel du journey comprendra des informations générales sur l'événement :
Le jour de l'événement, nous avons mis en place un dernier rappel. À ce stade, nous voulons nous assurer que toutes les mises à jour d'un événement sont affichées, ce qui signifie que nous ne voulons pas rendre le document tel qu'il était lors de l'entrée dans le flux.
Par conséquent, nous mettons à jour le placeholder et lui demandons de récupérer le document tel qu'il se présente actuellement (utilisant "snapshot="CURRENT"):
{{documents snapshot="CURRENT"}}
It is time for {{event}}....
{{/documents}}
Si l'une des valeurs a été mise à jour depuis l'entrée dans le flux, par exemple si l'heure de début de l'événement a été déplacée d'une heure, les valeurs les plus récentes seront alors affichées.
* Puisque les documents spécifiques à chaque contact sont déjà récupérés par le starter, aucun segment de contenu n'est nécessaire pour rendre les données correctes. Si vous avez l'habitude de travailler avec la segmentation du contenu et les espaces réservés pour l'historique des achats, cela change la donne.