Zewnętrzne źródła danych

Gdy Twoje zewnętrzne źródło danych jest poprawnie skonfigurowane, możesz użyć jego wyników w szablonie e-mail za pomocą języka szablonowego liquid.

Użycie zewnętrznego źródła danych do zasilania treści

Aby pokazać kanał treści, możesz utworzyć API, które zwraca json z wieloma elementami kanału treści. Na przykład może to wyglądać następująco:

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

Powyższy kanał json może być użyty jako URL API podczas tworzenia zewnętrznego źródła danych.

Po utworzeniu możesz odwołać się do niego w szablonie e-mail w następujący sposób:

1. Najpierw dodaj element html i dodaj poniższy kod, aby pobrać zewnętrzne źródło danych według nazwy, tj. {% datafetch "external-data-source-name" %}

2. Użyj funkcji for w liquid, aby uzyskać wszystkie elementy w Twoim kanale wraz ze ścieżką, tj. {% for <your-item> in dataFetchResponse.<your-json-path> %}.

Jeśli masz tylko jeden element, może to nie być potrzebne

Zakładając, że sample-data-feed to nazwa zewnętrznego źródła danych, a feed.items to ścieżka w kanale json do uzyskania elementów, będzie to wyglądało następująco:

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

• Po dodaniu tego możesz dodać dowolne elementy obrazu, tekstu, przycisku i odwołać się do zewnętrznego źródła danych jak poniżej, zakładając strukturę sample-data-feed:

{{item.title}} - Aby pokazać tytuł w elemencie tekstowym

{{item.description}} - Aby pokazać opis w elemencie tekstowym

{{item.link}} - Aby dodać link w elemencie przycisku

{{item.thumbnail}} - Aby dodać źródło URL obrazu w elemencie obrazu

• Teraz dodaj kolejny blok html, aby zakończyć pobieranie zewnętrznego źródła danych i funkcję for pokazaną poniżej

{% endfor %}
{% enddatafetch %}

Aby zobaczyć podgląd swojego e-maila, możesz przełączyć się do podglądu i zobaczyć, jak wygląda Twój kanał treści

Uwaga: Jeśli masz statyczny kanał, możesz go tutaj ręcznie odświeżyć, wybierając zewnętrzne źródło danych w rozwijanym menu Odśwież zewnętrzne źródło danych.