Ir al contenido

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.

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 abort, luego en Test Send habilita Override recipients’ attributes with current preview user’s attributes (o añade un miembro de un grupo de prueba de contenido que califique).

Anular mensaje si “Number Games Attended” = 0

Por ejemplo, supongamos que no quieres enviar un mensaje a clientes que no hayan asistido a un partido:

{% 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 partido.

Enviar mensajes solo a clientes que hablan inglés

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

{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}

De forma predeterminada, el envío cancelado aparece en Observabilidad de mensajería con el resultado Liquid abort.

Puedes incluir una cadena de motivo dentro de los paréntesis:

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

Consulta de 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 activan cuando la lógica de Liquid provoca que un mensaje se cancele.

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 del 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.

In-App Messages

La lógica de cancelación se evalúa para mensajes dentro de la aplicación con plantilla solo en el momento en que se activa 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é de forma local; el Liquid, incluidas las llamadas a abort_message(), se ejecuta cuando se cumple la condición de activación.

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

Si una Campaign o un paso en Canvas muestra que muchos usuarios ingresaron pero se realizaron 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 del catálogo o valores de lista que faltan en el momento de la evaluación.

Consulta la Observabilidad de mensajería

  1. Abre Observabilidad de mensajería.
  2. Selecciona la Campaign o el Canvas, y luego selecciona Run Dashboard.
  3. En el registro granular, filtra por el resultado Liquid abort.
  4. Observa si las cancelaciones se concentran en un canal (como solo correo electrónico) o en varios canales dentro del mismo Canvas.

Verifica los 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 la entrega, no cuando el usuario ingresó a un Canvas o cuando un evento desencadenante se activó anteriormente.

  • Confirma que los atributos personalizados, las propiedades del evento o los campos del catálogo requeridos estén configurados en el usuario antes de que se ejecute el paso de mensaje.
  • Agrega 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 que no tenga esos datos.
  • Si la personalización depende de una lista, un Segment o una respuesta de contenido conectado, confirma que los datos estén disponibles cuando se ejecuta el paso de mensaje. Un usuario puede ingresar a un Canvas antes de que la membresía 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.

En un paso de contexto, abort_message afecta solo a la variable que lo llama: esa variable no se establece, las demás variables del paso sí se establecen, y el usuario avanza al siguiente paso. Las cancelaciones del paso de contexto no se registran en el registro de actividad de mensajes. Para más detalles, consulta Contexto.

Al diagnosticar cancelaciones en Canvas:

  • Compara los usuarios que ingresaron en el paso de mensaje con los usuarios que recibieron envíos 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 la actualización se completara.

Valida 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 envíos de prueba, habilita Override recipients’ attributes with current preview user’s attributes cuando tu lógica de cancelación dependa de los datos del perfil.

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

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.

New Stuff!