Integrare fonti di dati esterne nei modelli di email consente contenuti altamente personalizzati e dinamici, migliorando l'interazione e la rilevanza. Questa guida ti accompagnerà nella configurazione delle fonti di dati esterne e nel loro utilizzo nei tuoi modelli di email.
Le fonti di dati esterne forniscono contenuti dinamici ai tuoi modelli di email estraendo informazioni da API esterne. Questo è utile per:
Personalizzare i contenuti in base a un feed esterno
Mostrare dati in tempo reale come lo stato di un volo da un'API
Personalizzare i link passando parametri e ricevendo link finali tramite uno strumento esterno
Crea una sorgente di dati esterna
Utilizzare fonti di dati esterne nelle email
Una volta che la tua fonte di dati esterna è configurata correttamente, puoi utilizzare il suo output nel modello di email utilizzando il linguaggio di templating liquid.
Utilizzare la fonte di dati esterna per il feed di contenuti
Per mostrare un feed di contenuti, puoi creare un'API che restituisce un json con molti elementi del feed di contenuti. Come esempio potrebbe apparire simile a questo:
Il json feed sopra può essere utilizzato come URL API durante la creazione di una fonte di dati esterna.
Una volta creato, puoi farvi riferimento in un modello di email come segue:
Prima aggiungi un elemento html e aggiungi il codice qui sotto per recuperare la fonte di dati esterna per nome, ovvero {% datafetch "external-data-source-name" %}
Usa la funzione for in liquid per ottenere tutti gli elementi nel tuo feed insieme al percorso, ovvero {% for <your-item> in dataFetchResponse.<your-json-path> %}.
Se hai solo un elemento, questo potrebbe non essere necessario
Assumendo che sample-data-feed sia il nome della fonte di dati esterna e feed.items sia il percorso nel json feed per ottenere gli elementi, apparirà come segue:
Dopo che questo è stato aggiunto, puoi quindi aggiungere qualsiasi immagine, testo, elementi di pulsante e fare riferimento alla fonte di dati esterna come qui sotto assumendo la struttura di sample-data-feed :
{{item.title}} - Per mostrare il titolo in un elemento testo
{{item.description}} - Per mostrare la descrizione in un elemento testo
{{item.link}} - Per aggiungere un link in un elemento pulsante
{{item.thumbnail}} - Per aggiungere una sorgente URL per l'immagine nell'elemento immagine
Ora aggiungi un altro blocco html per terminare il recupero della fonte di dati esterna e la funzione for come mostrato qui sotto
Per visualizzare l'email, puoi passare in anteprima e vedere come appare il tuo feed di contenuti
Nota: Se hai un feed statico, puoi aggiornarlo qui manualmente selezionando la fonte di dati esterna dal menu a discesa Aggiorna Fonte di Dati Esterna.
Utilizzare una fonte di dati esterna per personalizzare gli URL
Puoi anche utilizzare fonti di dati esterne insieme a variabili nell'URL dell'API. Questo aiuta a passare eventuali parametri a un'API esterna e a restituire una risposta da aggiungere a un modello di email.
Ad esempio, puoi utilizzare un URL API come quello qui sotto passando le variabili come mostrato di seguito.
https://api.bird.com/workspaces/?email={{email}}&referenceId={{referenceId}}&locale={{locale}}&name={{name}}
Per utilizzare questa fonte di dati esterna in un modello di email, devi fornire anche i valori delle variabili nel tag liquid:
Aggiungi il primo elemento html come {% datafetch "name", "variable1", "variable1 value", "variable2, "variable2 value" %}
Nell'esempio sottostante, la prima riga evita di causare problemi quando l'indirizzo email ha un segno +. La seconda riga avvia effettivamente il flusso di dati esterni con le variabili. Puoi fornire valori statici come "value" oppure puoi fornire riferimenti a variabili come contact.attributes.userId.
GenerateLink è il nome della fonte di dati esterna sopra.
Per generare un link personalizzato puoi utilizzare un elemento button con il link definito come {{dataFetchResponse.url}} dove l'url contiene la risposta dalla tua API.
Dopo questo, aggiungi l'elemento html di chiusura come di seguito:
