Fonti di dati esterne

Una volta che la tua fonte di dati esterna è stata configurata correttamente, puoi utilizzare il suo output nel modello di email utilizzando il linguaggio di modelli liquid.

Utilizzo di una Fonte di Dati Esterna per il Feed di Contenuti

Per mostrare un feed di contenuti, puoi creare un'API che fornisce un json con molti elementi del feed di contenuti. Come esempio, potrebbe apparire come segue:

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

Il feed json sopra può essere utilizzato come URL API durante la creazione di una fonte di dati esterna.

Una volta creata, puoi riferirti ad essa in un modello di email come segue:

1. Prima aggiungi un elemento html e aggiungi il codice sottostante per ottenere la fonte di dati esterna per nome, cioè {% datafetch "external-data-source-name" %}

2. Utilizza la funzione for in liquid per ottenere tutti gli elementi nel tuo feed insieme al percorso, cioè {% for <your-item> in dataFetchResponse.<your-json-path> %}.

Se hai solo un elemento, questo potrebbe non essere necessario

Supponendo che sample-data-feed sia il nome della fonte di dati esterna e feed.items sia il percorso nel feed json per ottenere gli elementi, apparirà come segue:

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

• Dopo aver aggiunto questo, puoi quindi aggiungere qualsiasi immagine, testo, elementi di pulsante e fare riferimento alla fonte di dati esterna come mostrato di seguito assumendo la struttura di sample-data-feed:

{{item.title}} - Per mostrare il titolo in un elemento di testo

{{item.description}} - Per mostrare la descrizione in un elemento di testo

{{item.link}} - Per aggiungere un link in un elemento di pulsante

{{item.thumbnail}} - Per aggiungere un URL di origine immagine in un elemento immagine

• Ora aggiungi un altro blocco html per terminare il recupero della fonte di dati esterna e la funzione for come mostrato di seguito

{% endfor %}
{% enddatafetch %}

Per visualizzare in anteprima la tua email, puoi passare alla vista di anteprima e vedere come appare il tuo feed di contenuti

Nota: Se hai un feed statico, puoi aggiornarlo manualmente qui selezionando la fonte di dati esterna nel menu a discesa Aggiorna Fonte di Dati Esterna.