Lookup Tables
Cómo utilizar las tablas de búsqueda
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
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:
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
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.
Navegue a Workflows > Flows
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:
Lookup Table Slug indica qué tabla desea mirar. Al hacer clic en este campo, Flows le mostrará las tablas de búsqueda disponibles:
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:
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 clavereplacements.<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.
