Tabelle di ricerca
Come utilizzare le tabelle di ricerca
Le Lookup Tables sono un modo per memorizzare dati che puoi poi utilizzare in Templates, Flows e Journeys. Crea le tue Lookup Tables tramite il dashboard e poi fai riferimento dinamico ai dati in queste tabelle
Le Lookup Tables in Bird memorizzano e centralizzano i riferimenti ai dati, che possono essere consultati durante la creazione di modelli email usando il linguaggio di templating Liquid in HTML.
Ad esempio, le bandiere di ogni paese, le abbreviazioni o la valuta possono essere memorizzate e aggiornate centralmente come una lookup table. Ogni volta che viene utilizzato nella costruzione di un'email, può essere fatto riferimento da questa lookup table.
Limitazioni importanti:
Ogni tabella può contenere fino a 10 elementi di dati separati.
Ogni elemento può contenere fino a circa 300 kB di dati.
Crea una Lookup Table
Usa la tabella di ricerca nel modello di email
Per usare una tabella di ricerca in un modello di email, puoi aggiungere la seguente sintassi liquid al tuo modello HTML o a un elemento HTML usato in un builder drag-and-drop:
Qui,
variable_name è un qualsiasi nome che puoi definire
lookup-table-slug è lo slug che hai assegnato durante la creazione della tabella di ricerca
item-name è il nome dell'elemento che hai creato
object-value è il valore che hai assegnato all'elemento JSON
key_name è il nome della chiave nella coppia chiave-valore definita sotto item-value
Ad esempio,
Per visualizzare la valuta locale di un Paese definito, possiamo usare la seguente sintassi:
variable_name qui è definito come currency (qualsiasi nome che l'utente può definire)
lookup-table-slug qui è country-flags come definito durante la creazione della tabella di ricerca
item-name è il country come creato in precedenza e mostrato nel pannello di sinistra
object-value è AD, che è il valore definito nel JSON. Nota che questo può anche essere una variabile
key_name è il local_currency, che è definito nel JSON
Quando viene utilizzato nel builder del modello di email in un blocco HTML, la sintassi sopra renderà il valore del local_currency come memorizzato sotto l'oggetto AD sotto l'elemento country nella tabella di ricerca country-flags
Puoi passare alla sezione di anteprima per vedere il valore di output visualizzato dinamicamente nel modello di email. Di seguito, mostra EUR come valore recuperato dalla tabella di ricerca.
Utilizzando le tabelle di ricerca in Flows
Puoi leggere le tabelle di ricerca nei Flows per riutilizzare dati definiti centralmente.
Per utilizzare una tabella di ricerca, prima creane una come descritto sopra.
Vai a Workflows > Flows
Crea un flusso iniziale utilizzando un tipo di trigger a tua scelta.
Aggiungi un nuovo passaggio Perform Lookup al tuo flusso. Clicca su Add New Action e selezionalo dal gruppo Lookup Tables oppure cercalo utilizzando la funzione di ricerca sulla destra:
Vedrai una schermata di configurazione in cui puoi selezionare la tabella da cui leggere e configurare esattamente come desideri eseguire questa ricerca:
Vedrai tre componenti che puoi configurare:
Lookup Table Slug indica quale tabella vuoi esaminare. Cliccando su questo campo, Flows ti mostrerà le tabelle di ricerca disponibili:
Lookup ti consente di determinare cosa recuperare e puoi utilizzare le varie variabili a tua disposizione per costruire questa chiave di ricerca. L'operazione predefinita è restituire il valore a cui punta, come valore di livello radice, ma se desideri creare un oggetto di dati, puoi utilizzare la capacità As per caricarlo in una proprietà specifica:
Replace ti permette di sostituire variabili in un risultato di ricerca restituito con un valore statico o un valore definito da qualche parte nella tua tabella di ricerca. L'esempio seguente sostituirebbe il testo
{{ MyVariableName }}in qualsiasi elemento restituito dall'azione Lookup con il valore che trova sotto la chiavereplacements.<locale>.MyVariableName:
Cliccando poi sul pulsante Test vedrai i dati risultanti:
Configurare da quale tabella leggere è richiesto e devi aggiungere almeno un'azione di Lookup. Non sei tenuto ad aggiungere azioni di Replace.
