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, e insertando después la respuesta en tu mensaje con Liquid. Dado que esa llamada ocurre fuera de Braze, puede resultar 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é en vivo.
El depurador de contenido conectado ayuda a solucionar esos problemas antes de lanzar. 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, los encabezados y las 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 que no son específicas de un 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 Vista previa y prueba. Si tu mensaje incluye una etiqueta de contenido conectado, puedes ver una vista resumida 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 todas las llamadas que se realizaron. Para los canales que renderizan múltiples cuerpos de mensaje a partir de una sola plantilla (por ejemplo, correo electrónico, que renderiza cuerpos HTML, texto plano y páginas móviles aceleradas por separado, o Quick Push, que renderiza cuerpos específicos de cada dispositivo por separado), el depurador muestra todas las llamadas de contenido conectado realizadas en todos los cuerpos, no solo el que estás previsualizando en ese momento.
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 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 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 definidos 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 utiliza 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 usa :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 fallos 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, para que puedas saber que tu solicitud fue rechazada debido a la 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 Respuesta provienen de tu endpoint. Braze aplica sus propios límites a las llamadas de contenido conectado, y estos pueden producir respuestas que parecen similares 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 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 Solicitud 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ó de la forma que 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 desactualizada
Comprueba Servido desde caché en la pestaña Respuesta. 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.