Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Lookup Tables

Cómo utilizar las tablas de búsqueda

Descripción general

Descripción general

Descripción general

Las Lookup Tables son una forma de almacenar datos que luego puedes usar en Templates, Flows y Journeys. Crea tus Lookup Tables a través del panel de control y luego referencia dinámicamente los datos en estas tablas.

Las Lookup Tables en Bird almacenan y centralizan referencias de datos, las cuales pueden consultarse al crear plantillas de correo electrónico utilizando el lenguaje de plantillas Liquid en HTML.

Por ejemplo, las banderas de cada país, las abreviaturas o la moneda pueden almacenarse y actualizarse centralmente como una tabla de consulta. Cada vez que se utilice para construir un correo electrónico, se puede referenciar desde esta tabla de consulta.

Limitaciones importantes:

  • Cada tabla puede tener hasta 10 elementos de datos separados almacenados en ella.

  • Cada elemento puede contener hasta aproximadamente 300kB de datos.

Crear una Lookup Table

Ir a Contenido > Tablas de búsqueda y haz clic en Crear.

  • Introduce un nombre para mostrar

  • Introduce un slug sin espacios



El Slug se usa para referenciar esta tabla y solo puede contener caracteres alfanuméricos. Ten en cuenta que este slug se usa para referenciar la plantilla de correo electrónico

  • Haz clic en Guardar



Creando un elemento en una tabla

Haz clic en la tabla que has creado

En el menú contextual que aparece, selecciona "Ver"



Cada elemento en una tabla es esencialmente un documento JSON. Esto significa que puedes construir una estructura de árbol de claves y valores, donde los valores pueden ser texto, números, booleanos, arreglos u objetos en sí mismos. Puedes ingresar un documento JSON directamente, usando la sintaxis JSON o puedes usar un editor de interfaz de usuario para construir el documento JSON.

Editor JSON

  • Una vez que hayas guardado, verás un editor JSON. Puedes seleccionar el editor de Texto o de Interfaz de Usuario según tu preferencia.

  • Actualiza la tabla de búsqueda usando una estructura JSON.

Agregando un elemento

Para agregar un elemento en un JSON para la organización, haz clic en +Agregar Elemento en el panel izquierdo.

  • Escribe un nombre en la parte superior

  • Haz clic en el botón Agregar Elemento

  • Una vez creado, puedes ver el elemento creado en el panel izquierdo.

Escribe el JSON

Usa el formato JSON para definir cualquier estructura de objeto y pares clave-valor a continuación:

Por ejemplo, un JSON que da el nombre del país y la moneda local según la abreviatura del país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

También puedes usar el editor de interfaz de usuario para definir la estructura JSON.


Ir a Contenido > Tablas de búsqueda y haz clic en Crear.

  • Introduce un nombre para mostrar

  • Introduce un slug sin espacios



El Slug se usa para referenciar esta tabla y solo puede contener caracteres alfanuméricos. Ten en cuenta que este slug se usa para referenciar la plantilla de correo electrónico

  • Haz clic en Guardar



Creando un elemento en una tabla

Haz clic en la tabla que has creado

En el menú contextual que aparece, selecciona "Ver"



Cada elemento en una tabla es esencialmente un documento JSON. Esto significa que puedes construir una estructura de árbol de claves y valores, donde los valores pueden ser texto, números, booleanos, arreglos u objetos en sí mismos. Puedes ingresar un documento JSON directamente, usando la sintaxis JSON o puedes usar un editor de interfaz de usuario para construir el documento JSON.

Editor JSON

  • Una vez que hayas guardado, verás un editor JSON. Puedes seleccionar el editor de Texto o de Interfaz de Usuario según tu preferencia.

  • Actualiza la tabla de búsqueda usando una estructura JSON.

Agregando un elemento

Para agregar un elemento en un JSON para la organización, haz clic en +Agregar Elemento en el panel izquierdo.

  • Escribe un nombre en la parte superior

  • Haz clic en el botón Agregar Elemento

  • Una vez creado, puedes ver el elemento creado en el panel izquierdo.

Escribe el JSON

Usa el formato JSON para definir cualquier estructura de objeto y pares clave-valor a continuación:

Por ejemplo, un JSON que da el nombre del país y la moneda local según la abreviatura del país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

También puedes usar el editor de interfaz de usuario para definir la estructura JSON.


Ir a Contenido > Tablas de búsqueda y haz clic en Crear.

  • Introduce un nombre para mostrar

  • Introduce un slug sin espacios



El Slug se usa para referenciar esta tabla y solo puede contener caracteres alfanuméricos. Ten en cuenta que este slug se usa para referenciar la plantilla de correo electrónico

  • Haz clic en Guardar



Creando un elemento en una tabla

Haz clic en la tabla que has creado

En el menú contextual que aparece, selecciona "Ver"



Cada elemento en una tabla es esencialmente un documento JSON. Esto significa que puedes construir una estructura de árbol de claves y valores, donde los valores pueden ser texto, números, booleanos, arreglos u objetos en sí mismos. Puedes ingresar un documento JSON directamente, usando la sintaxis JSON o puedes usar un editor de interfaz de usuario para construir el documento JSON.

Editor JSON

  • Una vez que hayas guardado, verás un editor JSON. Puedes seleccionar el editor de Texto o de Interfaz de Usuario según tu preferencia.

  • Actualiza la tabla de búsqueda usando una estructura JSON.

Agregando un elemento

Para agregar un elemento en un JSON para la organización, haz clic en +Agregar Elemento en el panel izquierdo.

  • Escribe un nombre en la parte superior

  • Haz clic en el botón Agregar Elemento

  • Una vez creado, puedes ver el elemento creado en el panel izquierdo.

Escribe el JSON

Usa el formato JSON para definir cualquier estructura de objeto y pares clave-valor a continuación:

Por ejemplo, un JSON que da el nombre del país y la moneda local según la abreviatura del país

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

También puedes usar el editor de interfaz de usuario para definir la estructura JSON.


Use Lookup Table en Plantilla de Email


Para usar una tabla de búsqueda en una plantilla de correo electrónico, puedes añadir la siguiente sintaxis liquid a tu plantilla HTML o a un elemento HTML utilizado en un constructor de arrastrar y soltar:

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

{{variable_name.key_name}}

Aquí,

  • variable_name es cualquier nombre que puedes definir

  • lookup-table-slug es el slug que diste al crear la tabla de búsqueda

  • item-name es el nombre del ítem que has creado

  • object-value es el valor que has dado para el ítem JSON

  • key_name es el nombre de la clave en el par clave-valor definido bajo item-value

Por ejemplo,

Para mostrar la moneda local de un país definido, podemos usar la siguiente sintaxis

  • variable_name aquí se define como currency (cualquier nombre que el usuario puede definir)

  • lookup-table-slug aquí es country-flags tal como fue definido cuando se creó la tabla de búsqueda

  • item-name es el country tal como fue creado anteriormente y mostrado en el panel izquierdo

  • object-value es AD, que es el valor definido en el JSON. Nota que esto también puede ser una variable

  • key_name es la local_currency, que está definida en el JSON

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

{{currency.local_currency}}

Cuando se utiliza en el constructor de plantillas de correo electrónico en un bloque HTML, la sintaxis anterior mostrará el valor del local_currency tal y como está almacenado bajo el objeto AD en el ítem country en la tabla de búsqueda country-flags

Puedes cambiar a la sección de vista previa para ver el valor de salida mostrado dinámicamente en la plantilla de correo electrónico. A continuación, se muestra EUR como el valor obtenido de la tabla de búsqueda.

Usando tablas de búsqueda en Flows

Puede leer tablas de búsqueda en Flows para reutilizar datos definidos de manera central.

Para usar una tabla de búsqueda, primero cree una como se describe arriba.

  1. Navegue a Workflows > Flows

  2. Cree un flujo inicial usando un tipo de activador de su elección.

Agregue un nuevo paso de Perform Lookup a su flujo. Haga clic en Add New Action y selecciónelo del grupo Lookup Tables o búsquelo usando la capacidad de búsqueda a la derecha:



Se le mostrará una pantalla de configuración donde puede seleccionar la tabla de la que leer y configurar cómo desea realizar esta búsqueda:



Verá tres componentes que puede configurar:

  1. Lookup Table Slug indica qué tabla desea mirar. Al hacer clic en este campo, Flows le mostrará las tablas de búsqueda disponibles:

  1. Lookup le permite determinar qué recuperar y puede usar las diversas variables disponibles para construir esta clave de búsqueda. La operación predeterminada es devolver el valor al que apunta su búsqueda como el valor a nivel raíz, pero si desea crear un objeto de datos, puede usar la capacidad As para cargarlo en una propiedad específica:

  1. Replace le permite reemplazar variables en un resultado de búsqueda devuelto con un valor estático o un valor que se define en algún lugar de su tabla de búsqueda. El siguiente ejemplo reemplazaría el texto {{ MyVariableName }} en cualquier elemento devuelto con la acción Lookup por el valor que encuentra bajo la clave replacements.<locale>.MyVariableName:

Al hacer clic en el botón Test podrá ver los datos resultantes:


Configurar desde qué tabla leer es obligatorio y debe agregar al menos una acción de Lookup. No es necesario agregar acciones de Replace.


Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

R

Reach

G

Grow

M

Manage

A

Automate

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.