Externe Data Sources

Zodra uw externe gegevensbron correct is opgezet, kunt u de output in de e-mailsjabloon gebruiken met behulp van de liquid-templatingtaal.

Externe gegevensbron gebruiken voor inhoudsfeed

Voor het tonen van een inhoudsfeed kunt u een API maken die een json geeft met veel items van de inhoudsfeed. Als voorbeeld kan het er als volgt uitzien:

{
  "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"
      }
    ]
  }
}

De bovenstaande json-feed kan worden gebruikt als een API-URL bij het maken van een externe gegevensbron.

Eenmaal gemaakt, kunt u er als volgt naar verwijzen in een e-mailsjabloon:

1. Voeg eerst een HTML-element toe en voeg onderstaande code toe om de externe gegevensbron op naam op te halen, d.w.z. {% datafetch "external-data-source-name" %}

2. Gebruik de for-functie in liquid om alle items in uw feed te krijgen, samen met het pad, d.w.z. {% for <your-item> in dataFetchResponse.<your-json-path> %}.

Als je maar één item hebt, is dit misschien niet nodig

Stel dat sample-data-feed de naam is van de externe gegevensbron en feed.items het pad in de json-feed is om de items te krijgen. Het ziet er dan als volgt uit:

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

• Als dit is toegevoegd, kun je vervolgens elk afbeeldings-, tekst-, knopelement toevoegen en verwijzen naar de externe gegevensbron zoals hieronder, ervan uitgaande de sample-data-feed structuur:

{{item.title}} - Om de titel in een tekstelement te tonen

{{item.description}} - Om de beschrijving in een tekstelement te tonen

{{item.link}} - Om een link toe te voegen in een knopelement

{{item.thumbnail}} - Om een afbeeldings-URL-bron toe te voegen in het afbeeldings элемент

• Voeg nu een ander HTML-blok toe om het ophalen van de externe gegevensbron en de for -functie zoals hieronder af te sluiten

{% endfor %}
{% enddatafetch %}

Om uw e-mail te bekijken, kunt u overschakelen naar de weergave en zien hoe uw inhoudsfeed eruitziet

Opmerking: als u een statische feed heeft, kunt u deze hier handmatig vernieuwen door de externe gegevensbron te selecteren in de vervolgkeuzelijst Vernieuwen externe gegevensbron.