Cet article vous guidera à travers les paramètres et la manière d'utiliser les placeholders et les segment splits pour les DataDocs.
Introduction
Lorsque vous souhaitez utiliser des DataDocs dans un parcours ou un Campaign Manager, vous devez indiquer au départ les documents que vous souhaitez utiliser pour le flux. Les documents ciblés au départ pour chaque contact seront disponibles pour les placeholders (pour afficher du 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 DataDocs dans votre segment de départ, les contacts devront donc remplir les conditions de ces 2 filtres afin d'entrer dans le parcours.
Placeholders
Pour afficher les données, vous devez vous référer à la balise 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 vous souhaitez faire afficher le premier ou le dernier document trouvé, vous pouvez le faire à l'aide de ces handlebars :
{{#documents}}{{#if @first}}Welcome to {{event}}!{{/if}}{{/documents}}
{{#documents}}{{#if @last}}Welcome to {{event}}!{{/if}}{{/documents}}
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 issue #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, si vous avez mis à jour les documents et que vous souhaitez afficher la version actualisée, vous pouvez utilisez la fonction snapshot="CURRENT":
{{#documents snapshot="CURRENT"}} Your issue #{{tickedId}} is {{ticket.status}}. {{/documents}}
Your issue #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 segment splits évalueront toujours les conditions sur la base des données actuelles. Cela signifie que vous pouvez configurer des segment splits pour déterminer le reste du flux sur la base de vos données actualisées.
Exemple
Ce parcours enverra des courriels avant un événement sportif.
Le segment de départ cible tous les contacts qui devraient entrer dans le parcours.
Le filtre DataDocs sur le starter 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 starter) :
Si un contact possède plusieurs documents correspondant à la condition, tous les documents suivront le contact dans son parcours.
Le premier courriel du parcours 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.
Historique des messages
Si vous souhaitez que les éléments dynamiques affichés en provence des DataDocs soient conservés via l'historique des messages ou encore via les liens de type view as a web page, vous devez activer la fonctionnalité Message Cloud sur votre compte. Veuillez contacter votre chargé(e) de compte pour en savoir plus à ce sujet.