Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Tabelle di ricerca

Come utilizzare le tabelle di ricerca

Panoramica

Panoramica

Panoramica

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

Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome visualizzato

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug è utilizzato nel riferimento al modello email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che si apre, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, usando la sintassi JSON o puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor di testo o l'editor UI secondo le tue preferenze.

  • Aggiorna la tabella di ricerca usando una struttura JSON.

Aggiunta di un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi Elemento nel pannello sinistro.

  • Scrivi un nome in alto

  • Clicca sul pulsante Aggiungi Elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello sinistro.

Scrivi il JSON

Usa il formato JSON per definire qualsiasi struttura di oggetti e coppie chiave-valore qui sotto:

Ad esempio, un JSON che dà il nome del paese e la valuta locale basata sull'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome visualizzato

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug è utilizzato nel riferimento al modello email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che si apre, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, usando la sintassi JSON o puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor di testo o l'editor UI secondo le tue preferenze.

  • Aggiorna la tabella di ricerca usando una struttura JSON.

Aggiunta di un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi Elemento nel pannello sinistro.

  • Scrivi un nome in alto

  • Clicca sul pulsante Aggiungi Elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello sinistro.

Scrivi il JSON

Usa il formato JSON per definire qualsiasi struttura di oggetti e coppie chiave-valore qui sotto:

Ad esempio, un JSON che dà il nome del paese e la valuta locale basata sull'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome visualizzato

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug è utilizzato nel riferimento al modello email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che si apre, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, usando la sintassi JSON o puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor di testo o l'editor UI secondo le tue preferenze.

  • Aggiorna la tabella di ricerca usando una struttura JSON.

Aggiunta di un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi Elemento nel pannello sinistro.

  • Scrivi un nome in alto

  • Clicca sul pulsante Aggiungi Elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello sinistro.

Scrivi il JSON

Usa il formato JSON per definire qualsiasi struttura di oggetti e coppie chiave-valore qui sotto:

Ad esempio, un JSON che dà il nome del paese e la valuta locale basata sull'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


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:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

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

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

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.

  1. Vai a Workflows > Flows

  2. 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:

  1. Lookup Table Slug indica quale tabella vuoi esaminare. Cliccando su questo campo, Flows ti mostrerà le tabelle di ricerca disponibili:

  1. 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:

  1. 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 chiave replacements.<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.


Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.

Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.

Connettiamoci con un esperto di Bird.
Scopri tutta la potenza del Bird in 30 minuti.

Inviando, accetti che Bird possa contattarti riguardo ai nostri prodotti e servizi.

Puoi annullare l'iscrizione in qualsiasi momento. Consulta la Informativa sulla Privacy di Bird per i dettagli sul trattamento dei dati.

R

Raggiungi

G

Grow

M

Manage

A

Automate

Azienda

Newsletter

Rimani aggiornato con Bird attraverso aggiornamenti settimanali nella tua inbox.