Lendo logs verbosos

Esta página explica como interpretar a saída de logs verbosos do SDK da Braze. Para cada canal de envio de mensagens, você encontrará as entradas de log principais, o que elas significam e problemas comuns a serem observados.

Antes de começar, certifique-se de que você ativou o registro verboso e sabe como coletar logs na sua plataforma.

Sessões

As sessões são a base da análise de dados e da entrega de mensagens da Braze. Muitos recursos de envio de mensagens — incluindo In-App Messages e Content Cards — dependem de uma sessão válida para funcionar. Se as sessões não estiverem sendo registradas corretamente, investigue isso primeiro. Para saber mais sobre como ativar o rastreamento de sessões, consulte Etapa 5: Ativar o rastreamento de sessão do usuário.

Nota

Comece a solução de problemas do SDK pelas sessões. Se as sessões não estiverem sendo registradas, In-App Messages, Content Cards e muitos eventos de análise de dados não funcionarão conforme esperado. Depois de confirmar as entradas de início/fim de sessão, revise as linhas de eventos personalizados na mesma captura de log. Consulte Registro detalhado para ativar o registro e coletar uma exportação compartilhável.

Entradas de log principais

• 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.

O que verificar

• Verifique se um log de início de sessão aparece quando o app é iniciado.
• Se você não vir um início de sessão, verifique se o SDK foi inicializado corretamente e se o openSession (Android) está sendo chamado.
• No Android, confirme se uma requisição de rede está sendo feita para o endpoint da Braze. Se você não vir essa requisição, verifique a configuração da sua chave de API e do endpoint.

Notificações por push

Os registros de notificações por push ajudam a verificar se os tokens de dispositivo estão registrados, se as notificações estão sendo entregues e se os eventos de clique estão sendo rastreados.

Registro de token

Quando uma sessão é iniciada, o SDK registra o token por push do dispositivo na 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>

O que verificar

• Se push_token estiver ausente do corpo da solicitação, o token não foi capturado. Verifique a configuração de push na configuração do seu app.
• Se ios_push_auth mostrar denied ou provisional, o usuário não concedeu permissão total de push.
• No Android, se você vir SENDER_ID_MISMATCH, atualize o ID do remetente FCM para corresponder ao seu projeto Firebase.

Entrega e clique de push

Quando uma notificação por push é tocada, o SDK registra os eventos de processamento e clique.

• 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

O que verificar

• Verifique se a carga útil do push contém o title, body e quaisquer deep links (ab_uri) esperados.
• Confirme que um evento pushClick é registrado após o toque.
• Se o evento de clique estiver ausente, verifique se o app delegate ou o manipulador de notificações está encaminhando corretamente os eventos de push para o SDK da Braze.

Mensagens no app

Os logs de mensagens no app mostram o ciclo de vida completo: entrega do servidor, disparo com base em eventos, exibição, registro de impressão e rastreamento de cliques.

Entrega da mensagem

Quando um usuário inicia uma sessão e é elegível para uma mensagem no app, o SDK recebe a carga útil da mensagem do 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>

Exibição e impressão da mensagem

• 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 clique e botão

Quando um usuário toca em um botão ou fecha a mensagem:

• 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.

O que verificar

• Se a mensagem no app não for exibida, verifique se um início de sessão foi registrado primeiro.
• Filtre as respostas do seu endpoint da Braze configurado para confirmar que a carga útil da mensagem foi entregue.
• Se as impressões não estiverem sendo registradas, verifique se você não implementou um delegate personalizado inAppMessageDisplay que suprime o registro.
• Se “No matching trigger for event” aparecer, isso é normal e indica que não há mensagens no app adicionais configuradas para esse evento.

Content Cards

Os logs de Content Cards ajudam você a verificar se os cartões estão sincronizados com o dispositivo, exibidos para o usuário e que as interações (impressões, cliques, dispensas) estão sendo rastreadas.

Sincronização do cartão

Os Content Cards são sincronizados no início da sessão e quando uma atualização manual é solicitada. Se nenhuma sessão for registrada, nenhum Content Card será exibido.

• 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.

Impressões, cliques e dispensas

• 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: [...])

O que verificar

• Nenhum cartão exibido: Verifique se o início da sessão está registrado. Content Cards requerem uma sessão ativa para sincronizar.
• Cartões ausentes para novos usuários: Novos usuários em sua primeira sessão podem não ver Content Cards até a próxima sessão. Esse é um comportamento esperado.
• Cartão excede o limite de tamanho: Content Cards acima de 2 KB não são exibidos e a mensagem é abortada.
• Cartão persiste após parar a Campaign: Verifique se a sincronização foi concluída após a Campaign ser parada. Os Content Cards são removidos do dispositivo após uma sincronização bem-sucedida. Ao parar uma Campaign, certifique-se de que a opção de remover cartões ativos dos feeds dos usuários esteja selecionada.

Deep links

Os logs de deep links aparecem em notificações por push, mensagens no app e Content Cards. A estrutura do log é consistente independentemente do canal de origem.

• 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>"

O que verificar

• Verifique se a URL do deep link corresponde ao que você configurou na Campaign.
• Se o deep link funciona em um canal (por exemplo, push), mas não em outro (por exemplo, Content Cards), verifique se a implementação de tratamento de deep links é compatível com todos os canais.
• No iOS, universal links exigem tratamento adicional. Se os universal links não estiverem funcionando nos canais da Braze, verifique se o seu app implementa o protocolo BrazeDelegate para o tratamento de URLs.
• No Android, verifique se o tratamento automático de deep links está desativado caso você use um handler personalizado. Caso contrário, o handler padrão pode entrar em conflito com a sua implementação.

Identificação de usuário

Quando um usuário é identificado com um external_id, o SDK registra um evento de mudança de usuário.

• android
• swift

1

changeUser called with: <EXTERNAL_ID>

1

"user_id": "<EXTERNAL_ID>"

Requisições de rede

Os logs detalhados incluem informações completas de requisições e respostas HTTP para a comunicação do SDK com os servidores da Braze. Eles são úteis para diagnosticar problemas de conectividade.

Estrutura da requisição

Filtre as requisições para o endpoint da Braze configurado (por exemplo, sdk.iad-01.braze.com). A estrutura da requisição inclui:

• 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>

O que verificar

• Chave de API: verifique se XBraze-ApiKey corresponde à chave de API do seu espaço de trabalho.
• Endpoint: confirme se a URL da requisição corresponde ao endpoint de SDK configurado.
• Tentativas de reenvio: XBraze-Req-Attempt maior que 1 indica que o SDK está reenviando uma requisição que falhou, o que pode sinalizar problemas de conectividade.
• Limite de frequência: XBraze-Req-Tokens-Remaining mostra os tokens de requisição restantes. Um número baixo pode indicar que o SDK está se aproximando dos limites de frequência.
• Requisições ausentes: no Android, se você não vir uma requisição para o endpoint da Braze após o início da sessão, verifique a configuração da chave de API e do endpoint.

Abreviações comuns de eventos

Nos payloads de log detalhados, a Braze usa nomes de eventos abreviados. Veja a referência:

Solução de problemas

Geofences não disparam no Android SDK 13.1.0–15.x

O Android SDK da Braze nas versões 13.1.0 a 15.x teve uma regressão que podia impedir o registro de eventos de atualização de geofence. Em dispositivos com Android 10 ou anterior, atualizações de local no início da sessão também podiam falhar. Faça upgrade para o Android SDK 16.0.0 ou posterior. Para configuração do SDK, consulte Geofences.

Quando um usuário pode ter 0 sessões registradas no perfil?

Um perfil de usuário pode exibir 0 sessões quando você importa o usuário pela REST API (/users/track) ou por importação de CSV sem os campos First session ou Last session. As sessões são registradas quando os usuários interagem com o seu app por meio do SDK. Para saber mais, consulte O perfil de usuário tem 0 sessões.

Discrepâncias de dados de usuários ao usar o SDK e a REST API juntos

Quando você usa o SDK e a REST API ao mesmo tempo, condições de corrida podem causar discrepâncias nos dados. Após chamar changeUser(), permita que o SDK envie os dados pendentes antes de fazer chamadas críticas à REST API, evite agrupar atualizações sensíveis ao tempo e considere adicionar um pequeno atraso entre as solicitações do SDK e da API. Para entender o comportamento de changeUser(), consulte Como o changeUser() funciona.

Dados não estão chegando à Braze

Se os dados não estão chegando à Braze, confirme se o seu firewall permite tráfego de saída para os endpoints da API da Braze e provedores de rede de distribuição de conteúdo (CDN). Execute um teste MTR e use o Fastly Debug enquanto o problema estiver ocorrendo. Para solução de problemas de conectividade e lista de permissões, consulte Problemas de conectividade de rede da API.