G

G

M

M

Lookup Tables

Comment utiliser les tableaux de recherche

Vue d'ensemble

Vue d'ensemble

Vue d'ensemble

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

Allez à Contenu > Tables de consultation et cliquez sur Créer.

  • Entrez un nom d'affichage

  • Entrez un slug sans espaces



Le slug est utilisé pour référencer cette table et peut seulement contenir des caractères alphanumériques. Notez que ce slug est utilisé dans la référence du modèle d'email

  • Cliquez sur Enregistrer



Créer un élément dans une table

Cliquez sur la table que vous avez créée

Dans le menu contextuel qui apparaît, sélectionnez "Voir"



Chaque élément dans une table est essentiellement un document JSON. Cela signifie que vous pouvez construire une structure en arbre de clés et de valeurs, où les valeurs peuvent être du texte, des chiffres, des booléens, des tableaux ou des objets eux-mêmes. Vous pouvez soit entrer un document JSON directement, en utilisant la syntaxe JSON soit utiliser un éditeur UI pour construire le document JSON.

Éditeur JSON

  • Une fois que vous avez enregistré, vous verrez un éditeur JSON. Vous pouvez sélectionner soit l'éditeur de texte soit l'éditeur UI en fonction de votre préférence.

  • Mettre à jour la table de consultation en utilisant une structure JSON.

Ajouter un élément

Pour ajouter un élément dans un JSON pour l'organisation, cliquez sur +Ajouter Élément dans le volet de gauche.

  • Entrez un nom en haut

  • Cliquez sur le bouton Ajouter Élément

  • Une fois créé, vous pouvez voir l'élément créé dans le volet de gauche.

Écrire le JSON

Utilisez le format JSON pour définir toute structure d'objet et paires clé-valeur ci-dessous :

Par exemple, un JSON qui donne le nom du pays et la devise locale en fonction de l'abréviation du pays

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Vous pouvez également utiliser l'éditeur UI pour définir la structure JSON.


Allez à Contenu > Tables de consultation et cliquez sur Créer.

  • Entrez un nom d'affichage

  • Entrez un slug sans espaces



Le slug est utilisé pour référencer cette table et peut seulement contenir des caractères alphanumériques. Notez que ce slug est utilisé dans la référence du modèle d'email

  • Cliquez sur Enregistrer



Créer un élément dans une table

Cliquez sur la table que vous avez créée

Dans le menu contextuel qui apparaît, sélectionnez "Voir"



Chaque élément dans une table est essentiellement un document JSON. Cela signifie que vous pouvez construire une structure en arbre de clés et de valeurs, où les valeurs peuvent être du texte, des chiffres, des booléens, des tableaux ou des objets eux-mêmes. Vous pouvez soit entrer un document JSON directement, en utilisant la syntaxe JSON soit utiliser un éditeur UI pour construire le document JSON.

Éditeur JSON

  • Une fois que vous avez enregistré, vous verrez un éditeur JSON. Vous pouvez sélectionner soit l'éditeur de texte soit l'éditeur UI en fonction de votre préférence.

  • Mettre à jour la table de consultation en utilisant une structure JSON.

Ajouter un élément

Pour ajouter un élément dans un JSON pour l'organisation, cliquez sur +Ajouter Élément dans le volet de gauche.

  • Entrez un nom en haut

  • Cliquez sur le bouton Ajouter Élément

  • Une fois créé, vous pouvez voir l'élément créé dans le volet de gauche.

Écrire le JSON

Utilisez le format JSON pour définir toute structure d'objet et paires clé-valeur ci-dessous :

Par exemple, un JSON qui donne le nom du pays et la devise locale en fonction de l'abréviation du pays

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Vous pouvez également utiliser l'éditeur UI pour définir la structure JSON.


Allez à Contenu > Tables de consultation et cliquez sur Créer.

  • Entrez un nom d'affichage

  • Entrez un slug sans espaces



Le slug est utilisé pour référencer cette table et peut seulement contenir des caractères alphanumériques. Notez que ce slug est utilisé dans la référence du modèle d'email

  • Cliquez sur Enregistrer



Créer un élément dans une table

Cliquez sur la table que vous avez créée

Dans le menu contextuel qui apparaît, sélectionnez "Voir"



Chaque élément dans une table est essentiellement un document JSON. Cela signifie que vous pouvez construire une structure en arbre de clés et de valeurs, où les valeurs peuvent être du texte, des chiffres, des booléens, des tableaux ou des objets eux-mêmes. Vous pouvez soit entrer un document JSON directement, en utilisant la syntaxe JSON soit utiliser un éditeur UI pour construire le document JSON.

Éditeur JSON

  • Une fois que vous avez enregistré, vous verrez un éditeur JSON. Vous pouvez sélectionner soit l'éditeur de texte soit l'éditeur UI en fonction de votre préférence.

  • Mettre à jour la table de consultation en utilisant une structure JSON.

Ajouter un élément

Pour ajouter un élément dans un JSON pour l'organisation, cliquez sur +Ajouter Élément dans le volet de gauche.

  • Entrez un nom en haut

  • Cliquez sur le bouton Ajouter Élément

  • Une fois créé, vous pouvez voir l'élément créé dans le volet de gauche.

Écrire le JSON

Utilisez le format JSON pour définir toute structure d'objet et paires clé-valeur ci-dessous :

Par exemple, un JSON qui donne le nom du pays et la devise locale en fonction de l'abréviation du pays

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Vous pouvez également utiliser l'éditeur UI pour définir la structure JSON.


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 :

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

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

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

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.

  1. Accédez à Workflows > Flows

  2. 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 :

  1. Lookup Table Slug indique la table que vous souhaitez consulter. En cliquant dans ce champ, Flows vous montrera les tables de consultation disponibles :

  1. 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 :

  1. 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.


Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.

Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.

Connectons-vous avec un expert Bird.
Découvrez toute la puissance du Bird en 30 minutes.

En soumettant, vous acceptez que Bird puisse vous contacter au sujet de nos produits et services.

Vous pouvez vous désabonner à tout moment. Consultez la Déclaration de confidentialité de Bird pour plus de détails sur le traitement des données.

R

Atteindre

G

Grow

M

Manage

A

Automate

Company

Newsletter

Restez à jour avec Bird grâce aux mises à jour hebdomadaires dans votre boîte de réception.