Product

Oplossingen

Resources

Company

Product

Oplossingen

Resources

Company

G

G

M

M

Externe Data Sources

Breng externe dynamische data in html

Overzicht

Overzicht

Overzicht

Het integreren van externe gegevensbronnen in e-mailsjablonen maakt zeer gepersonaliseerde en dynamische inhoud mogelijk, wat de betrokkenheid en relevantie verbetert. Deze gids begeleidt je bij het instellen van externe gegevensbronnen en het gebruik ervan in je e-mailsjablonen.

Externe gegevensbronnen bieden dynamische inhoud aan je e-mailsjablonen door informatie op te halen van externe APIs. Dit is nuttig voor:

  • Het personaliseren van inhoud op basis van een externe feed

  • Het weergeven van real-time gegevens zoals vluchtstatus van een API

  • Het aanpassen van links door parameters door te geven en uiteindelijke links terug te krijgen via een extern hulpmiddel

Maak een externe gegevensbron

  • Navigeer naar de Marketing-app en klik op Content

  • Onder Content, klik op Externe gegevensbronnen > Externe gegevensbron maken


  • Je kunt het een naam geven. Dit moet een doorlopende reeks zijn zonder spaties

  • Geef de link voor je API

  • Bepaal of je wilt dat de inhoud dynamisch wordt bijgewerkt of handmatig wilt vernieuwen nadat deze aan de e-mail is toegevoegd en daarna niet wilt dat deze wordt bijgewerkt.

  • Je kunt ervoor kiezen om geen authenticatie te hebben of het type authenticatie te definiëren en ook eventuele headers toe te voegen


  • Zodra je klikt op Save Configuration, wordt de externe gegevensbron gemaakt

  • Nadat deze is gemaakt, kun je je configuratie testen om te zien welk resultaat je krijgt door op Test Config te klikken zoals hieronder weergegeven.

  • Navigeer naar de Marketing-app en klik op Content

  • Onder Content, klik op Externe gegevensbronnen > Externe gegevensbron maken


  • Je kunt het een naam geven. Dit moet een doorlopende reeks zijn zonder spaties

  • Geef de link voor je API

  • Bepaal of je wilt dat de inhoud dynamisch wordt bijgewerkt of handmatig wilt vernieuwen nadat deze aan de e-mail is toegevoegd en daarna niet wilt dat deze wordt bijgewerkt.

  • Je kunt ervoor kiezen om geen authenticatie te hebben of het type authenticatie te definiëren en ook eventuele headers toe te voegen


  • Zodra je klikt op Save Configuration, wordt de externe gegevensbron gemaakt

  • Nadat deze is gemaakt, kun je je configuratie testen om te zien welk resultaat je krijgt door op Test Config te klikken zoals hieronder weergegeven.

  • Navigeer naar de Marketing-app en klik op Content

  • Onder Content, klik op Externe gegevensbronnen > Externe gegevensbron maken


  • Je kunt het een naam geven. Dit moet een doorlopende reeks zijn zonder spaties

  • Geef de link voor je API

  • Bepaal of je wilt dat de inhoud dynamisch wordt bijgewerkt of handmatig wilt vernieuwen nadat deze aan de e-mail is toegevoegd en daarna niet wilt dat deze wordt bijgewerkt.

  • Je kunt ervoor kiezen om geen authenticatie te hebben of het type authenticatie te definiëren en ook eventuele headers toe te voegen


  • Zodra je klikt op Save Configuration, wordt de externe gegevensbron gemaakt

  • Nadat deze is gemaakt, kun je je configuratie testen om te zien welk resultaat je krijgt door op Test Config te klikken zoals hieronder weergegeven.

Externe gegevensbronnen gebruiken in e-mail


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.

Gebruik van externe gegevensbron voor het aanpassen van URLs

U kunt ook externe gegevensbronnen gebruiken samen met variabelen in de API-URL. Dit helpt om parameters door te geven aan een externe API en een reactie terug te geven die aan een e-mailsjabloon kan worden toegevoegd.

U kunt bijvoorbeeld een API-URL zoals hieronder gebruiken waarbij variabelen als volgt worden doorgegeven

https://api.bird.com/workspaces/?email={{email}}&referenceId={{referenceId}}&locale={{locale}}&name={{name}}

Om deze externe gegevensbron in een e-mailsjabloon te gebruiken, moet u ook de waarden van de variabelen opgeven in de liquid-tag:

  • Voeg het eerste html-element toe als {% datafetch "name", "variable1", "variable1 value", "variable2, "variable2 value" %}

In het onderstaande voorbeeld voorkomt de eerste regel problemen wanneer het e-mailadres een + teken bevat. De tweede regel start daadwerkelijk de externe gegevensstroom met de variabelen. U kunt statische waarden opgeven als "waarde" of u kunt variabele referenties geven zoals contact.attributes.userId.

{%- assign email_for_datafetch = contact.attributes.email_address | url_encode -%}
{% datafetch "GenerateLink","email", email_for_datafetch,"referenceId", contact.attributes.userId, "locale", contact.attributes.locales[0],"name", contact.attributes.name %}

GenerateLink is de naam van de externe gegevensbron hierboven.

  • Om een aangepaste link weer te geven, kunt u een knop-element gebruiken met de link gedefinieerd als {{dataFetchResponse.url}} waar url de reactie van uw API bevat


Hierna voegt u het sluitende html-element toe zoals hieronder:

{% enddatafetch %}
A person is standing at a desk while typing on a laptop.

Het complete AI-native platform dat met uw bedrijf meegroeit.

Product

Oplossingen

Resources

Company

Privacy instellingen

Binnenkort beschikbaar

Sociaal

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Signup

A person is standing at a desk while typing on a laptop.

Het complete AI-native platform dat met uw bedrijf meegroeit.

Product

Oplossingen

Resources

Company

Privacy instellingen

Sociaal

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Signup