Etiquetas de personalización admitidas

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

Resumen de las etiquetas admitidas

Para mayor comodidad, se proporciona un resumen de las etiquetas de personalización admitidas. Para obtener más información sobre cada tipo de etiqueta y las prácticas recomendadas, sigue leyendo.

Atributos admitidos

Los atributos de campaña, tarjeta y Canvas solo se admiten en sus correspondientes plantillas de mensajería (por ejemplo, dispatch_id no está disponible en las campañas de mensajes dentro de la aplicación).

Consulta este artículo de ayuda para obtener más información sobre cómo difieren algunos de estos atributos entre las fuentes en Braze.

Diferencias entre las etiquetas de Canvas y de campaña

El comportamiento de las siguientes etiquetas difiere entre Canvas y las campañas:

• El comportamiento de dispatch_id difiere porque Braze trata los pasos en Canvas como eventos desencadenados, incluso cuando están “programados” (excepto los pasos de entrada, que sí se pueden programar). Para obtener más información, consulta Comportamiento del ID de envío.
• El uso de la etiqueta {{campaign.${name}}} con Canvas mostrará el nombre del componente de Canvas. Al utilizar esta etiqueta con campañas, se mostrará el nombre de la campaña.

Información sobre el dispositivo utilizado más recientemente

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

Debido a que existe una gran variedad de operadores, nombres de modelos y sistemas operativos, te recomendamos que pruebes exhaustivamente cualquier Liquid que dependa condicionalmente de cualquiera de esos valores. Estos valores serán null si no están disponibles en un dispositivo concreto.

Información de la aplicación objetivo

Para los mensajes dentro de la aplicación, puedes utilizar los siguientes atributos de 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 de Liquid abortará 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 las notificaciones push, los mensajes dentro de la aplicación y los banners, puedes crear plantillas con los siguientes atributos para el dispositivo que recibe el mensaje. Una notificación push, un mensaje dentro de la aplicación o un banner pueden incluir atributos del dispositivo en el que el usuario lee el mensaje. Estos atributos no funcionan para Tarjetas de contenido ni correos electrónicos. En el caso de los correos electrónicos, los mensajes se procesan antes de enviarse, por lo que en ese momento se desconoce el dispositivo en el que el usuario abrirá el correo electrónico.

Debido a que existe una gran variedad de operadores de dispositivos, nombres de modelos y sistemas operativos, te recomendamos que compruebes minuciosamente cualquier lógica que dependa condicionalmente de cualquiera de esos valores. Estos valores serán null si no están disponibles en un dispositivo concreto.

Además, para las notificaciones push, es posible que Braze no pueda discernir el dispositivo asociado a la notificación push en determinadas circunstancias, como si el token de notificaciones push se importó a través de la API, lo que hace que los valores de esos mensajes sean null.

Utilizar la lógica condicional en lugar de un valor predeterminado

En algunas circunstancias, puedes optar por utilizar lógica condicional en lugar de establecer un valor predeterminado. La lógica condicional permite enviar mensajes que difieren en función del valor de un atributo personalizado. Además, puedes utilizar la lógica condicional para abortar mensajes a clientes con valores de atributos nulos o en blanco.

Caso de uso

Por ejemplo, supongamos que envías una notificación de saldo de recompensas a los clientes. No hay una buena forma de tener en cuenta a los clientes con saldos bajos y nulos utilizando valores predeterminados.

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

1. Abortar 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 distinto a estos clientes, por ejemplo:

   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 caso de uso, un usuario con un nombre en blanco o nulo recibirá el mensaje “Thanks for downloading!”. Debes incluir un valor predeterminado para el nombre para asegurarte de que tu cliente no vea Liquid en caso de error.

Etiquetas de variables

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

Después de crear una variable, puedes hacer referencia a ella en tu lógica de mensajería o mensaje. Esta etiqueta resulta útil cuando quieres reformatear el contenido devuelto por nuestra función de contenido conectado. Puedes leer más en la documentación de Shopify sobre etiquetas de variables.

Caso de uso

Digamos que permites a tus clientes canjear sus puntos de recompensa por premios después de acumular 100 puntos de recompensa. Por lo tanto, solo debes enviar mensajes a los clientes que tendrían un saldo de puntos superior 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 pueden utilizarse para ejecutar un bloque de código repetidamente. El siguiente caso de uso presenta la etiqueta for.

Caso de uso

Supongamos que tienes una oferta de zapatillas Nike y quieres enviar mensajes a los clientes que han expresado interés por Nike. Tienes un array de marcas de productos vistas en el perfil de cada cliente. Este array podría contener hasta 25 marcas de producto, pero solo quieres enviar mensajes a los clientes que vieron un producto Nike como una de sus 5 vistas de producto 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 caso de uso, comprobamos los cinco primeros elementos del array de marcas de zapatillas vistas. Si uno de esos elementos es Converse, creamos la variable converse_viewer y le asignamos el valor verdadero.

A continuación, enviamos el mensaje de oferta cuando converse_viewer es verdadero. En caso contrario, abortamos el mensaje.

Este es un ejemplo sencillo de cómo pueden utilizarse 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 pueden utilizarse para controlar cómo se renderiza Liquid. Puedes utilizar la etiqueta echo para devolver una expresión. Esto es lo mismo que envolver una expresión con llaves, excepto que puedes utilizar esta etiqueta dentro de etiquetas de Liquid. También puedes utilizar la etiqueta liquid para tener un bloque de Liquid sin delimitadores en cada etiqueta. Cada etiqueta debe ir en su propia línea cuando utilices 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 a contenido conectado guardándolo primero como una variable local y utilizando después 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 %}

Envío de mensajes en función del idioma, la configuración regional más reciente y la zona horaria

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

Caso de uso: localización basada en la configuración regional reciente

A continuación se muestra un caso de uso sobre cómo puedes utilizar 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 caso de uso, los clientes con una configuración regional más reciente de pt_BR recibirán un mensaje en portugués brasileño, y los clientes con una configuración regional más reciente de pt_PT recibirán un mensaje en portugués europeo. Los clientes que no cumplan las dos primeras condiciones, pero que tengan el idioma configurado como portugués, recibirán un mensaje en el tipo de portugués predeterminado que elijas.

Caso de uso: dirigirse a usuarios por zona horaria

También puedes dirigirte a los usuarios por su zona horaria. Por ejemplo, envía un mensaje si están en EST y otro si están en PST. Para ello, guarda la hora actual en UTC y compara una sentencia if/else con la hora actual del usuario para enviar el mensaje correcto para la zona horaria correcta. Debes configurar la campaña para que se envíe en la zona horaria local del usuario, para que reciba la campaña a la hora adecuada.

Mira el siguiente caso de uso para saber cómo escribir un mensaje que se enviará entre las 14:00 y las 15:00 y tendrá 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 %}

Envío de mensajes con un número aleatorio

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

Caso de uso: 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 %}