Depurador de contenido conectado
Usa el depurador de contenido conectado para ver la solicitud y la respuesta en vivo de cada llamada de contenido conectado, de modo que puedas verificar tu endpoint, encabezados y etiquetas de Liquid antes de lanzar una Campaign o un Canvas.
Connected Content Debugger se encuentra actualmente en fase de acceso anticipado. Ponte en contacto con tu director de cuentas de Braze si te interesa participar en el acceso anticipado.
Acerca del depurador
El contenido conectado te permite enriquecer los mensajes con datos en tiempo real realizando una llamada HTTP a una API externa en el momento del renderizado y luego insertando la respuesta en tu mensaje con Liquid. Dado que esa llamada ocurre fuera de Braze, puede ser difícil ver exactamente qué solicitud envió Braze, qué devolvió el endpoint o por qué falló una llamada, antes de que una Campaign o Canvas esté en vivo.
El depurador de contenido conectado ayuda a solucionar esos problemas antes del lanzamiento. Te muestra la solicitud y la respuesta en vivo de cada llamada de contenido conectado en tu mensaje en la sección Vista previa y prueba. De esta forma, puedes confirmar que tu endpoint, encabezados y etiquetas de Liquid están configurados correctamente, todo dentro del panel de Braze.
Canales compatibles
El depurador de contenido conectado está disponible para los siguientes canales:
- Content Cards
- Correo electrónico
- Incluye plantillas
- Excluye pies de página y páginas de suscripción
- Mensajes dentro de la aplicación
- Notificaciones push
- SMS/MMS/RCS
- Webhooks
- Incluye plantillas
Durante el acceso anticipado, el depurador está disponible para la mayoría de los canales, pero aún no para KakaoTalk, LINE, Banners ni superficies de composición no específicas de canal (como Content Blocks, el paso de actualización de usuario de Canvas y el paso de contexto). Si no ves el depurador, es posible que la depuración de contenido conectado aún no sea compatible con esa característica.
Usar el depurador
Cada vez que ejecutas una vista previa, Braze renderiza automáticamente los resultados de la llamada de contenido conectado en la pestaña Vista previa. Para usar el depurador:
- Configura tu mensaje con la etiqueta
{% connected_content %}. - Ve a la sección Vista previa y prueba. Si tu mensaje incluye una etiqueta de contenido conectado, puedes ver un resumen con el número de llamadas de contenido conectado y los estados de éxito y error.
- Selecciona Ver detalles para abrir el depurador junto a tu vista previa. El panel lateral muestra una tabla con la URL y el resultado de cada llamada de contenido conectado.
- Junto a cada URL y resultado, selecciona Ver para ver los encabezados de solicitud y respuesta, la carga útil, el método, la duración y la información de almacenamiento en caché.
- Revisa los resultados, ajusta tu etiqueta, encabezados o endpoint según sea necesario. Luego, genera una nueva vista previa para confirmar la corrección.
Si tu plantilla contiene más de una etiqueta {% connected_content %}, el depurador enumera cada llamada que se realizó. Para canales que renderizan múltiples cuerpos de mensaje a partir de una plantilla (por ejemplo, correo electrónico, que renderiza cuerpos HTML, texto plano y AMP por separado, o Quick Push, que renderiza cuerpos específicos para cada dispositivo por separado), el depurador muestra cada llamada de contenido conectado realizada en todos los cuerpos, no solo en el que estás previsualizando activamente.
Comprender la salida de depuración
Cada llamada de contenido conectado aparece con sus propias pestañas Response y Request. La pestaña Response se muestra de forma predeterminada, ya que generalmente es el primer indicador para confirmar si una llamada fue exitosa.
Detalles de la URL
| Campo | Descripción |
|---|---|
| URL | La URL completamente renderizada que Braze llamó, con todas las etiquetas de Liquid resueltas. |
| Method | El método HTTP utilizado (GET o POST). |
| Status code | El código de estado HTTP que devolvió tu endpoint (por ejemplo, 200, 404, 500). Consulta Solución de problemas de códigos de respuesta para los códigos específicos de Braze. |
Pestaña Response
| Campo | Descripción |
|---|---|
| Duration | Cuánto tiempo tardó la solicitud en completarse, en segundos. La duración solo se muestra para las llamadas en vivo (no almacenadas en caché). |
| Served from cache | Indica si esta respuesta se sirvió desde la caché de contenido conectado de Braze en lugar de una llamada en vivo a tu endpoint (Yes o No). Un resultado almacenado en caché refleja una respuesta anterior, no necesariamente el estado actual de tu endpoint. |
| Response body | El cuerpo devuelto por tu endpoint. |
Pestaña Request
| Campo | Descripción |
|---|---|
| Headers | Los encabezados de solicitud que Braze envió, incluidos los configurados con :headers. |
| Body | El cuerpo de la solicitud enviado, si lo hay (solicitudes POST). |
Redacción de credenciales
Si tu etiqueta de contenido conectado utiliza :basic_auth, encabezados secretos comunes, claves u otras opciones de credenciales de autenticación, el depurador redacta esos valores en la pestaña Request y los reemplaza con una serie de asteriscos (*). Esto te permite confirmar que las credenciales se incluyeron en la solicitud sin exponer los valores en Preview & Test.
Los errores de autenticación siguen siendo visibles incluso cuando las credenciales están redactadas: si tu endpoint devuelve un 401 o 403, ese código de estado aparece normalmente en la pestaña Response, de modo que puedes saber que tu solicitud fue rechazada por motivos de autenticación aunque la credencial en sí esté oculta.
Solución de problemas de códigos de respuesta
Errores de endpoint frente a límites impuestos por Braze
No todos los códigos de estado que no son 2XX en la pestaña Response provienen de tu endpoint. Braze aplica sus propios límites a las llamadas de contenido conectado, y estos pueden producir respuestas que se parecen a un error de endpoint.
Si ves códigos de respuesta como 408, 429, 502, 503, 504 o 599, el problema suele estar del lado de Braze en la llamada, relacionado con el estado del host, el tiempo de espera o el tamaño de la carga útil. Si tu endpoint devuelve respuestas grandes de forma constante, considera reducir la carga útil de la respuesta para incluir solo los campos que tu mensaje necesita.
El endpoint devolvió un código de estado inesperado
Usa la pestaña Request para confirmar la URL exacta, los encabezados y el cuerpo que Braze envió. Una causa común de respuestas 4XX inesperadas es una etiqueta de Liquid dentro de la URL, los encabezados o el cuerpo que no se resolvió como esperabas. Comprueba que cualquier referencia {{ }} apunte a campos que existan para el usuario o el contexto con el que estás previsualizando.
La respuesta parece obsoleta
Comprueba Served from cache en la pestaña Response. Si muestra Yes, el depurador está mostrando una respuesta previamente almacenada en caché en lugar de una llamada nueva. Añade :no_cache a tu etiqueta temporalmente, o espera a que la caché expire (según :cache_max_age), para confirmar el comportamiento actual del endpoint.