Etiquetas de personalización compatibles

Este artículo de referencia cubre una lista completa de las etiquetas de personalización de Liquid compatibles.

Resumen de etiquetas compatibles

A modo de referencia, se proporciona un resumen de las etiquetas de personalización compatibles. Para obtener más detalles sobre cada tipo de etiqueta y las mejores prácticas, continúa leyendo.

Nota

Las propiedades de desencadenamiento de API deben usar dos llaves por etiqueta: {{api_trigger_properties.${your_api_trigger_property}}}. Las llaves triples (por ejemplo, {{{...}}}) no son una sintaxis de personalización válida en Braze. Consulta ¿Por qué mi Liquid desencadenado por API falla en Braze?.

Atributos compatibles

Los atributos de Campaign, tarjeta y Canvas solo son compatibles en sus plantillas de mensajería correspondientes. Por ejemplo, dispatch_id es compatible con Liquid para canales de mensajería como correo electrónico, push, SMS y WhatsApp, pero no para mensajes dentro de la aplicación ni Banners.

Consulta Atributos de Campaign y Canvas en distintas fuentes para obtener más detalles.

Diferencias entre etiquetas de Canvas y Campaign

El comportamiento de las siguientes etiquetas difiere entre Canvas y Campaigns:

• El comportamiento de dispatch_id difiere porque Braze trata los pasos de Canvas como eventos desencadenados, incluso cuando están “programados” (excepto los pasos de entrada, que pueden programarse). Para más información, consulta Comportamiento de dispatch ID.
• Usar la etiqueta {{campaign.${name}}} con Canvas muestra el nombre del componente de Canvas. Cuando se usa esta etiqueta con Campaigns, muestra el nombre de la campaña.

Nombres de Campaign en URLs

Los nombres de Campaign y de variantes de mensaje pueden incluir caracteres que no son seguros para URLs, como %, espacios o &. Cuando insertes {{campaign.${name}}} o {{campaign.${message_name}}} en un enlace o cadena de consulta, como un parámetro utm_campaign, aplica el filtro url_encode para que la URL se analice correctamente. Por ejemplo:

1
https://example.com/?utm_campaign={{ campaign.${name} | url_encode }}

Información del dispositivo utilizado más recientemente

Puedes usar como plantilla los siguientes atributos del dispositivo más reciente del usuario en todas las plataformas. Si un usuario no ha utilizado tu aplicación (por ejemplo, si importaste al usuario a través de la REST API), todos estos valores serán null.

Dado que existe una amplia variedad de operadores de dispositivos, nombres de modelos y sistemas operativos, te recomendamos que pruebes a fondo cualquier Liquid que dependa condicionalmente de alguno de esos valores. Estos valores son null si no están disponibles en un dispositivo en particular.

Información de la aplicación segmentada

Para los mensajes dentro de la aplicación, puedes utilizar los siguientes atributos de la aplicación dentro de Liquid. Los valores se basan en la clave de API de SDK que tus aplicaciones utilizan para solicitar mensajería.

Por ejemplo, este código Liquid cancela un mensaje si las aplicaciones solicitantes no son una de las dos claves de API de la lista:

1
2
3
4
5
6
{% assign allowed_api_keys = 'sdk_api_key_1,sdk_api_key_2' | split: ',' %}
{% if allowed_api_keys contains {{app.${api_id}}} %}
User is in list of apps
{% else %}
{% abort_message("User not in list of apps") %}
{% endif %}

Información del dispositivo objetivo

Para notificaciones push, mensajes dentro de la aplicación y Banners, puedes incluir mediante plantillas los siguientes atributos del dispositivo que recibe el mensaje. Una notificación push, un mensaje dentro de la aplicación o un Banner puede incluir atributos del dispositivo en el que el usuario lee el mensaje. Estos atributos no funcionan para Content Cards ni correos electrónicos. En el caso de los correos electrónicos, los mensajes se renderizan antes de enviarse, por lo que el dispositivo en el que el usuario abre el correo electrónico es desconocido en ese momento.

Dado que existe una amplia variedad de operadores de dispositivos, nombres de modelos y sistemas operativos, te aconsejamos que pruebes exhaustivamente cualquier lógica que dependa condicionalmente de cualquiera de esos valores. Estos valores son null si no están disponibles en un dispositivo en particular.

Además, para las notificaciones push, es posible que Braze no pueda determinar el dispositivo asociado a la notificación push en ciertas circunstancias, como cuando el token de notificaciones push fue importado a través de la API, lo que resulta en valores null para esos mensajes.

Uso de lógica condicional en lugar de un valor predeterminado

En algunas circunstancias, puedes optar por usar lógica condicional en lugar de establecer un valor predeterminado. La lógica condicional te permite enviar mensajes que difieren según el valor de un atributo personalizado. Además, puedes usar lógica condicional para cancelar mensajes a clientes con valores de atributos nulos o en blanco.

Ejemplo

Por ejemplo, supongamos que estás enviando una notificación de saldo de recompensas a los clientes. No hay una buena manera de tener en cuenta a los clientes con saldos bajos y nulos usando valores predeterminados.

En este caso, hay dos opciones que pueden funcionar mejor que establecer un valor predeterminado:

1. Cancelar el mensaje para clientes con saldos bajos, nulos y en blanco.

   1
   2
   3
   4
   5
   {% if {{custom_attribute.${balance}}} > 0 %}
   Your rewards balance is {{custom_attribute.${balance}}}
   {% else %}
   {% abort_message() %}
   {% endif %}
   

2. Enviar un mensaje completamente diferente a estos clientes, como:

   1
   2
   3
   4
   5
   {% if ${first_name} != blank and ${first_name} != null %}
   Hello {{${first_name} | default: 'there'}}, thanks for downloading!
   {% else %}
   Thanks for downloading!
   {% endif %}
   

En este ejemplo, un usuario con un nombre en blanco o nulo recibe el mensaje “Thanks for downloading”. Deberías incluir un valor predeterminado para el nombre para asegurarte de que tu cliente no vea Liquid en caso de un error.

Etiquetas de variable

Puedes usar la etiqueta assign para crear una variable en el creador de mensajes. Te recomendamos usar un nombre único para tu variable. Si creas una variable con un nombre similar al de las etiquetas de personalización compatibles (como language), esto puede afectar tu lógica de mensajería.

Después de crear una variable, puedes hacer referencia a ella en tu lógica de mensajería o mensaje. Esta etiqueta es útil cuando quieres reformatear contenido que se devuelve desde nuestra característica de contenido conectado. Puedes leer más en la documentación de Shopify sobre etiquetas de variable.

Importante

Las cadenas envueltas en comillas simples dentro de una etiqueta assign se tratan como cadenas literales. Las etiquetas de personalización de Liquid dentro de comillas simples no se interpolan. Por ejemplo:

1
2
{% assign name_intro = 'My name is {{${first_name}}}' %}
{{ name_intro }}

Esto genera el texto literal My name is {{${first_name}}} en lugar del nombre del usuario.

Para incluir personalización, usa variables o concatena cadenas con el filtro append. Para la creación de plantillas de URL con personalización, consulta plantillas de enlace.

Consejo

¿Te encuentras asignando las mismas variables en cada mensaje? En lugar de escribir la etiqueta assign una y otra vez, puedes guardar esa etiqueta como un bloque de contenido y colocarla en la parte superior de tu mensaje.

1. Crea un bloque de contenido.
2. Dale un nombre a tu bloque de contenido (sin espacios ni caracteres especiales).
3. Selecciona Editar en la parte inferior de la página.
4. Escribe tus etiquetas assign.

Siempre que el bloque de contenido esté en la parte superior de tu mensaje, cada vez que la variable se inserte en tu mensaje como un objeto, hará referencia a tu atributo personalizado elegido.

Ejemplo

Supongamos que permites a tus clientes canjear sus puntos de recompensas por premios después de acumular 100 puntos de recompensas. Entonces, solo quieres enviar mensajes a los clientes que tendrían un saldo de puntos mayor o igual a 100 si realizaran esa compra adicional:

1
2
3
4
5
6
{% assign new_points_balance = {{custom_attribute.${current_rewards_balance} | plus: 50}} %}
{% if new_points_balance >= 100 %}
Make a purchase to bring your rewards points to {{new_points_balance}} and cash in today!
{% else %}
{% abort_message('not enough points') %}
{% endif %}

Etiquetas de iteración

Las etiquetas de iteración se pueden usar para ejecutar un bloque de código de forma repetida. El ejemplo a continuación presenta la etiqueta for.

Ejemplo

Supongamos que tienes una oferta en zapatillas Nike y quieres enviar un mensaje a los clientes que han expresado interés en Nike. Tienes un array de marcas de productos visualizadas en el perfil de cada cliente. Este array podría contener hasta 25 marcas de productos, pero solo quieres enviar un mensaje a los clientes que vieron un producto Nike como una de sus 5 visualizaciones de productos más recientes.

1
2
3
4
5
6
7
8
9
10
{% for items in {{custom_attribute.${Brands Viewed}}} limit:5 %}
{% if {{items}} contains 'Converse' %}
{% assign converse_viewer = true %}
{% endif %}
{% endfor %}
{% if converse_viewer == true %}
Sale on Converse!
{% else %}
{% abort_message() %}
{% endif %}

En este ejemplo, verificamos los primeros cinco elementos en el array de marcas de zapatillas visualizadas. Si uno de esos elementos es Converse, creamos la variable converse_viewer y la establecemos como verdadera.

Luego, enviamos el mensaje de oferta cuando converse_viewer es verdadera. De lo contrario, abortamos el mensaje.

Este es un ejemplo sencillo de cómo se pueden usar las etiquetas de iteración en el creador de mensajes de Braze. Puedes encontrar más información en la documentación de Shopify sobre etiquetas de iteración.

Etiquetas de sintaxis

Las etiquetas de sintaxis se pueden usar para controlar cómo se renderiza Liquid. Puedes usar la etiqueta echo para devolver una expresión. Esto es lo mismo que envolver una expresión usando llaves, excepto que puedes usar esta etiqueta dentro de etiquetas de Liquid. También puedes usar la etiqueta liquid para tener un bloque de Liquid sin delimitadores en cada etiqueta. Cada etiqueta debe estar en su propia línea cuando uses la etiqueta liquid. Consulta la documentación de Shopify sobre etiquetas de sintaxis para obtener más información y ejemplos.

Con el control de espacios en blanco, puedes eliminar los espacios en blanco alrededor de tus etiquetas, lo que te ayuda a controlar aún más el aspecto de la salida de Liquid.

Códigos de estado HTTP

Puedes utilizar el estado HTTP de una llamada de contenido conectado guardándolo primero como una variable local y luego usando la clave __http_status_code__. Por ejemplo:

1
2
3
4
{% connected_content https://example.com/api/endpoint :save connected %}
{% if connected.__http_status_code__ != 200 %}
{% abort_message('Connected Content returned a non-200 status code') %}
{% endif %}

Nota

Esta clave solo se agrega automáticamente al objeto de contenido conectado si el endpoint devuelve un objeto JSON. Si el endpoint devuelve un array u otro tipo, esa clave no se puede establecer automáticamente en la respuesta.

Enviar mensajes según el idioma, la configuración regional más reciente y la zona horaria

En algunas situaciones, es posible que desees enviar mensajes específicos para configuraciones regionales particulares. Por ejemplo, el portugués brasileño suele ser diferente del portugués europeo.

Ejemplo: Localizar según la configuración regional más reciente

Aquí tienes un ejemplo de cómo puedes usar la configuración regional más reciente para localizar aún más un mensaje internacionalizado.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{% if ${language} == 'en' %}
Message in English
{% elsif  ${language} == 'fr' %}
Message in French
{% elsif  ${language} == 'ja' %}
Message in Japanese
{% elsif  ${language} == 'ko' %}
Message in Korean
{% elsif  ${language} == 'ru' %}
Message in Russian
{% elsif ${most_recent_locale} == 'pt_BR' %}
Message in Brazilian Portuguese
{% elsif ${most_recent_locale} == 'pt_PT' %}
Message in European Portuguese
{% elsif  ${language} == 'pt' %}
Message in default Portuguese
{% else %}
Message in default language
{% endif %}

En este ejemplo, los clientes con una configuración regional más reciente de pt_BR reciben un mensaje en portugués brasileño, y los clientes con una configuración regional más reciente de pt_PT reciben un mensaje en portugués europeo. Los clientes que no cumplen las dos primeras condiciones pero tienen su idioma configurado en portugués reciben un mensaje en el tipo de portugués predeterminado que tú elijas.

Ejemplo: Segmentar usuarios por zona horaria

También puedes segmentar usuarios por su zona horaria. Por ejemplo, enviar un mensaje si se encuentran en EST y otro si están en PST. Para hacer esto, guarda la hora actual en UTC y compara una declaración if/else con la hora actual del usuario para enviar el mensaje correcto en la zona horaria correcta. Debes configurar la Campaign para que se envíe en la zona horaria local del usuario, de modo que reciba la Campaign en el momento adecuado.

Consulta el siguiente ejemplo para saber cómo escribir un mensaje que se entregue entre las 2 pm y las 3 pm con un mensaje específico para cada zona horaria.

1
2
3
4
5
6
7
8
{% assign hour_in_utc = 'now' | date: '%H' | plus:0 %}
{% if hour_in_utc >= 19 && hour_in_utc < 20 %}
It is between 2:00:00 pm and 2:59:59 pm ET!
{% elsif hour_in_utc >= 22 && hour_in_utc < 23 %}
It is between 2:00:00 pm and 2:59:59 pm PT!
{% else %}
{% abort_message %}
{% endif %}

Enviar mensajes con un número aleatorio

La etiqueta {% random %} devuelve un número aleatorio. Puedes usarla para lógica de estilo A/B, muestreo o variar el contenido de los mensajes.

Ejemplo: Enviar variantes aleatorias a los usuarios

1
2
3
4
5
6
7
{% capture roll_str %}{% random %}{% endcapture %}
{% assign roll = roll_str | plus: 0 %}
{% if roll < 0.5 %}
Show variant A
{% else %}
Show variant B
{% endif %}

Etiqueta de carrito de compras de comercio electrónico

La etiqueta shopping_cart accede al contenido del carrito de un usuario en los casos de uso de Canvas de comercio electrónico de carrito abandonado y pago abandonado. Reemplaza CART_ID con el valor real del ID del carrito, como {{context.${cart_id}}}.

1
{% shopping_cart CART_ID :abort_if_not_abandoned false %}

El parámetro abort_if_not_abandoned en este ejemplo se aplica solo al caso de uso de pago abandonado cuando se usa con el evento ecommerce.checkout_started. No es aplicable a los casos de uso de carrito abandonado. Para más detalles, consulta abort_if_not_abandoned.