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

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

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:

Push Registered For

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

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.

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.

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

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 Campaign estiver configurada para obedecer às regras do limite de frequência, haverá um número de usuários impactados por essas configurações.

Detalhes da Campaign

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:

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.

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 abaixo das chaves de API corresponde ao que está na Braze (em Settings > App Settings > Cloud Messaging API Key).
  1. Copie a Server Key em Project credentials.
  2. Na Braze, acesse Settings > App Settings, 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

Certifique-se de 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 programar 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 estas etapas 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.

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.

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, toque em 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 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 este artigo de 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.

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.
New Stuff!