Externe Datenquellen

Sobald Ihre externe Datenquelle korrekt eingerichtet ist, können Sie deren Ausgaben im E-Mail-Template mithilfe der Liquid-Templating-Sprache verwenden.

Verwendung einer externen Datenquelle für Content-Feed

Um einen Content-Feed anzuzeigen, können Sie eine API erstellen, die ein JSON mit vielen Elementen des Content-Feeds liefert. Beispielsweise kann es wie unten aussehen:

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

Der oben genannte JSON-Feed kann als API-URL verwendet werden, während eine externe Datenquelle erstellt wird.

Sobald er erstellt ist, können Sie ihn in einem E-Mail-Template wie folgt referenzieren:

1. Fügen Sie zuerst ein HTML-Element hinzu und fügen Sie den unten stehenden Code hinzu, um die externe Datenquelle nach Name abzurufen, d.h. {% datafetch "external-data-source-name" %}

2. Verwenden Sie die for-Funktion in Liquid, um alle Elemente in Ihrem Feed zusammen mit dem Pfad zu erhalten, d.h. {% for <your-item> in dataFetchResponse.<your-json-path> %}.

Wenn Sie nur ein Element haben, ist dies möglicherweise nicht erforderlich.

Angenommen, sample-data-feed ist der Name der externen Datenquelle und feed.items ist der Pfad im JSON-Feed, um die Elemente abzurufen, wird es wie unten aussehen:

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

• Nachdem dies hinzugefügt wurde, können Sie jedes Bild-, Text-, und Schaltflächenelement hinzufügen und auf die externe Datenquelle verweisen, wie unten dargestellt, unter Berücksichtigung der sample-data-feed-Struktur:

{{item.title}} - Um den Titel in einem Textelement anzuzeigen

{{item.description}} - Um die Beschreibung in einem Textelement anzuzeigen

{{item.link}} - Um einen Link in einem Schaltflächenelement hinzuzufügen

{{item.thumbnail}} - Um eine Bild-URL-Quelle in einem Bildelement hinzuzufügen

• Fügen Sie nun einen weiteren HTML-Block hinzu, um das Abrufen der externen Datenquelle und die for-Funktion wie unten gezeigt zu beenden

{% endfor %}
{% enddatafetch %}

Um Ihre E-Mail-Vorschau anzuzeigen, können Sie zur Vorschau wechseln und sehen, wie Ihr Content-Feed aussieht.

Hinweis: Wenn Sie einen statischen Feed haben, können Sie ihn hier manuell aktualisieren, indem Sie die externe Datenquelle im Dropdown-Menü „Externe Datenquelle aktualisieren“ auswählen.