Lookup Tables
Comment utiliser les tableaux de recherche
Les Lookup Tables sont un moyen pour vous de stocker des données que vous pouvez ensuite utiliser dans des Templates, Flows et Journeys. Créez vos Lookup Tables via le tableau de bord, puis référencez dynamiquement les données dans ces tables.
Les Lookup Tables dans Bird stockent et centralisent des références de données, qui peuvent être consultées lors de la création de modèles d'e-mail en utilisant le langage de modèle Liquid en HTML.
Par exemple, les drapeaux, abréviations ou devises de chaque pays peuvent être stockés et mis à jour de manière centrale en tant que table de consultation. Chaque fois qu'il est utilisé dans la création d'un e-mail, il peut être référencé depuis cette table de consultation.
Limitations importantes :
Chaque table peut contenir jusqu'à 10 éléments de données distincts.
Chaque élément peut contenir jusqu'à environ 300 ko de données.
Créer une Lookup Table
Utiliser la Lookup Table dans le modèle d'Email
Pour utiliser une table de correspondance dans un modèle d'e-mail, vous pouvez ajouter la syntaxe liquide suivante à votre modèle HTML ou à un élément HTML utilisé dans un générateur de glisser-déposer :
Voici,
variable_name est un nom que vous pouvez définir
lookup-table-slug est le slug que vous avez donné lors de la création de la table de correspondance
item-name est le nom de l'élément que vous avez créé
object-value est la valeur que vous avez donnée pour l'élément JSON
key_name est le nom de la clé dans la paire clé-valeur définie sous item-value
Par exemple,
Pour afficher la monnaie locale d'un pays défini, nous pouvons utiliser la syntaxe ci-dessous :
variable_name ici est défini comme currency (n'importe quel nom que l'utilisateur peut définir)
lookup-table-slug ici est country-flags tel que défini lors de la création de la table de correspondance
item-name est le country tel que créé précédemment et montré dans le volet de gauche
object-value est AD, qui est la valeur définie dans le JSON. Notez que cela peut aussi être une variable
key_name est la local_currency, qui est définie dans le JSON
Lorsqu'elle est utilisée dans le générateur de modèle d'e-mail dans un bloc HTML, la syntaxe ci-dessus affichera la valeur de la local_currency telle que stockée sous l'objet AD dans l'élément country de la table de correspondance country-flags
Vous pouvez passer à la section de prévisualisation pour voir la valeur de sortie affichée dynamiquement dans le modèle d'e-mail. Ci-dessous, elle montre EUR comme la valeur récupérée de la table de recherche.
Utilisation des tables de recherche dans Flows
Vous pouvez lire les tables de consultation dans Flows pour réutiliser les données définies centralement.
Pour utiliser une table de consultation, créez-en d'abord une comme décrit ci-dessus.
Accédez à Workflows > Flows
Créez un flux initial en utilisant un type de déclencheur de votre choix.
Ajoutez une nouvelle étape Effectuer une consultation à votre flux. Cliquez sur Ajouter une nouvelle action et sélectionnez-la soit dans le groupe Lookup Tables soit en la recherchant en utilisant la fonctionnalité de recherche à droite :
Un écran de configuration vous sera présenté où vous pourrez sélectionner la table à lire et configurer comment exactement vous souhaitez effectuer cette consultation :
Vous verrez trois composants que vous pouvez configurer :
Lookup Table Slug indique la table que vous souhaitez consulter. En cliquant dans ce champ, Flows vous montrera les tables de consultation disponibles :
Lookup vous permet de déterminer ce que vous voulez récupérer et vous pouvez utiliser les différentes variables disponibles pour construire cette clé de consultation. L'opération par défaut est de retourner la valeur que votre consultation pointe comme la valeur de niveau racine, mais si vous voulez créer un objet de données - vous pouvez utiliser la fonctionnalité As pour le charger dans une propriété spécifique :
Replace vous permet de remplacer les variables dans un résultat de consultation renvoyé par une valeur statique ou une valeur définie quelque part dans votre table de consultation. L'exemple suivant remplacerait le texte
{{ MyVariableName }}dans tout élément retourné avec l'action Lookup par la valeur qu'il trouve sous la cléreplacements.<locale>.MyVariableName:
En cliquant ensuite sur le bouton Test, vous pourrez voir les données résultantes :
Configurer la table à partir de laquelle lire est requis et vous devez ajouter au moins une action Lookup. Vous n'êtes pas obligé d'ajouter des actions Replace.
