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.
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 un Canvas estén 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 manera, puedes confirmar que tu endpoint, encabezados y etiquetas de Liquid están configurados correctamente, todo dentro del panel de Braze.
Áreas compatibles
El depurador de contenido conectado está disponible para las siguientes áreas:
- Banners
- Pasos de contexto de Canvas
- Content Cards
- Correo electrónico
- Incluye plantillas
- Excluye pies de página y páginas de suscripción
- In-App Messages
- Notificaciones push
- SMS/MMS/RCS
- Webhooks
- Incluye plantillas
El depurador está disponible para la mayoría de los canales, pero aún no para KakaoTalk, LINE ni superficies de composición no específicas de canal (como Content Blocks y el paso de actualización de usuario de Canvas). 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 Preview & Test. 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 View details 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 View 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 lista cada llamada realizada. Para canales que renderizan múltiples cuerpos de mensaje o variantes de plataforma a partir de una sola plantilla, el depurador lista cada llamada de contenido conectado a través de esas renderizaciones, no solo el cuerpo que estás previsualizando. El correo electrónico puede producir pasadas de renderización HTML y texto plano separadas (y páginas móviles aceleradas (AMP) al enviar), por lo que la misma URL puede aparecer más de una vez. Quick Push puede renderizar para hasta cuatro plataformas (iOS, Android, Web y Kindle), por lo que la misma referencia de contenido conectado puede aparecer hasta cuatro veces.
Esas repeticiones coinciden con la forma en que Braze renderiza y envía el mensaje; el depurador no las consolida. Para más información sobre por qué el volumen de llamadas puede superar los envíos, consulta Comprender el volumen de llamadas de contenido conectado.
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 tuvo éxito.
Detalles de la URL
| Campo | Descripción |
|---|---|
| URL | La URL completamente renderizada que Braze llamó, con cualquier etiqueta de Liquid resuelta. |
| 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 conocer 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 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 | Encabezados de tu etiqueta de contenido conectado (:headers, credenciales y opciones como :content_type). |
| Body | El cuerpo de la solicitud enviado, si lo hay (solicitudes POST). |
Qué encabezados de solicitud aparecen en el depurador
La pestaña Request muestra los encabezados de tu etiqueta de contenido conectado: :headers personalizados, credenciales almacenadas y encabezados establecidos por opciones de la etiqueta como :content_type y :basic_auth. Braze también añade encabezados estándar en la solicitud saliente a tu endpoint (por ejemplo, User-Agent y Host). Esos encabezados añadidos por Braze aparecen en el depurador cuando los configuras en :headers.
Para enviar un User-Agent consistente, configúralo en :headers. Braze usa tu valor, y el depurador muestra ese encabezado.
Braze añade los siguientes encabezados a las solicitudes salientes de contenido conectado. La mayoría se establecen solo cuando no los has proporcionado previamente en la etiqueta. Los encabezados que proporcionas con :headers, credenciales u opciones de etiqueta se envían tal cual.
| Encabezado | Cuándo lo establece Braze |
|---|---|
User-Agent |
Si no lo has establecido previamente, Braze envía Braze Sender <version>. La cadena de versión puede cambiar. Si filtras el tráfico por User-Agent, permite todos los valores que comiencen con Braze Sender. Para enviar un valor consistente, establece User-Agent en :headers. |
X-Braze-Sender-Version |
Siempre se establece con la versión del remitente de contenido conectado. |
Accept-Encoding |
Si no lo has establecido previamente, Braze envía gzip. |
Authorization |
Si la URL incluye un nombre de usuario y una contraseña (user:pass@host), Braze añade un encabezado Authorization de tipo Basic derivado de esas credenciales. Un encabezado Authorization explícito lo sobrescribe. Prefiere :basic_auth o :headers en lugar de incluir credenciales en la URL. |
Host |
Nombre de host de la URL de la solicitud (por ejemplo, www.example.com para https://www.example.com/abc/123), a menos que establezcas un encabezado Host. |
Content-Length |
Tamaño del cuerpo de la solicitud en bytes cuando hay un cuerpo presente. |
BrazeToBraze |
Se establece como true solo para solicitudes a endpoints REST de Braze. Se omite para otros destinos. |
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 oculta 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 ocultas: si tu endpoint devuelve un 401 o 403, ese código de estado aparece con normalidad en la pestaña Response, para que puedas saber que tu solicitud fue rechazada por problemas de autenticación aunque la credencial en sí esté oculta.
Solución de problemas de códigos de respuesta
Errores del 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 impone sus propios límites en las llamadas de contenido conectado, y estos pueden producir respuestas que se parecen a un error del 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 consistente, considera reducir la carga útil de 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, los encabezados de tu etiqueta y el cuerpo. 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 contexto con el que estés previsualizando.
La respuesta parece desactualizada
Revisa 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.