Skip to content

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

Se as notificações por push não estão chegando como esperado, verifique os seguintes itens:

Status da inscrição para push

Pushes só podem ser enviados para usuários inscritos ou que optaram por receber. No Perfil de usuário, abra a guia Engajamento e confirme que 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 em Push Registered For:

Push Registered For

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

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

Segment

Confirme 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ê pode ver em quais segmentos o usuário está atualmente incluído. A associação ao segmento é atualizada em tempo real.

Lista de Segments

Você também pode confirmar que o usuário faz parte do segmento usando a Pesquisa de usuário ao criar um segmento. A Pesquisa de usuário aceita apenas external_id ou braze_id — não endereços de e-mail ou números de telefone. Para pesquisar por e-mail, telefone, token por push ou alias de usuário, consulte Pesquisar usuários.

Seção de pesquisa de usuário com um campo de busca.

Limites de notificações por push

Se o seu espaço de trabalho usa limite de frequência global, é possível que você já tenha atingido o limite para o período e não receba o push. No dashboard, consulte o limite de frequência global e seus limites. Se a Campaign seguir as regras de limite de frequência, os detalhes da Campaign mostrarão quantos usuários foram afetados.

Detalhes da Campaign

Limites de frequência

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

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 um dispositivo específico com uma notificação por push. Sem um token por push válido, a Braze não consegue enviar um push para esse dispositivo.

A Braze armazena até 20 dispositivos por perfil de usuário. Quando um 21º dispositivo é registrado, o dispositivo mais antigo é removido (primeiro a entrar, primeiro a sair, ou FIFO). Chamar changeUser() no SDK registra novamente o dispositivo atual no perfil.

Tipo de notificação por push

Use o tipo de push que corresponde ao dispositivo ou plataforma que você está direcionando. Por exemplo, use uma notificação por push Kindle para Fire TV, não uma Campaign de push para Android. Para dispositivos Android, use uma notificação por push para Android em vez de uma Campaign de push para iOS.

Para fluxos de trabalho de solução de problemas específicos por plataforma, consulte:

App atual

Ao testar push com usuários internos, confirme que o destinatário pretendido está logado no app correto. Caso contrário, ele pode não receber o push ou pode receber um que você não esperava com base na segmentação.

Erro: MismatchSenderID

MismatchSenderID indica uma falha de autenticação com o Firebase Cloud Messaging (FCM). Confirme se o ID do remetente do Firebase e a chave de API do FCM estão corretos.

Para encontrar a chave correta do servidor Firebase e substituí-la:

  1. Acesse o console do Firebase para o seu app.
  2. Em Project Overview, selecione Project Settings.
  3. Na guia Cloud Messaging, verifique se o Sender ID nas chaves de API corresponde ao que está na Braze (em Configurações > Configurações do app > Cloud Messaging API Key).
  1. Copie a Server Key em Project credentials.
  2. Na Braze, acesse Configurações > Configurações do app, selecione seu app e cole a chave do servidor no campo Cloud Messaging API Key (substituindo a chave desatualizada).
  3. Selecione Save.
  4. Para verificar, envie um push de teste para um dispositivo antes e depois de alterar a chave de API sem abrir o aplicativo. Isso ajuda a confirmar que os usuários continuam recebendo notificações por push sem a necessidade de gerar um novo ID de registro de push (token por push).

Cenários de solução de problemas

Notificações por push atrasadas

Suas notificações por push podem atrasar por estes motivos:

  • Conexão de dados fraca no dispositivo
  • Código personalizado no app que pode suprimir notificações por push da Braze
  • Preferências do usuário para notificações por push nas configurações do dispositivo
  • Prioridade da mensagem do push quando criada na Campaign ou Canvas
  • Atrasos de tráfego ou problemas com os provedores de notificação por push (FCM e APNs)

Notificações por push estão sendo enviadas mais lentamente do que o esperado

Confirme que a configuração das suas notificações por push segue estas práticas recomendadas:

  • Se você está enviando para grandes públicos sem considerar o status de ativação de push, isso pode levar a uma velocidade de envio mais lenta. Em vez disso, considere enviar apenas para usuários com push ativado para reduzir o tamanho do seu público.
  • Se possível, tente agendar suas Campaigns com antecedência em vez de imediatamente.
  • Se você está direcionando um número maior de usuários com notificações por push em um Canvas, pode esperar que as etapas de mensagem subsequentes no Canvas exijam tempos de processamento diferentes de uma Campaign que envia para os usuários imediatamente. Nesse caso, as Campaigns normalmente terminam o envio antes de um Canvas, pois a primeira “etapa” de um Canvas é verificar se os usuários se qualificam para a jornada específica do usuário.

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 as etapas a seguir para obter ajuda.

Verifique o comportamento ao clicar

Na sua Campaign ou etapa do Canvas, verifique novamente se Open web URL inside mobile app não está selecionado. Se estiver, desmarque a seleção e relance.

Campo "Comportamento ao clicar" da configuração de um push definido como "Open web URL" com "Open web URL inside mobile app" desmarcado.

A interação padrão para o comportamento ao clicar “Open web URL” 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.

Se os deep links funcionam quando o app não está em execução ou quando o link é usado diretamente, mas não quando o aplicativo já está em execução em segundo plano, o problema pode estar relacionado à forma como o app trata o link. Verifique se você está usando alguma biblioteca de terceiros que utiliza method swizzling. Recomendamos desativar o swizzling, pois ele pode causar problemas com implementações de deep link.

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 Communicate with APNs using authentication tokens.

Chaves .p8 versus certificados .p12

Use a tabela a seguir para comparar tipos de credenciais, expiração e como cada um aparece no dashboard.

Credencial Expiração Indicador de status no dashboard
Chave de autenticação .p8 Não expira Sem indicador verde de status (isso é esperado)
Certificado de push .p12 Expira anualmente Indicador verde quando o certificado é válido

Quando você substitui um certificado .p12 por uma chave .p8 (ou faz upload de uma nova credencial), a entrega de push pode pausar brevemente enquanto a Braze processa a alteração. Planeje atualizações durante uma janela de manutenção, quando possível.

Em Configurações > Configurações do app > Configurações das notificações por push, confirme que App Bundle ID, Team ID e Key ID (para chaves .p8) correspondem aos valores na sua conta de desenvolvedor da Apple. Vários espaços de trabalho da Braze podem usar a mesma credencial de push da Apple quando o bundle ID do app iOS é idêntico; o ambiente da credencial (desenvolvimento versus produção) deve corresponder à forma como o app foi compilado.

Apps com Braze Swift SDK 10.0.0 ou posterior podem usar o gerenciamento dinâmico de gateway APNs, que roteia tokens para o ambiente APNs correto automaticamente.

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 as etapas a seguir para obter ajuda.

Redefinir o Chrome no desktop

  1. Ao lado da URL no navegador Chrome, selecione o ícone de controle deslizante View Site Information.
  2. Em Notifications, selecione Reset permission.
  3. Abra o Chrome DevTools. A seguir estão os atalhos relevantes por sistema operacional.
SO Atalhos de teclado
Mac Fn + F12
Ctrl + Shift + I
Windows F12
Ctrl + Shift + I
  1. No DevTools, navegue até a guia Application.
  2. Na barra lateral, selecione Storage.
  3. Selecione Clear site data.
  4. O Chrome solicitará que você recarregue a página para aplicar as configurações atualizadas. Selecione Reload.

Suas permissões de push foram redefinidas. Abra uma nova guia para o seu site e teste.

Redefinir o Chrome no Android

Se você tem uma notificação do seu site visível na gaveta de notificações do Android:

  1. Na notificação por push, selecione Configurações e selecione Site settings.
  2. Em Site settings, toque em Clear & Reset.

Se você não tem uma notificação do seu site aberta:

  1. Abra o Chrome no Android.
  2. Toque no menu .
  3. Acesse Settings > Site Settings > Notifications.
  4. Verifique se as notificações estão definidas como Ask before sending (recommended).
  5. Encontre seu site na lista.
  6. Selecione a entrada e toque em Clear and Reset.

Suas permissões de push foram redefinidas. Abra uma nova guia para o seu site e teste.

Redefinir o Firefox no desktop

  1. Ao lado da URL do seu site, selecione ou .
  2. Em Permissions, ao lado de Receive Notifications, selecione Clear permission para limpar as permissões de notificação.
  3. No mesmo menu, selecione Clear Cookies and Site Data.
  4. Na caixa de diálogo para confirmar sua escolha, selecione OK.

Suas permissões de push foram redefinidas. Abra uma nova guia para o seu site e teste.

Redefinir o Firefox no Android

Para redefinir as permissões de push no Android, consulte Limpar seu histórico de navegação e outros dados pessoais no suporte da Mozilla.

Redefinir o Safari no macOS

  1. Abra o Safari.
  2. Na barra de menus do Mac, acesse Safari > Settings > Websites > Notifications.
  3. Selecione seu site na lista.
  4. Selecione Remove para excluir as permissões de notificação do site.
  5. Em seguida, acesse Privacy > Manage Website Data.
  6. Selecione seu site na lista.
  7. Selecione Remove ou, para remover todos os dados do site, selecione Remove All.
  8. Selecione Done.

Suas permissões de push foram redefinidas. Abra uma nova guia para o seu site e teste.

Métricas de abertura de push

A Braze registra uma abertura direta quando um usuário toca na notificação e seu app inicia uma sessão. Expandir uma notificação por push rich sem abrir o app não registra uma abertura direta.

Se um usuário abrir seu app após receber um push sem tocar na notificação, a Braze pode registrar uma Abertura por Influência. Para definições e relatórios, consulte Aberturas por Influência.

Mensagens de erro de push

Para definições de códigos de erro comuns de push (incluindo DEVICE_UNREGISTERED, NotRegistered e Unregistered), consulte Mensagens de erro comuns de push.

Quando o FCM retorna erros como DEVICE_UNREGISTERED ou NotRegistered, a Braze normalmente remove o token por push afetado do perfil do usuário. Essa remoção geralmente indica que o app foi desinstalado ou que o token não é mais válido. As campanhas de Uninstall Tracking usam a mesma lógica de remoção de token em escala.

Ainda precisa de ajuda? Abra um ticket de suporte.
New Stuff!