Solução de problemas de push

Use esta página para solucionar problemas com o canal de envio de mensagens push.

Notificações por push ausentes

Está enfrentando dificuldades na entrega de notificações por push? Há várias etapas que você pode seguir para solucionar esse problema, verificando:

• Status da inscrição para push
• Segment
• Limites de notificações por push
• Limites de taxa
• Status do grupo de controle
• Token por push válido
• Tipo de notificação por push
• App atual

Status da inscrição para push

Pushes só podem ser enviados para usuários inscritos ou que optaram por receber. Verifique o perfil do usuário na guia Engajamento na seção Perfil de usuário para confirmar se você está ativamente registrado para push no espaço de trabalho que está testando. Se você estiver registrado em vários apps, eles serão listados no campo Push Registered For:

Você também pode exportar os perfis de usuário usando os endpoints de exportação da Braze:

• Usuários por identificador
• Usuários por segmento

Ambos os endpoints retornarão um objeto de token por push que inclui informações de ativação de push por dispositivo.

Segment

Certifique-se de que você faz parte do segmento que está sendo direcionado (se for uma campanha ativa e não um teste). No Perfil de usuário, você verá uma lista de segmentos nos quais o usuário está atualmente incluído. Lembre-se de que essa é uma variável em constante mudança, pois a segmentação é atualizada em tempo real.

Você também pode confirmar que o usuário faz parte do segmento usando a Pesquisa de usuário ao criar um segmento.

Limites de notificações por push

Verifique os limites de frequência globais. É possível que você não tenha recebido a notificação por push porque seu espaço de trabalho tem um limite de frequência global ativo e você já atingiu o limite de notificações por push para o período especificado.

Você pode fazer isso verificando o limite de frequência global no dashboard. Se a campanha estiver configurada para obedecer às regras do limite de frequência, haverá um número de usuários impactados por essas configurações.

Limites de taxa

Se você tiver um limite de taxa definido para sua Campaign ou Canvas, pode estar deixando de receber mensagens por ter excedido esse limite. Para saber mais, consulte Limite de taxa.

Status do grupo de controle

Se for uma Campaign de canal único ou um Canvas com grupo de controle, é possível que você esteja no grupo de controle.

1. Verifique a distribuição de variantes para ver se há um grupo de controle.
2. Se houver, crie um segmento filtrando por no grupo de controle da Campaign e depois exporte o segmento e verifique se o ID do seu usuário está nessa lista.

Token por push válido

Um token por push é um identificador que os remetentes usam para direcionar dispositivos específicos com uma notificação por push. Portanto, se o dispositivo não tiver um token por push válido, não há como enviar uma notificação por push para ele.

Tipo de notificação por push

Verifique se você está usando o tipo correto de notificação por push. Por exemplo, se quiser direcionar uma FireTV, você usaria uma notificação por push Kindle, não uma Campaign de push para Android. Da mesma forma, se quiser direcionar um Android, use uma notificação por push para Android e não uma Campaign de push para iOS. Confira os artigos a seguir para mais informações sobre como entender o fluxo de trabalho da Braze para:

• Apple Push Notification
• Firebase Cloud Messaging

App atual

Ao testar envios de push com usuários internos, certifique-se de que o usuário que você deseja que receba a notificação por push esteja atualmente logado no app relevante. Isso pode fazer com que o usuário não receba um push ou receba um push para o qual você acredita que ele não está segmentado.

Clicar em uma notificação por push não abre o app

Se clicar em uma notificação por push não abrir seu app, verifique o seguinte com base na sua plataforma.

Android

1. Verifique o comportamento ao clicar: confirme que a Campaign está configurada para abrir o app quando clicada.
2. Verifique o tratamento de deep links: no seu arquivo braze.xml, verifique se com_braze_handle_push_deep_links_automatically está definido como true ou false.
   • Se definido como true, o SDK da Braze trata os deep links diretamente e o app deve abrir conforme esperado.
   • Se definido como false, seu app precisa de um broadcast receiver para escutar e tratar os intents de push recebidos e abertos. Verifique se esse receiver está implementado corretamente.
3. Colete logs detalhados: ative o registro detalhado, reproduza o problema e forneça os logs junto com seus arquivos braze.xml e AndroidManifest.xml ao suporte da Braze.

iOS

1. Verifique o comportamento ao clicar: confirme que a Campaign está configurada para abrir o app quando clicada.
2. Verifique a integração de push: o deep linking a partir de um push para o app é tratado automaticamente pela integração padrão de push da Braze. Confirme que a integração está implementada corretamente, incluindo qualquer tratamento de delegate personalizado.
3. Colete logs detalhados: ative o registro detalhado, reproduza o problema e forneça os logs ao suporte da Braze.

Cliques em push abrem inesperadamente no app

Se você está enfrentando problemas com links em notificações por push que abrem inesperadamente no seu app em vez do navegador web, pode haver um problema com a configuração da sua Campaign ou com a implementação do SDK. Consulte estas etapas para obter ajuda.

Verifique o comportamento ao clicar

Na sua Campaign ou etapa do Canvas, verifique novamente se Abrir URL da web dentro do app móvel não está selecionado. Se estiver, desmarque a seleção e relance.

A interação padrão para o comportamento ao clicar “Abrir URL da web” difere por versão do SDK. Para as versões do SDK iOS 2.29.0 e Android 2.0.0 e superiores, essa opção é selecionada por padrão e as URLs da web serão abertas em uma web view dentro do app. Antes dessas versões, essa opção é desmarcada por padrão e as URLs da web abrem no navegador web padrão do dispositivo.

Se esse não for o problema, pode haver um problema com sua implementação de push.

Verifique novamente a integração de push

Se os links nas suas notificações por push estão abrindo no app inesperadamente, isso pode ser devido a problemas com a integração ou configurações de personalização das notificações por push. Siga estas etapas para solucionar:

1. Revise a implementação do delegate de push: certifique-se de que o delegate de push da Braze está implementado corretamente. Para instruções detalhadas, consulte o guia de integração de notificações por push para sua plataforma.
2. Inspecione o tratamento personalizado de links: verifique se o app inclui tratamento personalizado para todos os links https://. Configurações personalizadas podem sobrescrever comportamentos padrão. Colabore com sua equipe de desenvolvimento para revisar e ajustar essas configurações, se necessário.
3. Verifique o registro de push no iOS: para iOS, revise a etapa 1 do guia de integração de push sobre registrar notificações por push com APNs. Certifique-se de que seu objeto delegate é atribuído de forma síncrona antes que o app termine de iniciar. Essa etapa deve ser concluída no método application:didFinishLaunchingWithOptions:.
4. Teste sua integração: após fazer os ajustes, teste o comportamento das notificações por push em dispositivos iOS e Android para confirmar que o problema foi resolvido.

Migrar para uma chave de autenticação .p8

As chaves de autenticação .p8 da Apple são a abordagem obrigatória para push via APNs na Braze. Diferentemente dos tipos de arquivo de certificado legados, as chaves .p8 não expiram e suportam todos os seus apps com uma única chave, eliminando a necessidade de renovações anuais de certificados e reduzindo o risco de falhas na entrega de push.

Se você está usando atualmente um certificado .p12 ou .pem, migre para uma chave .p8 o mais rápido possível. Para instruções sobre como criar e fazer upload de uma chave .p8, consulte Fazer upload do seu certificado de push APNs. Para orientações da Apple sobre como gerar uma chave .p8 a partir da sua conta de desenvolvedor, consulte Comunicar-se com APNs usando tokens de autenticação.

Notificações por push para a web não estão funcionando como esperado

Se você está enfrentando problemas com notificações por push no seu navegador, pode ser necessário redefinir as permissões de notificação do site e limpar o armazenamento do site. Consulte estas etapas para obter ajuda.

• chrome
• firefox
• safari

Mensagens de erro de push

Para informações detalhadas sobre mensagens de erro comuns de push (como DEVICE_UNREGISTERED, Unregistered, NotRegistered e outras), consulte Mensagens de erro comuns de push.

Ainda precisa de ajuda? Abra um ticket de suporte.