Solução de problemas

Noções básicas sobre o fluxo de trabalho Braze/APNs

O serviço de Notificações por Push da Apple (APNs) é a infraestrutura da Apple para o envio de notificações por push para aplicativos iOS e OS X. Aqui está a estrutura simplificada de como as notificações por push são ativadas para os dispositivos dos seus usuários e como o Braze pode enviar notificações por push para eles:

1. Você configura o push certificado e o perfil de provisionamento
2. Os dispositivos se registram no APNs e fornecem à Braze os tokens de push
3. Você lança uma campanha de push da Braze
4. Braze remove tokens inválidos

Etapa 1: Configuração de certificado de push e perfil de provisionamento

Ao desenvolver seu app, você precisará criar um certificado SSL para ativar notificações por push. Este certificado será incluído no perfil de provisionamento com o qual seu app foi criado e também precisará ser feito upload no dashboard da Braze. O certificado permite que a Braze informe ao APNs que estamos autorizados a enviar notificações por push em seu nome.

Há dois tipos de perfis de provisionamento e certificados: desenvolvimento e distribuição. Recomendamos apenas usar perfis de distribuição e certificados para evitar qualquer confusão. Se você optar por usar perfis e certificados diferentes para desenvolvimento e distribuição, certifique-se de que o certificado enviado para o dashboard corresponda ao perfil de provisionamento que você está usando no momento.

Etapa 2: Os dispositivos se registram no APNs e fornecem à Braze os tokens de push

Quando os usuários abrirem seu app, eles serão solicitados a aceitar notificações por push. Se aceitarem este prompt, o serviço APNs gerará um token por push para aquele dispositivo específico. O SDK do iOS enviará imediatamente e de forma assíncrona o token por push para os apps que usam a política de descarga automática padrão. Depois que tivermos um token por push associado a um usuário, ele aparecerá como “Push Registrado” no dashboard em seu perfil de usuário na guia engajamento e será elegível para receber notificações por push das campanhas da Braze.

Etapa 3: Lançamento de uma campanha de push da Braze

Quando uma campanha de mensagens push for lançada, a Braze fará solicitações ao APNs para entregar sua mensagem. Braze usará o certificado push SSL carregado no dashboard para autenticar e verificar que temos permissão para enviar notificações por push para os tokens push fornecidos. Se um dispositivo estiver online, a notificação deverá ser recebida logo após o envio da campanha. Note que a Braze define a data de expiração padrão do APNs para notificações como 30 dias.

Etapa 4: Remoção de tokens inválidos

Se os APNs nos informarem que qualquer um dos tokens por push para os quais estávamos tentando enviar uma mensagem é inválido, removeremos esses tokens dos perfis de usuário aos quais eles estavam associados.

Utilização dos registros de erros do push

Braze fornece um registro de erros de notificação por push dentro do Registro de Atividade de Mensagens. Este registro de erro fornece uma variedade de avisos que podem ser muito úteis para identificar por que suas campanhas não estão funcionando como esperado. Ao clicar em uma mensagem de erro, o sistema redirecionará você para a documentação relevante que ajudará a solucionar um incidente específico.

Os erros comuns que podem ser vistos aqui incluem notificações específicas do usuário, como “Received Unregistered Sending to Push Token”.

Além disso, a Braze também apresenta um changelog de push no perfil do usuário na guia Engajamento. Esse changelog contém insights sobre o comportamento de registro de push, como invalidação de token, erros de registro de push, tokens transferidos para novos usuários, etc.

Problemas de registro de push

Para adicionar verificação à lógica de registro push do seu aplicativo, implemente testes unitários de push.

Nenhum prompt de registro de push

Se o aplicativo não solicitar que você se registre para notificações por push, provavelmente há um problema com a integração do seu registro de push. Certifique-se de ter seguido nossa documentação e integrado corretamente nosso registro push. Você também pode definir pontos de interrupção em seu código para garantir que o código de registro de push esteja em execução.

Nenhum usuário “push registrado” exibido no dashboard

• Verifique se o seu app está solicitando permissão para notificações por push. Normalmente, este prompt aparecerá na primeira vez que você abrir o app, mas pode ser programado para aparecer em outro momento. Se não aparecer onde deveria, o problema provavelmente está na configuração básica das capacidades de push do seu app.
  • Verifique se as etapas da integração push foram concluídas com êxito.
  • Verifique se o perfil de provisionamento com o qual seu app foi criado inclui permissões para push. Certifique-se de que está baixando todos os perfis de provisionamento disponíveis da sua conta de desenvolvedor Apple. Para confirmar isso, faça o seguinte:
    1. No Xcode, acesse Preferences > Accounts (Preferências > Contas) (ou use o atalho de teclado Command+,).
    2. Selecione o ID Apple que você usa para sua conta de desenvolvedor e clique em View Details (Ver Detalhes).
    3. Na próxima página, clique em Atualizar e confirme que você está puxando todos os perfis de provisionamento disponíveis.
• Verifique se você ativou corretamente a capacitação push em seu app.
• Verifique se o seu perfil de provisionamento push corresponde ao ambiente em que você está testando. Os certificados universais podem ser configurados no dashboard do Braze para enviar para o ambiente APNs de desenvolvimento ou produção. Usar um certificado de desenvolvimento para um app de produção ou um certificado de produção para um app de desenvolvimento não funcionará.
• Verifique se você está chamando nosso método registerPushToken com a definição de um ponto de interrupção no código.
• Verifique se você está em um dispositivo (push não funcionará em um simulador) e se tem uma boa conectividade de rede.

Dispositivos não estão recebendo notificações por push

Usuários não estão mais “registrados para push” após o envio de uma notificação por push

Provavelmente indica que o usuário tinha um token por push inválido. Isso pode acontecer por várias razões:

A incompatibilidade do certificado do dashboard e do app

Se o certificado de push que você carregou no dashboard não for o mesmo no perfil de provisionamento com o qual seu app foi desenvolvido, o APNs rejeitará o token. Verifique se você carregou o certificado correto e completou outra sessão no app antes de tentar outra notificação de teste.

Desinstalações

Se um usuário desinstalou seu aplicativo, seu token por push será inválido e removido na próxima vez que for enviado.

Regenerando seu perfil de provisionamento

Como último recurso, começar do zero e criar um novo perfil de provisionamento pode resolver erros de configuração que surgem ao trabalhar com vários ambientes, perfis e aplicativos ao mesmo tempo. Existem muitos fatores na configuração de notificações por push para apps para iOS, então, às vezes, é melhor tentar novamente desde o início. Isso também ajudará a isolar o problema se você precisar continuar solucionando problemas.

Usuários ainda estão “registrados para push” após o envio de uma notificação por push

app está em primeiro plano

Nas versões do iOS que não integram push via pelo framework UserNotifications, se o app estiver em primeiro plano quando a mensagem push for recebida, ela não será exibida. Você deve colocar o app em segundo plano nos seus dispositivos de teste antes de enviar mensagens de teste.

Notificação de teste agendada incorretamente

Verifique a programação que você definiu para sua mensagem de teste. Se estiver definido para fuso local ou Intelligent Timing, você pode simplesmente não ter recebido a mensagem ainda (ou ter o app em primeiro plano quando foi recebida).

Usuário não “registrado para push” para o app que está sendo testado

Verifique o perfil do usuário para o qual você está tentando enviar uma mensagem de teste. Na guia Engajamento, deve haver uma lista de “apps que aceitam push”. Verifique se o app para o qual você está tentando enviar mensagens de teste está nesta lista. Os usuários aparecerão como “registrados para push” se tiverem um token por push para qualquer app no seu espaço de trabalho, então isso pode ser algo como um falso positivo.

O seguinte indicaria um problema com o registro de push ou que o token do usuário foi retornado ao Braze como inválido pelo APNs após ser pushado:

Erros de registro de atividade de mensagens

Recebido envio não registrado para token por push

• Certifique-se de que o token por push enviado para a Braze a partir do método [[Appboy sharedInstance] registerPushToken:] seja válido. Consulte o Registro de atividades de envio de mensagem para ver o token por push. Deve parecer algo como 6e407a9be8d07f0cdeb9e724733a89445f57a89ec890d63867c482a483506fa6, uma longa string contendo uma mistura de letras e números. Se seu token por push parecer diferente, verifique seu código para enviar os tokens por push ao Braze.
• Verifique se o seu perfil de provisionamento push corresponde ao ambiente que está testando. Os certificados universais podem ser configurados no dashboard do Braze para enviar para o ambiente APNs de desenvolvimento ou produção. Usar um certificado de desenvolvimento para um app de produção ou um certificado de produção para um app de desenvolvimento não funcionará.
• Verifique se o token por push que você enviou para a Braze corresponde ao perfil de provisionamento que você usou para desenvolver o app de onde você enviou o token por push.

Token de dispositivo não para tópico

Este erro indica que o certificado de push do seu app e o ID do pacote não correspondem. Verifique se o certificado por push que você enviou para a Braze corresponde ao perfil de provisionamento usado para construir o app do qual o token por push foi enviado.

Envio de BadDeviceToken para token por push

O BadDeviceToken é um código de erro do APNs e não se origina da Braze. Pode haver várias razões para essa resposta ser retornada, incluindo as seguintes:

• O app recebeu um token por push que era inválido para as credenciais carregadas no dashboard.
• Push foi desativado para este espaço de trabalho.
• O usuário recusou o push.
• O app foi desinstalado.
• A Apple atualizou o token por push, o que invalidou o token antigo.
• O app foi construído para um ambiente de produção, mas as credenciais de push carregadas no Braze estão configuradas para um ambiente de desenvolvimento (ou vice-versa).

Problemas após a entrega do push

Para adicionar verificação ao tratamento de push de seu aplicativo, implemente testes unitários de push.

Cliques de push não registrados

• Se isso estiver ocorrendo apenas no iOS 10, certifique-se de ter seguido as etapas de integração push para o iOS 10.
• A Braze não gerencia notificações por push recebidas silenciosamente em primeiro plano (por exemplo, comportamento padrão de push em primeiro plano antes do framework UserNotifications). Isso significa que os links não serão abertos e os cliques de push não serão registrados. Se seu app ainda não estiver integrado com o framework UserNotifications, a Braze não gerenciará as notificações por push quando o estado do app for UIApplicationStateActive. Certifique-se de que o seu app não postergue as chamadas para os nossos métodos de tratamento de push; caso contrário, o SDK do iOS poderá tratar as notificações por push como eventos push silenciosos em primeiro plano e não as entregará.

Links da web não abrem com cliques em push

O iOS 9 e posteriores exigem que os links estejam em conformidade com o ATS para serem abertos em visualizações da web. Certifique-se de que seus links da web usem HTTPS. Consulte nosso artigo sobre conformidade com ATS para obter mais informações.

Links profundos de cliques push não abrem

A maior parte do código que lida com deep links também lida com aberturas de push. Primeiro, confira se as aberturas do push estão sendo registradas. Caso contrário, corrija esse problema (já que a correção geralmente corrige o tratamento de links).

Se as aberturas estiverem sendo registradas, verifique se é um problema com o deep link em geral ou com o manuseio do clique do push de deep linking. Para fazer isso, teste para ver se um deep link de um clique de mensagem no app funciona.