Solução de problemas
Precisa de ajuda para resolver mensagens no aplicativo para o SDK Braze? Comece aqui!
Verificações básicas
Minha mensagem no app não foi exibida para um usuário
- O usuário estava no segmento no início da sessão, quando o SDK solicita novas mensagens no app?
- O usuário era elegível ou reelegível para receber a mensagem no app de acordo com as regras de direcionamento da campanha?
- O usuário foi afetado por um limite de frequência?
- O usuário estava em um grupo de controle? Verifique se sua campanha está configurada para testes AB.
- Uma mensagem no app diferente e de prioridade mais alta foi exibida no lugar da mensagem esperada?
- Meu dispositivo estava na orientação correta especificada pela campanha?
- Minha mensagem foi suprimida pelo intervalo de tempo mínimo padrão de 30 segundos entre disparos, imposto pelo SDK?
Minha mensagem no app não foi exibida para todos os usuários nesta plataforma
- Sua campanha está configurada para direcionamento a aplicativos móveis ou navegadores da Web, conforme apropriado? Por exemplo, se sua campanha tiver como alvo apenas navegadores da Web, ela não será enviada para dispositivos Android.
- Você implementou uma interface de usuário personalizada e ela está funcionando como pretendido? Há outra manipulação ou supressão personalizada no lado do app que possa estar interferindo na exibição?
- Essa plataforma específica e essa versão do app já exibiram mensagens no app com êxito?
- O disparo ocorreu localmente no dispositivo? Note que uma chamada REST não pode ser usada para disparar uma mensagem no app no SDK.
Minha mensagem no app não foi exibida para todos os usuários
- A ação-gatilho foi configurada corretamente no dashboard, bem como na integração do app?
- Uma mensagem no app diferente e de prioridade mais alta foi exibida no lugar da mensagem esperada?
- Você está usando uma versão recente do SDK? Alguns tipos de mensagens no app têm requisitos de versão do SDK.
- As sessões foram integradas corretamente em sua integração? A análise de dados da sessão está funcionando para esse app?
Minha mensagem no app demorou muito tempo para aparecer
- Se estiver servindo arquivos grandes de imagem ou vídeo da CDN para uma mensagem no app baseada em HTML, verifique se os arquivos estão otimizados para serem os menores possíveis e se a CDN tem bom desempenho.
-
Verifique se você configurou um
delay
para sua mensagem no app no dashboard. - Dependendo das circunstâncias, as mensagens no app baixarão ou carregarão imagens relevantes do disco antes de serem exibidas. Se estiver em uma conexão de rede lenta ou em dispositivos de performance muito baixa, esse processo poderá demorar. Certifique-se de que suas imagens sejam otimizadas para serem tão pequenas quanto possível.
Para uma discussão mais aprofundada sobre esses cenários, visite a seção de solução de problemas avançada.
Problemas com impressões e análise de dados de cliques
As impressões e os cliques não estão sendo registrados
Se você tiver definido um delegado de mensagem no app para lidar manualmente com a exibição da mensagem ou com ações de clique, deverá registrar manualmente os cliques e as impressões na mensagem no app.
As impressões são menores do que o esperado
-
Os disparos levam tempo para serem sincronizados com o dispositivo no início da sessão, portanto, pode haver uma condição de corrida se os usuários registrarem um evento ou uma compra logo após iniciarem uma sessão. Uma possível solução alternativa poderia ser alterar a campanha para disparar a partir do início da sessão e, em seguida, segmentar o evento ou a compra pretendida. Note que isso entregaria a mensagem no app no próximo início de sessão após a ocorrência do evento.
-
Se a campanha for disparada por um início de sessão ou por um evento personalizado, é preciso garantir que esse evento ou sessão esteja ocorrendo com frequência suficiente para disparar a mensagem. Verifique esses dados nas páginas Overview (Visão geral ) (para dados de sessão) ou Custom Events (Eventos personalizados ):
As impressões são mais baixas do que costumavam ser
- Certifique-se de que ninguém alterou involuntariamente o segmento ou a campanha desde o lançamento. Nossos changelogs de segmento e campanha lhe darão insights sobre as alterações feitas, quem fez a alteração e quando ela ocorreu.
- Certifique-se de não reutilizar seu evento de gatilho em uma campanha de mensagens no app separada com uma prioridade mais alta.
Solução de problemas avançada
A maioria dos problemas com mensagens no app pode ser dividida em duas categorias principais: entrega e exibição. Para solucionar o motivo pelo qual uma mensagem no app esperada não foi exibida em seu dispositivo, confirme se a mensagem no app foi entregue ao dispositivo e, em seguida, solucione o problema da exibição da mensagem.
Solução de problemas de entrega
O SDK solicita mensagens no app dos servidores da Braze no início da sessão. Para verificar se as mensagens no app estão sendo entregues ao seu dispositivo, você precisará ter certeza de que as mensagens no app estão sendo solicitadas pelo SDK e retornadas pelos servidores Braze.
Verificar se as mensagens são solicitadas e retornadas
- Adicione-se como um usuário teste no dashboard.
- Configure uma campanha de mensagens no app direcionada ao seu usuário.
- Confira se uma nova sessão está ocorrendo em seu aplicativo.
- Use o registro de usuários de eventos para verificar se o dispositivo está solicitando mensagens no app no início da sessão. Encontre a solicitação do SDK associada ao evento de início de sessão do usuário teste.
- Se o seu app foi projetado para solicitar mensagens no app disparadas, você deverá ver
trigger
no campo Respostas solicitadas em Dados de resposta. - Se o seu app foi projetado para solicitar mensagens originais no app, você deverá ver
in_app
no campo Respostas solicitadas em Dados de resposta.
- Se o seu app foi projetado para solicitar mensagens no app disparadas, você deverá ver
- Use os registros de usuários de eventos](/docs/pt-br/user_guide/administrative/app_settings/developer_console/event_user_log_tab/#event-user-log-tab) para verificar se as mensagens no app corretas estão sendo retornadas nos dados de resposta.
Solução de problemas de mensagens que não estão sendo solicitadas
Se suas mensagens no app não estiverem sendo solicitadas, seu app pode não estar rastreando as sessões corretamente, pois as mensagens no app são atualizadas no início da sessão. Além disso, certifique-se de que o seu app esteja realmente iniciando uma sessão com base na semântica de tempo limite da sessão do seu app:
Solução de problemas de mensagens que não estão sendo retornadas
Se suas mensagens no app não estiverem sendo retornadas, é provável que haja um problema de direcionamento de campanha:
- Seu segmento não contém seu usuário.
- Verifique a guia [**Engagement](/docs/pt-br/user_guide/engagement_tools/segments/using_user_search/#engagement-tab) do seu usuário para ver se o segmento correto aparece em **Segments (Segmentos).
- Seu usuário já recebeu anteriormente a mensagem no app e não era elegível para recebê-la novamente.
- Verifique as configurações de reelegibilidade da campanha na etapa Delivery (Entrega) do criador da campanha e certifique-se de que as configurações de reelegibilidade estejam alinhadas com sua configuração de teste.
- Seu usuário atingiu o limite de frequência da campanha.
- Verifique as configurações de limite de frequência da campanha](/docs/pt-br/user_guide/engagement_tools/campaigns/building_campaigns/rate-limiting/#frequency-capping) e certifique-se de que estejam alinhadas com sua configuração de teste.
- Se havia um grupo de controle na campanha, seu usuário pode ter caído no grupo de controle.
- É possível verificar se isso aconteceu criando um segmento com um filtro de variante de campanha recebida, em que a variante de campanha está definida como Controle, e verificando se o usuário se enquadra nesse segmento.
- Ao criar campanhas para fins de teste de integração, é importante não aceitar a adição de um grupo de controle.
Exibição de solução de problemas
Se o seu app estiver solicitando e recebendo mensagens no app com êxito, mas elas não estiverem sendo exibidas, a lógica do lado do dispositivo pode estar impedindo a exibição:
-
O evento de gatilho está disparando conforme o esperado? Para testar isso, tente configurar a mensagem para disparar usando uma ação diferente (como o início da sessão) e verifique se ela é exibida.
-
As mensagens no app disparadas são limitadas de frequência com base no intervalo de tempo mínimo entre os disparos, cujo padrão é de 30 segundos.
-
A falha no download de imagens impedirá a exibição de mensagens no app com imagens. Verifique os registros do dispositivo para garantir que os downloads de imagens não estejam falhando. Tente remover sua imagem temporariamente da mensagem para ver se isso faz com que ela seja exibida.
-
Se tiver definido um delegado para personalizar o envio de mensagens no app, verifique se o delegado não está afetando a exibição de mensagens no app.
-
Se a orientação do dispositivo não corresponder à orientação especificada pela mensagem no app, a mensagem no app não será exibida. Certifique-se de que o dispositivo esteja na orientação correta.
-
Se a sua mensagem no app for disparada pelo início da sessão e você tiver definido um tempo limite de sessão estendido, isso afetará a rapidez com que você pode mostrar mensagens. Por instância do app, se o tempo limite da sessão estiver definido para 300 segundos, fechar e reabrir o aplicativo em menos tempo não atualizará a sessão, portanto, uma mensagem no app disparada por um início de sessão não será exibida.
guide/swift/in_app_messages/troubleshooting.md developer_ %}
guide/web/in_app_messages/troubleshooting.md developer_ %}