Skip to content

Etiqueta de Liquid message extras

Usa la etiqueta de Liquid message_extras para anotar tus eventos de envío con datos dinámicos de Contenido conectado, Catálogos, atributos personalizados (como idioma, país), propiedades de entrada de Canvas u otros orígenes de datos.

La etiqueta de Liquid message_extras añade pares clave-valor al evento de envío correspondiente en Currents y Uso compartido de datos de Snowflake.

Para enviar datos dinámicos o adicionales a tu evento de envío de Currents o Uso compartido de datos de Snowflake, inserta la etiqueta de Liquid adecuada en el cuerpo de tu mensaje.

Este es un ejemplo del formato estándar de la etiqueta de Liquid para message_extras:

1

{% message_extras :key test :value 123 %}

Puedes añadir estas etiquetas según sea necesario para tus pares clave-valor en el cuerpo del mensaje. Sin embargo, la longitud de todas las claves y valores no debe superar los 1000 bytes (1 KB). En Currents y Uso compartido de datos de Snowflake, verás un nuevo campo de evento llamado message_extras para tus eventos de envío. Esto genera una cadena serializada en JSON en un solo campo.

Cómo se envían los datos de message extras usando Currents

Los message extras son pares clave-valor adjuntos en el momento del envío. La configuración depende del canal. Para correo electrónico, se añaden mediante encabezados. Para push en iOS, se incluyen en la carga útil del push. Todos los eventos de envío compatibles muestran el mismo campo message_extras en Currents (y Snowflake) una vez que se envía el mensaje.

Canales compatibles

La etiqueta message_extras es compatible con todos los tipos de mensaje que tienen un evento de envío, junto con los eventos de impresión de mensajes dentro de la aplicación. Usar message_extras con mensajes dentro de la aplicación requiere cumplir con ciertas versiones mínimas del SDK.

Cómo usar la etiqueta message_extras

  1. En el cuerpo del mensaje para el canal, introduce la etiqueta de Liquid message_extras. O bien, puedes usar el modal Añadir personalización y seleccionar Message Extras para el tipo de personalización.

El modal Añadir personalización con Message Extras seleccionado como tipo de personalización.

  1. Introduce el par clave-valor para cada etiqueta message_extras.

Un ejemplo de pares clave-valor para la etiqueta message extras. El campo de título dice "Your New Favorites". El mensaje muestra pares clave-valor para la etiqueta message extras y la siguiente frase: "We're excited to bring you a side selection of fresh and exciting products that are sure to become your new go-to favorites"

  1. Después de que tu campaña o Canvas se haya enviado, Braze adjuntará los datos dinámicos en el momento del envío a través de los eventos de envío de Currents o Uso compartido de datos de Snowflake en el campo message_extras.

Comprobación de la sintaxis

Cualquier otra entrada que no coincida con el estándar de la etiqueta descrito anteriormente puede no pasar a Currents o Snowflake. Comprueba que tu sintaxis o formato no incluya ninguno de los siguientes problemas:

  • Delimitadores inexistentes, vacíos o mal escritos
  • Claves duplicadas (Braze enviará de forma predeterminada el par clave-valor que se encuentre primero)
  • Texto adicional antes de que se definan las claves o los valores
  • Claves y valores desordenados
    • Por ejemplo, {% message_extras :value 123 :key test %}

Envío de información de códigos promocionales a Currents

Puedes combinar message_extras con códigos promocionales para enviar información sobre códigos promocionales a Currents. Utiliza la etiqueta capture para almacenar el código promocional en una variable y, a continuación, haz referencia a esa variable en message_extras:

1
2
3
4
5

{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}

Consideraciones

  • Los pares clave-valor que superen los 1000 bytes (1 KB) se truncarán.
  • Los espacios en blanco cuentan para el recuento de caracteres. Ten en cuenta que Braze omite los espacios en blanco iniciales y finales.
  • El JSON resultante solo genera valores de cadena.
  • Puedes incluir variables de Liquid como clave o valor, pero no puedes anidar etiquetas de Liquid adicionales dentro de message_extras.
    • Por ejemplo, podrías usar el siguiente Liquid: {% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

Preguntas frecuentes

¿Cómo puedo asociar el campo message_extras en los eventos de envío con mis eventos de interacción como aperturas y clics?

Se genera un dispatch_id y se proporciona en tus eventos de envío, que puede usarse como identificador único para vincularlo a eventos específicos de clic, apertura o entrega. Podrás usar y consultar este campo en Currents o Snowflake. Obtén más información sobre el comportamiento de dispatch_id.

¿Puedo usar message_extras con mensajes dentro de la aplicación?

Sí, puedes usar message_extras en tus mensajes dentro de la aplicación siempre que los dispositivos de tus usuarios tengan las siguientes versiones mínimas del SDK:
New Stuff!