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 Snowflake Data Sharing.

Para enviar datos dinámicos o adicionales a tu evento de envío de Currents o Snowflake Data Sharing, 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 Snowflake Data Sharing, 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 extras de mensaje usando Currents

Los extras de mensaje son pares clave-valor que se adjuntan 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 exponen 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 mensajes que tienen un evento de envío, junto con los eventos de impresión de mensajes dentro de la aplicación. El uso de message_extras con mensajes dentro de la aplicación requiere que se cumplan ciertas versiones mínimas del SDK.

Cómo usar la etiqueta message_extras

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

El modal Add Personalization 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. Una vez que tu Campaign o Canvas se haya enviado, Braze adjunta los datos dinámicos en el momento del envío al campo message_extras en los eventos de envío de Currents o Snowflake Data Sharing.

Comprobación de la sintaxis

Cualquier otra entrada que no coincida con el estándar de etiquetas descrito anteriormente en esta sección puede no transmitirse correctamente 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 envía de forma predeterminada el par clave-valor que encuentra primero)
  • Texto adicional antes de que se definan las claves o los valores
  • Claves y valores en orden incorrecto
    • 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 truncan.
  • Los espacios en blanco cuentan para el recuento de caracteres. Ten en cuenta que Braze omite los espacios en blanco iniciales y finales.
  • Las salidas JSON resultantes solo generan 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, puedes 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 a mis eventos de participación como aperturas y clics?

Se genera un dispatch_id y se proporciona en tus eventos de envío, que puedes usar como identificador único para vincularlo a eventos específicos de clic, apertura o entrega. Consulta este campo en Currents o Snowflake. Para más información, consulta Comportamiento del ID de envío.

¿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!