Sources de données externes

Une fois que votre source de données externe est correctement configurée, vous pouvez utiliser sa sortie dans le modèle d'email en utilisant le langage de template liquid.

Utilisation de la source de données externe pour le flux de contenu

Pour afficher un flux de contenu, vous pouvez créer une API qui fournit un json avec plusieurs éléments du flux de contenu. À titre d'exemple, cela peut ressembler à ce qui suit :

{
  "feed": {
    "version": "1.0",
    "title": "sample-data-feed",
    "items": [
      {
        "title": "Meet the Full Cast",
        "link": "https://bird.com/article",
        "description": "See who's joining previously announced stars Katie Brayben and Christian Borle in the Elton John-Jake Shears-James Graham musical.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:21:00",
        "creator": "Joe Black"
      },
      {
        "title": "Stars in ASL American",
        "link": "https://bird.com/article",
        "description": "Center Theatre Group is teaming up with Deaf West Theatre to reopen the Mark Taper Forum with a new production of the Green Day musical after bringing revivals of Big River and Spring Awakening to Broadway.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:59:00",
        "creator": "Joe Black"
      }
    ]
  }
}

Le flux json ci-dessus peut être utilisé comme une URL d'API lors de la création d'une source de données externe.

Une fois créée, vous pouvez vous y référer dans un modèle d'email comme suit :

1. Tout d'abord, ajoutez un élément html et ajoutez le code ci-dessous pour récupérer la source de données externe par nom, c'est-à-dire {% datafetch "external-data-source-name" %}

2. Utilisez la fonction for dans liquid pour obtenir tous les éléments de votre flux ainsi que le chemin, c'est-à-dire {% for <your-item> in dataFetchResponse.<your-json-path> %}.

Si vous n'avez qu'un seul élément, cela peut ne pas être nécessaire

En supposant que sample-data-feed soit le nom de la source de données externe et que feed.items soit le chemin dans le flux json pour obtenir les éléments, cela ressemblera à ceci :

{% datafetch "sample-data-feed" %}
{% for item in dataFetchResponse.feed.items %}

• Après que cela soit ajouté, vous pouvez ensuite ajouter n'importe quel élément d'image, texte, bouton et vous référer à la source de données externe comme ci-dessous en supposant la structure sample-data-feed :

{{item.title}} - Pour afficher le titre dans un élément de texte

{{item.description}} - Pour afficher la description dans un élément de texte

{{item.link}} - Pour ajouter un lien dans un élément de bouton

{{item.thumbnail}} - Pour ajouter une source URL d'image dans un élément d'image

• Ajoutez maintenant un autre bloc html pour terminer la récupération de la source de données externe et la fonction for comme montré ci-dessous

{% endfor %}
{% enddatafetch %}

Pour prévisualiser votre email, vous pouvez passer à la prévisualisation et voir à quoi ressemble votre flux de contenu

Remarque : Si vous avez un flux statique, vous pouvez le rafraîchir ici manuellement en sélectionnant la source de données externe sous la liste déroulante Rafraîchir la source de données externe.