Referencia de Liquid
Liquid es un lenguaje de plantillas de código abierto creado por Shopify y utilizado por Braze para potenciar la personalización dinámica. En lugar de enviar un mensaje estático a todos, Liquid te permite crear plantillas que cambian su contenido en función de los datos específicos del perfil, el comportamiento o el idioma de cada destinatario.
Artículos de la sección
Acerca de Liquid
Liquid actúa como un puente entre tu mensaje y los datos de tu usuario. Cuando envías un mensaje, Braze analiza el texto en busca de sintaxis Liquid. Cuando la encuentra, extrae los datos relevantes de ese usuario específico y reemplaza el código con el valor real antes de que se envíe el mensaje.
Por ejemplo, puedes recuperar un atributo personalizado de un perfil de usuario que sea un tipo de datos entero y redondear ese valor al número entero más cercano. Para más información sobre la sintaxis y el uso de Liquid, consulta Etiquetas de personalización compatibles.
El lenguaje de plantillas Liquid admite el uso de objetos, etiquetas y filtros.
- Los objetos te permiten insertar atributos personalizados en tus mensajes.
- Las etiquetas te permiten insertar datos en la mensajería y usar lógica condicional para enviar mensajes si se cumplen ciertas condiciones. Por ejemplo, puedes usar etiquetas para incluir lógica inteligente, como sentencias “if”, en tus campañas.
- Los filtros te permiten reformatear atributos personalizados y contenido dinámico. Por ejemplo, podrías usar el filtro
datepara convertir una marca de tiempo, como 2016-09-07 08:43:50 UTC, en una fecha, como 7 de septiembre de 2016.
Actualmente, Braze no es compatible con el 100 % de Liquid de Shopify, solo con ciertas partes que hemos intentado describir en nuestra documentación. Recomendamos encarecidamente probar todos los mensajes que usen Liquid antes de enviarlos para reducir el riesgo de errores o de usar Liquid no compatible.
Compatibilidad con Liquid 5
Braze es compatible con Liquid hasta e incluyendo Liquid 5 de Shopify. La implementación de Liquid admite tipos de etiquetas de personalización de sintaxis y control de espacios en blanco. Para más información sobre etiquetas específicas, consulta etiquetas de sintaxis.
Los siguientes filtros nuevos de arrays y matemáticos están disponibles para usar en tu Liquid mientras construyes tu mensajería.
at_leastat_mostcompactconcatsort_naturalwhere
Consulta Filtros para ver las definiciones.
Términos que debes conocer
Estos términos están reinterpretados a partir de la documentación de Shopify según nuestro nivel de compatibilidad.
| Término | Definición | Ejemplo |
|---|---|---|
| Liquid | Un lenguaje de plantillas de uso común, orientado al cliente, creado por Shopify y escrito en Ruby, que se utiliza para cargar y extraer contenido dinámico. | {{${first_name}}} insertará el nombre de un usuario en un mensaje. |
| Objeto | Una denotación de una variable y la ubicación del nombre de variable previsto que indica a Liquid dónde mostrar contenido en el mensaje. | {{${city}}} insertará la ciudad de un usuario en un mensaje. |
| Etiqueta de lógica condicional | Se usa para crear lógica y controlar el flujo del contenido del mensaje. En Braze, las etiquetas de lógica condicional se utilizan para crear excepciones y variaciones en los mensajes basándose en ciertos criterios predefinidos. | {% if ${language} == 'en' %} activará tu mensaje de una manera determinada en caso de que un usuario haya indicado “inglés” como su idioma. |
| Filtros | Se usan para cambiar, reducir o reformatear la salida del objeto Liquid. A menudo se utilizan para crear operaciones matemáticas. | {{"Big Sale" | upcase}} hará que las palabras “Big Sale” aparezcan como “BIG SALE” en el mensaje. |
| Operadores | Se usan en los mensajes para crear dependencias o criterios que pueden afectar qué mensaje recibe tu usuario. | Si un usuario cumple los criterios definidos en un mensaje etiquetado con {% custom_attribute.${Total_Revenue} > 0%}, recibirá el mensaje. Si no, recibirá otro mensaje designado (o no), dependiendo de lo que hayas configurado. |