Lectura de registros detallados

En esta página se explica cómo interpretar la salida de registros detallados del SDK de Braze. Para cada canal de mensajería, encontrarás las entradas clave del registro que debes buscar, su significado y los problemas comunes a los que debes prestar atención.

Antes de empezar, asegúrate de haber habilitado el registro detallado y de saber cómo recopilar registros en tu plataforma.

Sesiones

Las sesiones son la base del análisis y la entrega de mensajes de Braze. Muchas características de mensajería, incluidos los mensajes dentro de la aplicación y Content Cards, dependen de que se inicie una sesión válida antes de poder funcionar. Si las sesiones no se registran correctamente, investiga esto primero. Para más información sobre cómo habilitar el seguimiento de sesiones, consulta Paso 5: Habilitar el seguimiento de sesiones de usuario.

Entradas clave del registro

• swift
• android

1
Started user session (id: <SESSION_ID>)

1
2
3
4
5
Ended user session (id: <SESSION_ID>, duration: <DURATION>s)
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: sessionEnd(duration: <DURATION>)

1
2
3
4
New session created with ID: <SESSION_ID>
Session start event for new session received
Completed the openSession call
Opened session with activity: <ACTIVITY_NAME>

1
2
3
Closed session with activity: <ACTIVITY_NAME>
Closed session with session ID: <SESSION_ID>
Requesting data flush on internal session close flush timer.

Qué verificar

• Verifica que aparezca un registro de inicio de sesión cuando se lanza la aplicación.
• Si no ves un inicio de sesión, comprueba que el SDK esté correctamente inicializado y que se esté llamando a openSession (Android).
• En Android, confirma que se esté realizando una solicitud de red al endpoint de Braze. Si no la ves, verifica tu clave de API y la configuración del endpoint.

Notificaciones push

Los registros de notificaciones push te ayudan a verificar que los tokens de dispositivo estén registrados, las notificaciones se entreguen y los eventos de clic se rastreen.

Registro de token

Cuando comienza una sesión, el SDK registra el token de notificaciones push del dispositivo con Braze.

• swift
• android

1
2
3
4
Updated push notification authorization:
- authorization: authorized

Received remote notifications device token: <PUSH_TOKEN>

1
2
3
4
5
6
"attributes": [
  {
    "push_token": "<PUSH_TOKEN>",
    "user_id": "<USER_ID>"
  }
]

1
2
3
4
"device": {
  "ios_push_auth": "authorized",
  "remote_notification_enabled": 1
}

1
Registering for Firebase Cloud Messaging token using sender id: <SENDER_ID>

Qué verificar

• Si push_token no aparece en el cuerpo de la solicitud, el token no fue capturado. Verifica la configuración push en la configuración de tu aplicación.
• Si ios_push_auth muestra denied o provisional, el usuario no ha otorgado permisos completos de push.
• En Android, si ves SENDER_ID_MISMATCH, actualiza tu ID de remitente de FCM para que coincida con tu proyecto de Firebase.

Entrega y clic de push

Cuando se toca una notificación push, el SDK registra los eventos de procesamiento y clic.

• swift
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
Processing push notification:
- date: <TIMESTAMP>
- silent: false
- userInfo: {
  "ab": { ... },
  "ab_uri": "<DEEP_LINK_OR_URL>",
  "aps": {
    "alert": {
      "body": "<MESSAGE_BODY>",
      "title": "<MESSAGE_TITLE>"
    }
  }
}

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: pushClick(campaignId: ...)

1
2
3
4
Opening '<URL>':
- channel: notification
- useWebView: false
- isUniversalLink: false

1
BrazeFirebaseMessagingService: Got Remote Message from FCM

Qué verificar

• Verifica que la carga útil de push contenga el title, body y cualquier vínculo profundo (ab_uri) esperados.
• Confirma que se registre un evento pushClick después de tocar la notificación.
• Si falta el evento de clic, verifica que tu app delegate o controlador de notificaciones esté reenviando correctamente los eventos push al SDK de Braze.

Mensajes dentro de la aplicación

Los registros de mensajes dentro de la aplicación te muestran el ciclo de vida completo: entrega desde el servidor, activación basada en eventos, visualización, registro de impresiones y seguimiento de clics.

Entrega del mensaje

Cuando un usuario inicia una sesión y es elegible para un mensaje dentro de la aplicación, el SDK recibe la carga útil del mensaje desde el servidor.

• swift
• android

1
2
3
4
5
6
7
8
9
"templated_message": {
  "data": {
    "message": "...",
    "type": "HTML",
    "message_close": "SWIPE",
    "trigger_id": "<TRIGGER_ID>"
  },
  "type": "inapp"
}

1
Triggering action: <CAMPAIGN_BSON_ID>

Visualización del mensaje e impresión

• swift
• android

1
2
3
In-app message ready for display:
- triggerId: (campaignId: <CAMPAIGN_ID>, ...)
- extras: { ... }

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageImpression(triggerIds: [...])

1
handleExistingInAppMessagesInStackWithDelegate:: Displaying in-app message

Eventos de clic y botón

Cuando un usuario pulsa un botón o cierra el mensaje:

• swift
• android

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageButtonClick(triggerIds: [...], buttonId: "<BUTTON_ID>")

1
No matching trigger for event.

Qué verificar

• Si el mensaje dentro de la aplicación no se muestra, verifica que primero se haya registrado un inicio de sesión.
• Filtra las respuestas de tu endpoint de Braze configurado para confirmar que la carga útil del mensaje fue entregada.
• Si las impresiones no se están registrando, verifica que no hayas implementado un delegado inAppMessageDisplay personalizado que suprima el registro.
• Si aparece “No matching trigger for event”, esto es normal e indica que no hay mensajes dentro de la aplicación adicionales configurados para ese evento.

Content Cards

Los registros de Content Cards te ayudan a verificar que las tarjetas se sincronizan con el dispositivo, se muestran al usuario y que se realiza el seguimiento de las interacciones (impresiones, clics, rechazos).

Sincronización de tarjetas

Las Content Cards se sincronizan al inicio de la sesión y cuando se solicita una actualización manual. Si no hay ninguna sesión registrada, no se muestran Content Cards.

• swift
• android

1
2
3
4
5
6
7
8
9
10
11
"cards": [
  {
    "id": "<CARD_ID>",
    "tt": "<CARD_TITLE>",
    "ds": "<CARD_DESCRIPTION>",
    "tp": "short_news",
    "v": 0,
    "cl": 0,
    "p": 1
  }
]

1
Requesting content cards sync.

Impresiones, clics y rechazos

• swift
• android

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardImpression(cardIds: [...])

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardClick(cardIds: [...])

1
2
3
Opening '<URL>':
- channel: contentCard
- useWebView: true

1
2
3
4
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardDismissed(cardIds: [...])

Qué hay que comprobar

• No se muestran tarjetas: Verifica que se haya registrado el inicio de la sesión. Las Content Cards requieren una sesión activa para sincronizarse.
• Faltan tarjetas para los nuevos usuarios: Es posible que los nuevos usuarios no vean las Content Cards en su primera sesión hasta la siguiente sesión. Este es el comportamiento esperado.
• La tarjeta supera el límite de tamaño: Las Content Cards de más de 2 KB no se muestran y el mensaje se cancela.
• La tarjeta persiste después de detener la campaña: Comprueba que la sincronización se haya completado después de detener la campaña. Las Content Cards se eliminan del dispositivo después de una sincronización correcta. Al detener una campaña, asegúrate de que la opción para eliminar las tarjetas activas de las fuentes de los usuarios esté seleccionada.

Vínculos profundos

Los registros de vínculos profundos aparecen en las notificaciones push, los mensajes dentro de la aplicación y Content Cards. La estructura del registro es consistente independientemente del canal de origen.

• swift
• android

1
2
3
4
5
Opening '<DEEP_LINK_URL>':
- channel: <SOURCE_CHANNEL>
- useWebView: false
- isUniversalLink: false
- extras: { ... }

1
adb shell am start -W -a android.intent.action.VIEW -d "<YOUR_DEEP_LINK>" "<YOUR_PACKAGE_NAME>"

Qué verificar

• Verifica que la URL del vínculo profundo coincida con lo que configuraste en la Campaign.
• Si el vínculo profundo funciona desde un canal (por ejemplo, push) pero no desde otro (por ejemplo, Content Cards), comprueba que tu implementación de gestión de vínculos profundos sea compatible con todos los canales.
• En iOS, los enlaces universales requieren gestión adicional. Si los enlaces universales no funcionan desde los canales de Braze, verifica que tu aplicación implemente el protocolo BrazeDelegate para la gestión de URLs.
• En Android, comprueba que la gestión automática de vínculos profundos esté deshabilitada si utilizas un controlador personalizado. De lo contrario, el controlador predeterminado puede entrar en conflicto con tu implementación.

Identificación de usuario

Cuando un usuario es identificado con un external_id, el SDK registra un evento de cambio de usuario.

• android
• swift

1
changeUser called with: <EXTERNAL_ID>

1
"user_id": "<EXTERNAL_ID>"

Solicitudes de red

Los registros detallados incluyen los detalles completos de las solicitudes y respuestas HTTP para la comunicación del SDK con los servidores de Braze. Son útiles para diagnosticar problemas de conectividad.

Estructura de la solicitud

Filtra las solicitudes a tu endpoint de Braze configurado (por ejemplo, sdk.iad-01.braze.com). La estructura de la solicitud incluye:

• swift
• android

1
2
3
4
5
6
7
[http] request POST: <YOUR_BRAZE_ENDPOINT>
- Headers:
  - Content-Type: application/json
  - X-Braze-Api-Key: <REDACTED>
  - X-Braze-Req-Attempt: 1
  - X-Braze-Req-Tokens-Remaining: <COUNT>
- Body: { ... }

1
Making request(id = <REQUEST_ID>) to <YOUR_BRAZE_ENDPOINT>

Qué verificar

• Clave de API: Verifica que XBraze-ApiKey coincida con la clave de API de tu espacio de trabajo.
• Endpoint: Confirma que la URL de la solicitud coincida con tu endpoint de SDK configurado.
• Reintentos: Un valor de XBraze-Req-Attempt mayor que 1 indica que el SDK está reintentando una solicitud fallida, lo que puede señalar problemas de conectividad.
• Límite de velocidad: XBraze-Req-Tokens-Remaining muestra los tokens de solicitud restantes. Un número bajo puede indicar que el SDK se está acercando a los límites de velocidad.
• Solicitudes faltantes: En Android, si no ves una solicitud al endpoint de Braze después del inicio de sesión, verifica la configuración de tu clave de API y endpoint.

Abreviaturas comunes de eventos

En las cargas útiles de registros detallados, Braze utiliza nombres de eventos abreviados. Aquí tienes una referencia:

Solución de problemas

Las geovallas no se activan en Android SDK 13.1.0–15.x

Las versiones 13.1.0 a 15.x de Braze Android SDK tenían una regresión que podía impedir que se registraran los eventos de actualización de geovallas. En dispositivos con Android 10 o versiones anteriores, las actualizaciones de ubicación al inicio de sesión también podían fallar. Actualiza a Android SDK 16.0.0 o posterior. Para la configuración del SDK, consulta Geovallas.

¿Cuándo podría un usuario tener 0 sesiones registradas en su perfil?

Un perfil de usuario puede mostrar 0 sesiones cuando importas al usuario a través de la REST API (/users/track) o mediante importación CSV sin los campos Primera sesión o Última sesión. Las sesiones se registran cuando los usuarios interactúan con tu aplicación a través del SDK. Para más información, consulta El perfil de usuario tiene 0 sesiones.

Discrepancias en los datos de usuario al utilizar el SDK y la REST API de forma simultánea

Cuando utilizas el SDK y la REST API al mismo tiempo, las condiciones de carrera pueden causar discrepancias en los datos. Después de llamar a changeUser(), permite que el SDK envíe los datos pendientes antes de realizar llamadas críticas a la REST API, evita agrupar actualizaciones urgentes y considera añadir un breve retraso entre las solicitudes del SDK y de la API. Para el comportamiento de changeUser(), consulta Cómo funciona changeUser().

Los datos no llegan a Braze

Si los datos no llegan a Braze, confirma que tu firewall permite el tráfico saliente hacia los endpoints de la API de Braze y los proveedores de CDN. Ejecuta una prueba MTR y utiliza Fastly Debug mientras el problema esté ocurriendo. Para la inclusión en la lista de permitidos y la solución de problemas de conectividad, consulta Problemas de conectividad de red de la API.