Uso de plantillas Liquid

Las plantillas Liquid amplían significativamente las capacidades de personalización de Pushwoosh al implementar una lógica sofisticada además del uso regular del Contenido Dinámico.

La personalización de mensajes en Pushwoosh se basa en Tags (datos de usuario). Pushwoosh ofrece una variedad de Tags predeterminados y Tags personalizados. Usándolos, puede especificar el nombre del usuario, la ciudad, el historial de compras, etc. para enviar un mensaje más personalizado, por ejemplo: Hola {First_name}, gracias por pedir {item}.

Las plantillas Liquid añaden más lógica al contenido dinámico. Por ejemplo, si el tag de suscripción de un usuario contiene “free”, puede enviarle un mensaje: “Obtenga su 10% de descuento”.

Modificar el contenido del mensaje según los ID, comportamientos y preferencias de los usuarios es la forma más eficiente de aumentar la relevancia y obtener resultados más impresionantes de sus campañas de marketing.

Sintaxis

Las plantillas de contenido basadas en Liquid de Shopify utilizan una combinación de tags, objetos y filtros para cargar contenido dinámico. Las plantillas de contenido le permiten acceder a ciertas variables desde una plantilla y mostrar sus datos sin tener que saber nada sobre los datos en sí.

Nota

Para obtener más información sobre la sintaxis, consulte la documentación de Liquid.

Objetos

Los objetos definen el contenido que se mostrará a un usuario. Los objetos deben estar encerrados entre llaves dobles: {{ }}

Por ejemplo, al personalizar un mensaje, envíe {{Name}} en su cuerpo para agregar los nombres de los usuarios al contenido del mensaje. El nombre del usuario (valor del Tag Name) reemplazará el objeto Liquid en el mensaje que el usuario verá.

Entrada

Hi {{Name}}! We're glad you're back!

Salida

Hi Anna! We’re glad you’re back!

Tags

Los tags crean la lógica y el flujo de control para las plantillas. Los delimitadores de porcentaje de llave {% y %} y el texto que los rodea no producen ninguna salida visible cuando se renderiza la plantilla. Esto le permite asignar variables y crear condiciones o bucles sin mostrar ninguna de la lógica de Liquid a un usuario.

Por ejemplo, usando el tag if, puede variar el idioma del mensaje según el idioma configurado en el dispositivo del usuario:

Entrada

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

Salida (fr)

Salut!

Salida (es)

Hello!

Operadores de Tags

Operador	Descripción
==	igual a
!=	no es igual a
>	mayor que
<	menor que
>=	mayor o igual que
<=	menor o igual que
or	o lógico
and	y lógico
contains	comprueba la presencia de una subcadena dentro de una cadena o un array de cadenas

Nota

En los tags con más de un operador and u or, los operadores se comprueban en orden de derecha a izquierda. No se puede cambiar el orden de las operaciones usando paréntesis — los paréntesis son caracteres no válidos en Liquid e impedirán que sus tags funcionen.

Filtros

Los filtros modifican la salida de un objeto o variable Liquid. Se utilizan dentro de llaves dobles {{ }} y en la asignación de variables, y se separan por un carácter de barra vertical |. Se pueden usar múltiples filtros en una salida, y se aplican de izquierda a derecha.

Entrada

{{ Name | capitalize | prepend:"Hello " }}

Salida

Hello Anna

Uso de plantillas Liquid en mensajes enviados a través de la API

Use la sintaxis de Liquid en sus solicitudes createMessage para implementar plantillas Liquid. Las plantillas están disponibles para el parámetro “content” de la solicitud createMessage, así como para cualquier otro parámetro que admita Contenido Dinámico, en particular, los parámetros específicos de la plataforma “title”, “subtitle” e “image”.

Al usar plantillas de contenido, puede especificar los datos en sus solicitudes de API (pasando el parámetro “template_bindings”) u obtener los datos de los valores de los Tags almacenados en los dispositivos de los usuarios (al no usar el parámetro “template_bindings”). De esta manera, puede crear campañas push basadas en el usuario que contengan contenido extremadamente relevante.

Nota

Tenga en cuenta que, a diferencia del Contenido Dinámico, las variables en las plantillas deben estar encerradas entre llaves dobles de la siguiente manera: {{myVariable}}.

Para definir la lógica de la plantilla usando Tags con espacios en sus nombres, use la siguiente técnica:

Ejemplo

{% capture my_tag %}{{My Tag}}{% endcapture %}
{% if my_tag == 'value' %}
Contenido a enviar en este caso
{% else %}
Contenido a enviar en caso contrario
{% endif %}

Casos de uso de las plantillas Liquid

Aquí encontrará varios casos de uso en los que las plantillas Liquid son útiles.

Push multilingüe

Las plantillas Liquid permiten especificar definitivamente en qué idioma los usuarios deben recibir sus mensajes push. Vea el ejemplo simple de la solicitud de API y el mensaje recibido dependiendo de los enlaces de plantilla utilizados en la solicitud.

Entrada Liquid

{% if Language == 'es' %}
¡Hola!
{% else %}
Hello!
{% endif %}

Solicitud de API

{
  "request": {
    "application": "XXXXX-XXXXX", // Código de la aplicación Pushwoosh
    "auth": "yxoPUlw.....IyEX4H", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
       "content": "{% raw %}
{% if language == 'es' %}¡Hola!{% else %}hello!{% endif %}
{% endraw %}",
        "template_bindings": { // opcional. Cuando no se pasan template_bindings en una solicitud, se utilizan los valores de los Tags del dispositivo.
         "language" : "es"
        }
      }
    ]
  }
}

Salida

El idioma es ‘es’: ¡Hola!

El idioma es ‘en’: Hello!

Aviso de actualización de suscripción

Anime a sus clientes a actualizar su suscripción en función de su plan actual.

Entrada Liquid

{% if Subscription == 'Basic' %}
    Actualice a Silver para obtener más funciones del producto y soporte 24/7.
{% elsif Subscription == 'Silver' %}
    Actualice a Gold para obtener soporte prioritario y funciones avanzadas.
{% else %}
    Por favor, póngase en contacto con su gerente para renovar su suscripción.
{% endif %}

Solicitud de API

{
  "request": {
    "application": "XXXXX-XXXXX", // Código de la aplicación Pushwoosh
    "auth": "yxoPUlw.....IyEX4H", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
       "content": "{% raw %}
{% if Subscription == 'Basic' %}Actualice a Silver para obtener más funciones del producto y soporte 24/7.{% elsif Subscription == 'Silver' %}Actualice a Gold para obtener soporte prioritario y funciones avanzadas.{% else %}Por favor, póngase en contacto con su gerente para renovar su suscripción. {% endif %}
{% endraw %}",
        "template_bindings": { // opcional. Cuando no se pasan template_bindings en una solicitud, se utilizan los valores de los Tags del dispositivo.
         "language" : "es"
        }
      }
    ]
  }
}

Salida

Para usuarios con plan de suscripción Básico: Actualice a Silver para obtener más funciones del producto y soporte 24/7.

Para usuarios con plan de suscripción Silver: Actualice a Gold para obtener soporte prioritario y funciones avanzadas.

Para usuarios con otros planes: Por favor, póngase en contacto con su gerente para renovar su suscripción.

Tags de lista

Las plantillas de contenido son muy útiles para manejar Tags de tipo Lista.

Tamaño variable

Uno de los posibles casos de uso es entregar contenido diferente dependiendo del número de valores que contenga el Tag. Por ejemplo, puede ofrecer diferentes descuentos a clientes con diferentes comportamientos. Digamos que el cliente tiene algunos artículos en su WishList—¡anímelo a comprar con el descuento más adecuado en función de cuántos productos va a comprar!

Entrada Liquid

{% if WishList.size >= 3 %}
¡Obtenga un 20% de descuento en su próxima compra!
{% elsif WishList.size == 2 %}
¡Obtenga un 10% de descuento en su próxima compra!
{% else %}
¡Oye, echa un vistazo a las nuevas prendas de abrigo!
{% endif %}

Solicitud de API

{
  "request": {
    "application": "XXXXX-XXXXX", // Código de la aplicación Pushwoosh
    "auth": "yxoPUlw.....IyEX4H", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
       "content": "{% raw %}
{% if WishList.size >= 3 %}¡Obtenga un 20% de descuento en su próxima compra!{% elsif WishList.size == 2 %}¡Obtenga un 10% de descuento en su próxima compra!{% else %}¡Oye, echa un vistazo a las nuevas prendas de abrigo!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

Tamaño de WishList ≥ 3

Tamaño de WishList = 2

La variable contiene

Un caso más que podría necesitar cubrir es tratar con los valores de los Tags de Lista y entregar el contenido más relevante en función de los valores que contiene el Tag.

Entrada Liquid

{% if WishList contains 'Skinny Low Ankle Jeans' %}
¡Obtenga un 20% de descuento en los productos de su lista de deseos!
{% else %}
¡Oye, echa un vistazo a los nuevos Skinny Low Ankle Jeans!
{% endif %}

Solicitud de API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
       "content": "{% raw %}
{% if WishList contains 'Skinny Low Ankle Jeans' %}¡Obtenga un 20% de descuento en su próxima compra!{% else %}¡Oye, echa un vistazo a los nuevos Skinny Low Ankle Jeans!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

La variable contiene datos

La variable no contiene datos

Plurales

Al usar las plantillas de contenido, puede ajustar el contenido del mensaje según el comportamiento de los usuarios. Por ejemplo, puede modificar el texto del mensaje para que contenga palabras en plural en caso de que el Tag de Lista contenga más de un valor.

Entrada Liquid

    Obtenga un 20% de descuento en el artículo
{% if WishList.size > 1 %}
    s en su WishList!
{% else %}
    en su Wishlist!
{% endif %}

Solicitud de API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
       "content": "Obtenga un 20% de descuento en el artículo{% raw %}
{% if WishList.size > 1 %}s en su WishList!{% else %} en su Wishlist!{% endif %}
{% endraw %}",
        "template_bindings": { // opcional. Cuando no se pasan template_bindings en una solicitud, se utilizan los valores de los Tags del dispositivo.
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

Plural

Singular

Zona horaria

La plantilla para zonas horarias convierte la fecha y la hora según la zona horaria especificada.

Entrada Liquid

{{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}

Solicitud de API

Ejemplo

{
  "request" : {
    "auth" : "3H9bk8w3.....Acge2RbupTB", // Token de acceso a la API desde el Panel de Control de Pushwoosh
    "application" : "XXXXX-XXXXX", // Código de la aplicación Pushwoosh
    "notifications" : [ // parámetros del mensaje push
      {
        "content": "Current Date: {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}",
        "template_bindings": { // opcional. Cuando no se pasan template_bindings en una solicitud, se utilizan los valores de los Tags del dispositivo.
         "MyDate" : "2019-07-23 15:00",
         "MyTimezone" : "Asia/Dubai"
        }
      }
    ]
  }
}

Salida

Contenido conectado

El contenido conectado es una función en las plantillas Liquid que le permite recuperar y usar dinámicamente datos de una fuente externa, como un servicio web, directamente dentro de sus mensajes de correo electrónico o notificaciones push. Esta función permite la personalización en tiempo real al obtener datos JSON de una URL especificada y guardarlos en una variable que se puede utilizar en su contenido.

Casos de uso clave

• Recomendaciones de productos: Muestre listas de productos personalizadas y adaptadas a cada usuario.

• Códigos promocionales: Inserte códigos promocionales únicos generados por un servicio de backend.

Requisitos previos

• Para usar el Contenido Conectado, debe tener su propio servicio de backend que genere y proporcione los datos requeridos (por ejemplo, códigos promocionales, recomendaciones de productos) basados en User ID, HWID o tags personalizados. Pushwoosh luego obtiene estos datos antes de enviar un mensaje.

Guía de implementación paso a paso

Paso 1. Configure el servicio de backend

El servicio de backend debe:

• Aceptar una solicitud que contenga parámetros específicos del usuario (por ejemplo, userId). El Contenido Conectado admite UserID, HWID o cualquier tag personalizado que haya configurado en su proyecto.
• Devolver una respuesta JSON con los datos requeridos. Este contenido se puede insertar dinámicamente en los mensajes

Cómo funciona

El servicio de backend actúa como un proveedor de datos, respondiendo a las solicitudes HTTP con información específica del usuario.

1. Pushwoosh envía una solicitud a su backend, pasando identificadores específicos del usuario como parámetros de consulta.
2. Su backend procesa la solicitud y recupera los datos solicitados.
3. Su backend devuelve una respuesta JSON.
4. Antes de enviar un mensaje, Pushwoosh obtiene la respuesta JSON del servicio de backend y utiliza los valores devueltos (por ejemplo, el code) en el contenido del mensaje de forma dinámica.

Respuesta de ejemplo

{ "code": "SPECIALOFFERFORUSER12345" }

Paso 2. Cree un preset con Contenido Conectado en Pushwoosh

1. En el editor de contenido Push o Email, inserte la sintaxis de Contenido Conectado en el campo del mensaje.

Ejemplo

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

Desglose de la sintaxis

connected_content	Obtiene datos JSON de la URL de backend especificada.
http://your-backend-url.com	El endpoint del backend que devuelve los datos requeridos en formato JSON.
userId={{ ${userid} }}	Un parámetro de consulta dinámico que pasa el ID de usuario al backend.
:save result	Almacena la respuesta JSON obtenida en la variable result para su uso en plantillas Liquid

Autenticación (opcional)

Si su servicio de backend requiere autenticación, puede incluir una clave de API o un token en la solicitud de Contenido Conectado para garantizar un acceso seguro.

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

Uso de tags en Contenido Conectado

Para incluir tags personalizados, insértelos como parámetros de consulta en la solicitud de Contenido Conectado ({{ tag_name }}).

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}

2. A continuación, agregue el texto del mensaje incorporando los datos recuperados, de esta manera:

Hey, {{userid}}, grab your personal promo code - {{result.code}}

3. Después de finalizar el contenido del mensaje y configurar los ajustes del preset, guárdelo para reutilizarlo en campañas.

Paso 3. Envíe un mensaje usando el preset configurado

Envíe un mensaje con este preset usando el formulario de push único o formulario de correo electrónico o customer journey.

Importante

Si el servicio devuelve un estado diferente a HTTP 200 OK, el correo electrónico o la notificación push no se enviarán. Esto asegura que su comunicación solo se envíe si los datos necesarios se recuperan con éxito.