Ir al contenido

Supervisar la entrega de Content Cards con alertas y Currents

Usa herramientas de depuración, alertas de umbral, eventos de Currents y supervisión de la API para detectar caídas en la entrega de Content Cards antes de que los usuarios las notifiquen.

Acerca de este ejemplo

Pyrite Financial, una marca ficticia de banca móvil, muestra una Content Card en un espacio dedicado de la pantalla de inicio de su aplicación. Se espera que ese espacio contenga una tarjeta para la mayoría de los usuarios, así que un espacio vacío es una señal que merece la pena investigar.

Este ejemplo muestra cómo:

  1. Validar la integración de Content Cards durante las pruebas con el SDK Debugger, los grupos internos y el registro de usuarios del evento
  2. Configurar alertas de umbral de campaña o Canvas sobre el volumen de mensajes esperado
  3. Hacer un seguimiento de las entradas en Canvas, los envíos de Content Cards, las impresiones y las cancelaciones en Currents
  4. Vigilar los endpoints de la REST API que desencadenan la mensajería para detectar caídas de volumen y respuestas distintas de 200
  5. Añadir comprobaciones complementarias del volumen de envíos en Datadog o con los endpoints de exportación de Canvas
  6. Registrar el comportamiento alternativo de la aplicación que Braze no puede observar

Usa este enfoque cuando la ubicación de una Content Card sea crítica para el negocio y necesites una señal operativa de que la entrega ha caído. Cada paso es opcional, así que empieza por los que tu espacio de trabajo ya admite.

Consideraciones

  • Decide primero si todos los usuarios segmentados deben ver siempre una tarjeta en la ubicación, o si un espacio vacío es aceptable para algunos usuarios. Los umbrales de volumen y la lógica alternativa dependen de esa respuesta.
  • Braze supervisa la conectividad del SDK e informa de las incidencias en la página de estado de Braze. Este ejemplo cubre lo que supervisas tú: la configuración de campañas y Canvas, el volumen de mensajes, el tráfico de la API y el comportamiento alternativo de la aplicación.
  • No todos los desencadenantes generan un mensaje. Cuando un desencadenante llega a Braze, la lógica del recorrido, la segmentación, la limitación de frecuencia y el límite de velocidad pueden reducir los envíos. Compara el volumen de desencadenantes con el volumen de envíos como una tendencia, no como una correspondencia uno a uno.
  • La supervisión a nivel de evento requiere Currents. Sin Currents, usa los análisis de campañas y Canvas, las alertas de umbral y los endpoints de exportación REST.
  • Las métricas de Datadog solo informan del recuento de envíos y pueden diferir ligeramente del panel de Braze y de Currents.
  • Las actualizaciones excesivas pueden verse afectadas por el límite de velocidad. El SDK aplica límites de velocidad por dispositivo a las solicitudes de actualización de Content Cards. Llama al método de actualización en momentos significativos del ciclo de vida del usuario, en lugar de hacerlo repetidamente en poco tiempo. Consulta Límite de velocidad de Content Cards y Mejorar la latencia de las Content Cards como banners.
  • Liquid puede suprimir una tarjeta intencionadamente. Cuando Liquid cancela un mensaje, Braze registra un evento de cancelación de Content Card en lugar de un envío. Trata las cancelaciones como un comportamiento esperado del contenido condicional y solo como una señal cuando cambia su volumen.
  • Si tu aplicación muestra contenido predeterminado cuando no hay ninguna tarjeta disponible, haz un seguimiento de ello en tus propios análisis de la aplicación. Braze solo sabe lo que envió, no si tu aplicación mostró una tarjeta o un marcador de posición.

Configuración

Paso 1: Valida la integración antes del lanzamiento

Confirma el comportamiento esperado para que las alertas en producción reflejen problemas reales y no deficiencias de la integración.

  1. Crea una sesión de depuración en el SDK Debugger para ver la actividad del SDK en tiempo real y confirmar que se registran las solicitudes de tarjetas y las impresiones.
  2. Añade cuentas de prueba a un grupo interno para poder probar la campaña o el Canvas con usuarios de prueba antes del lanzamiento.
  3. Consulta el registro de usuarios del evento de un usuario concreto para confirmar qué campaña entregó cada tarjeta al SDK.

Anota los volúmenes de envíos, impresiones y cancelaciones que veas durante las pruebas. Serán la referencia para los umbrales que configures.

Paso 2: Configura alertas de umbral en la campaña o el Canvas

Las alertas de umbral te avisan por correo electrónico o webhook cuando el volumen de mensajes sale del intervalo que esperas. Las alertas por webhook pueden dirigirse a un canal de Slack o a un sistema de guardia.

  • Campañas: Configura umbrales superiores e inferiores en la página de análisis de la campaña. Para ver los pasos de configuración, consulta Alertas de campaña.
  • Canvas: Configura alertas sobre las entradas de usuarios, los mensajes enviados o ambos desde la página Gestionar alertas. Para ver los pasos de configuración, consulta Alertas de umbral de Canvas.

Elige un umbral inferior que sea menor que el volumen normal y mayor que cero, para que una caída parcial desencadene una notificación en lugar de esperar a una interrupción total.

Paso 3: Haz un seguimiento de las entradas, los envíos y las impresiones en Currents

Currents transmite eventos de participación con los mensajes y de comportamiento del cliente a tu plataforma de datos casi en tiempo real, lo que te permite supervisar el volumen y la latencia fuera del panel de Braze.

Para una Content Card enviada desde un Canvas, estos eventos cubren el recorrido desde la entrada hasta la impresión.

Evento Nombre del evento en Currents Qué te indica
Entrada en Canvas users.canvas.Entry Un usuario entró en el Canvas que envía la tarjeta
Envío de Content Card users.messages.contentcard.Send Braze creó y envió la tarjeta para el usuario
Impresión de Content Card users.messages.contentcard.Impression La tarjeta registró una impresión para el usuario
Cancelación de Content Card users.messages.contentcard.Abort La lógica de Liquid impidió que se enviara la tarjeta

Para una campaña de Content Card, supervisa los eventos de envío, impresión y cancelación, y filtra por campaign_id.

  • Supervisión del volumen: Haz un seguimiento de los envíos y las impresiones por Canvas o campaña durante un intervalo fijo y crea una alerta cuando el volumen caiga por debajo de un umbral basado en datos históricos.
  • Supervisión de la latencia: Compara los eventos de entrada con los de envío para medir la latencia de creación, y los eventos de envío con los de impresión para medir la latencia de visualización. Si las tarjetas se crean en la primera impresión, medir desde la entrada hasta la impresión mezcla el tiempo de creación y el de visualización, así que usa el tiempo entre envío e impresión para la latencia de visualización.

Comparar los volúmenes entre etapas te ayuda a identificar modos de fallo habituales:

  • Menos entradas apuntan a un problema en el desencadenante previo o en la audiencia.
  • Entradas estables con menos envíos pueden apuntar a la lógica del recorrido, a la segmentación o a cancelaciones de Liquid. Si las tarjetas se crean en la primera impresión, también puede significar que los usuarios aún no han abierto la aplicación.
  • Envíos estables con menos impresiones apuntan a algo entre la creación de la tarjeta y su visualización, como la actualización del SDK, la representación de la ubicación o los límites de velocidad del dispositivo.

Para ver las cargas útiles y los campos de los eventos, consulta Eventos de participación con los mensajes.

Paso 4: Vigila el tráfico de la API y las respuestas de error

Si tus desencadenantes se originan en tus propios sistemas, supervisa la capa de API que los alimenta.

  1. Configura alertas de uso de la API en los endpoints que desencadenan tu mensajería. Configura condiciones para las caídas de volumen y los aumentos de respuestas distintas de 200.
  2. Revisa las respuestas distintas de 200 de esos endpoints. Un aumento de las respuestas de error puede indicar que una versión reciente introdujo una solicitud con formato incorrecto o que las llamadas están alcanzando un límite de velocidad.

Paso 5: Añade comprobaciones complementarias del volumen

Úsalas cuando quieras tener datos del volumen de envíos en una herramienta de observabilidad existente o en un trabajo programado.

  • Datadog: La integración con Datadog proporciona la métrica braze.messaging.sent, etiquetada con identificadores de campaña, Canvas y paso en Canvas. Úsala para obtener recuentos de envíos de un paso de mensaje concreto en un periodo determinado. Esos recuentos se aproximan al volumen de envíos de Content Cards a nivel agregado y no incluyen identificadores de usuario ni de envío.
  • Endpoints de exportación: Consulta periódicamente /canvas/data_series y /canvas/data_summary para obtener las entradas en Canvas y los envíos de mensajes, y luego compara los resultados entre ejecuciones para detectar tendencias y anomalías.

Paso 6: Registra el comportamiento alternativo en tu aplicación

Braze informa de lo que envió, no de lo que tu aplicación mostró. Añade registros o análisis en la aplicación para los casos que Braze no puede observar:

  • La actualización de la fuente se completó, pero no había tarjetas disponibles para la ubicación.
  • La aplicación mostró contenido alternativo en lugar de una tarjeta.
  • La solicitud de actualización falló o se vio afectada por el límite de velocidad.

Envíalos como eventos personalizados si quieres tenerlos junto a los datos de Braze, o mantenlos en tu propia plataforma de análisis y compáralos con el volumen de impresiones de Currents.

Paso 7: Clasifica el problema cuando salte una alerta

Realiza estas comprobaciones en orden:

  1. Confirma que no hay ninguna incidencia activa en la página de estado de Braze.
  2. En Currents (o en los análisis de Canvas y campañas), compara los volúmenes de entradas, envíos, impresiones y cancelaciones del mismo intervalo. Si las tarjetas se crean en la primera impresión, el volumen de entradas puede superar al de envíos hasta que los usuarios abran la aplicación; tenlo en cuenta al comparar volúmenes.
  3. Revisa las alertas de uso de la API y las respuestas distintas de 200 en los endpoints que desencadenan el mensaje.
  4. Compara los eventos de contenido alternativo o de ubicación vacía de la aplicación con el volumen de impresiones de Currents.
  5. Reprodúcelo con un usuario de muestra en el SDK Debugger y en el registro de usuarios del evento.
New Stuff!