Cancelar mensajes

Opcionalmente, puedes usar la etiqueta de mensaje Liquid abort_message("optional reason for aborting") dentro de condicionales para evitar el envío de un mensaje a un usuario. Este artículo de referencia enumera algunos ejemplos de cómo se puede usar esta característica en campañas de marketing.

Nota

Si un paso de mensaje se cancela en un Canvas, el usuario no saldrá del Canvas y sí avanzará al siguiente paso.

Envíos de prueba con abort_message()

abort_message() detiene el envío para los usuarios que no cumplen tu condición. El mensaje no aparecerá en su perfil y no contará para las entregas ni para la limitación de frecuencia.

Si los envíos de prueba nunca llegan, previsualiza como un usuario que satisface la condición de cancelación, luego en Envío de prueba habilita Sustituir los atributos de los destinatarios con los atributos del usuario de vista previa actual (o añade un miembro del grupo de prueba de contenido que cumpla los requisitos).

Cancelar mensaje si “Number Games Attended” = 0

Por ejemplo, supongamos que no quieres enviar un mensaje a clientes que no han asistido a un juego:

1
2
3
4
5
6
7
{% if custom_attribute.${Number_Game_Attended} == 1 %}
Loved the game? Get 10% off your second one with code SAVE10.
{% elsif custom_attribute.${Number_Game Attended} > 1 %}
Love the games? Get 10% off your next one with code SAVE10.
{% else %}
{% abort_message() %}
{% endif %}

Este mensaje solo se enviará a clientes que se sabe que han asistido a un juego.

Enviar mensajes solo a clientes de habla inglesa

Puedes enviar mensajes solo a clientes de habla inglesa creando una sentencia “if” que coincida cuando el idioma del cliente sea inglés y una sentencia “else” que cancele el mensaje para cualquiera que no hable inglés o no tenga un idioma en su perfil.

1
2
3
4
5
6
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}

De forma predeterminada, Braze registrará un mensaje de error genérico en tu Registro de actividad de mensajes:

1
{% abort_message %} called

También puedes hacer que el mensaje de cancelación registre algo en tu Registro de actividad de mensajes incluyendo una cadena dentro de los paréntesis:

1
{% abort_message('language was nil') %}

Consultar mensajes de cancelación

Puedes usar el Generador de consultas o tu propio almacén de datos, si está conectado a Braze, para consultar mensajes de cancelación específicos que se desencadenan cuando la lógica Liquid provoca la cancelación de un mensaje.

Cuándo se evalúa la lógica de cancelación

El momento en que se evalúa la lógica de cancelación depende del canal de mensaje.

Push, correo electrónico, SMS, webhooks y Content Cards

La lógica de cancelación se evalúa en el momento del envío, cuando Braze procesa el mensaje para su entrega.

Mensajes dentro de la aplicación

La lógica de cancelación se evalúa solo para mensajes dentro de la aplicación con plantilla en el momento en que se desencadena el mensaje dentro de la aplicación (por ejemplo, cuando el usuario realiza el evento desencadenante o inicia una sesión), no cuando el mensaje se envía inicialmente al dispositivo. Los mensajes dentro de la aplicación se entregan al SDK al inicio de la sesión y se almacenan en caché localmente; el Liquid, incluidas las llamadas a abort_message(), se ejecuta cuando se cumple la condición de desencadenamiento.

Solución de problemas de tasas altas de cancelación

Si una campaña o un paso en Canvas muestra muchos usuarios que ingresaron pero pocos envíos, o las entregas parecen más bajas de lo esperado, la lógica de cancelación es una causa común, especialmente cuando Liquid requiere atributos, datos de catálogo o valores de lista que faltan en el momento de la evaluación.

Revisar el Registro de actividad de mensajes

1. En el panel de Braze, abre el Registro de actividad de mensajes de la campaña o del paso de mensaje en Canvas.
2. Filtra las entradas relacionadas con cancelaciones. De forma predeterminada, Braze registra {% abort_message %} called. Si pasaste una cadena de motivo a abort_message(), ese texto aparecerá en su lugar.
3. Observa si las cancelaciones se agrupan en un canal (por ejemplo, solo correo electrónico) o en varios canales del mismo Canvas.

Verificar atributos y Liquid en el momento del envío

Para push, correo electrónico, SMS, webhooks y Content Cards, la lógica de cancelación se ejecuta cuando Braze procesa el mensaje para su entrega, no cuando el usuario ingresó a un Canvas ni cuando se disparó un evento desencadenante anteriormente.

• Confirma que los atributos personalizados, las propiedades del evento o los campos de catálogo requeridos estén configurados en el usuario antes de que se ejecute el paso de mensaje.
• Añade comprobaciones explícitas de nil o vacío antes de llamar a abort_message(). Una rama else que cancela cuando falta un valor detiene el envío para cualquier usuario sin esos datos.
• Si la personalización depende de una lista, un segmento o una respuesta de contenido conectado, confirma que los datos estén disponibles cuando se ejecute el paso de mensaje. Un usuario puede ingresar a un Canvas antes de que la pertenencia a la lista o los datos posteriores estén listos.

Comportamiento específico de Canvas

Si un paso de mensaje se cancela en un Canvas, el usuario no sale del Canvas. En su lugar, avanza al siguiente paso. Las cancelaciones solo afectan el conteo de envíos de ese paso de mensaje.

Al diagnosticar cancelaciones en Canvas:

• Compara los usuarios que ingresaron al paso de mensaje con los usuarios enviados en el mismo paso.
• Si solo un canal se cancela, revisa el Liquid específico del canal o el estado de suscripción para ese paso.
• Si las cancelaciones aumentan después de una actualización de lista o catálogo, verifica si el paso de mensaje se ejecutó antes de que se completara la actualización.

Validar con vista previa y envíos de prueba

Previsualiza como un usuario en el creador de mensajes cuyo perfil coincida con un destinatario afectado. Para los envíos de prueba, habilita Sustituir los atributos de los destinatarios con los atributos del usuario de vista previa actual cuando tu lógica de cancelación dependa de datos del perfil.

Para más ejemplos de cancelación, consulta Consultar mensajes de cancelación.

Consideraciones

La etiqueta de mensaje Liquid abort_message() evita que los mensajes se envíen a los usuarios, lo que significa que el mensaje no se mostrará en los perfiles de usuario y no contará para las entregas ni para la limitación de frecuencia.