Aviso

AppboyKit (também conhecido como o SDK Objective-C) não é mais suportado e foi substituído pelo Swift SDK. Não receberá mais novos recursos, correções de bugs, atualizações de segurança ou suporte técnico—no entanto, o envio de mensagens e a análise de dados continuarão a funcionar normalmente. Para saber mais, veja Apresentando o Novo SDK Braze Swift.

Solução de problemas

Entendendo o fluxo de trabalho Braze/APNs

O serviço de Notificações por Push da Apple (APN) é 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 a Braze pode enviar notificações por push para eles:

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

Etapa 1: Configurando o certificado de push e o perfil de provisionamento

Ao desenvolver seu app, crie um certificado SSL para ativar notificações por push. Esse certificado é incluído no perfil de provisionamento com o qual seu app é compilado e também deve ser carregado no dashboard da Braze. O certificado permite que a Braze informe ao APN que temos autorização para enviar notificações por push em seu nome.

Existem dois tipos de perfis de provisionamento e certificados: desenvolvimento e distribuição. Recomendamos usar apenas perfis e certificados de distribuição 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 carregado no dashboard corresponda ao perfil de provisionamento que você está usando no momento.

Aviso

Não altere o ambiente do certificado de push (desenvolvimento versus produção). Alterar o certificado de push para o ambiente errado pode fazer com que seus usuários tenham seus tokens por push removidos acidentalmente, tornando-os inacessíveis via push.

Etapa 2: Dispositivos se registram no APN e fornecem tokens por push à Braze

Quando os usuários abrem seu app, eles serão solicitados a aceitar notificações por push. Se aceitarem essa solicitação, o APN gerará um token por push para aquele dispositivo específico. O SDK para iOS enviará imediata e assincronamente o token por push para apps que usam a política de envio automático padrão. Depois que tivermos um token por push associado a um usuário, ele aparecerá como “Push Registered” no dashboard, em seu perfil de usuário na guia Engajamento, e será elegível para receber notificações por push de Campaigns da Braze.

Nota

A partir do Xcode 14, você pode testar notificações por push remotas em um simulador iOS.

Etapa 3: Lançando uma Campaign de push na Braze

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

Etapa 4: Removendo tokens inválidos

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

Utilizando os logs de erro de push

A Braze fornece um log de erros de notificações por push no Message Activity Log. Esse log de erros oferece diversos alertas que podem ser muito úteis para identificar por que suas Campaigns não estão funcionando como esperado. Ao selecionar uma mensagem de erro, você é redirecionado para a documentação relevante que ajuda a solucionar um incidente específico.

Erros comuns que você pode ver aqui incluem notificações específicas do usuário, como “Received Unregistered Sending to token por push”.

Além disso, a Braze também fornece um changelog de push no perfil de usuário, na guia Engagement. Esse changelog oferece insights sobre o comportamento de registro de push, como invalidação de token, erros de registro de push, tokens sendo movidos para novos usuários, etc.

Problemas no registro de push

Para adicionar verificação à lógica de registro de 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 registro de push. Certifique-se de ter seguido nossa documentação e integrado corretamente nosso registro de push. Você também pode definir breakpoints no seu código para garantir que o código de registro de push está sendo executado.

Nenhum usuário “push registered” aparecendo no dashboard

• Verifique se o seu app está solicitando permissão para notificações por push. Normalmente, esse prompt aparece na primeira abertura do app, mas pode ser programado para aparecer em outro momento. Se ele não aparecer onde deveria, o problema provavelmente está na configuração básica dos recursos de push do seu app.
  • Verifique se as etapas de integração de push foram concluídas com sucesso.
  • Verifique se o perfil de provisionamento com o qual seu app foi compilado inclui permissões para push. Certifique-se de que você está baixando todos os perfis de provisionamento disponíveis da sua conta de desenvolvedor Apple. Para confirmar, siga estas etapas:
    1. No Xcode, navegue até Preferences > Accounts (ou use o atalho de teclado Command+,).
    2. Selecione o Apple ID que você usa para sua conta de desenvolvedor e clique em View Details.
    3. Na próxima página, clique em Refresh e confirme que você está baixando todos os perfis de provisionamento disponíveis.
• Verifique se você ativou corretamente o recurso de push no seu app.
• Verifique se o perfil de provisionamento de push corresponde ao ambiente em que você está testando. Certificados universais podem ser configurados no dashboard da Braze para enviar ao ambiente de APNs de desenvolvimento ou de 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 definindo um breakpoint no seu código.
• Verifique se você está em um dispositivo (push não funciona em um simulador) e se tem boa conectividade de rede.

Dispositivos que não recebem notificações por push

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

Isso provavelmente indica que o usuário tinha um token por push inválido. Isso pode acontecer por vários motivos:

Incompatibilidade entre o certificado do dashboard e o do app

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

Desinstalações

Se um usuário desinstalou seu aplicativo, o token por push será invalidado e removido no próximo envio.

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 apps ao mesmo tempo. Há muitas “peças móveis” na configuração de notificações por push para apps iOS, então, às vezes, é melhor tentar novamente desde o início. Isso também ajudará a isolar o problema caso você precise continuar a solução de problemas.

Usuários ainda com “push registrado” após o envio de uma notificação por push

O app está em primeiro plano

Em versões do iOS que não integram push por meio do framework UserNotifications, se o app estiver em primeiro plano quando a mensagem de 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 o cronograma que você definiu para sua mensagem de teste. Se estiver configurado para entrega no fuso local ou com Intelligent Timing, é possível que você simplesmente ainda não tenha recebido a mensagem (ou que o app estivesse em primeiro plano quando ela foi recebida).

Usuário sem “push registrado” para o app sendo testado

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

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

Notificações por push não sendo enviadas

Para solucionar problemas de notificações por push que não estão sendo enviadas, consulte Solução de problemas de push.

Erros do registro de atividade de mensagens

Recebido não registrado enviando para token de push

• Confirme se o token de push enviado à Braze pelo método [[Appboy sharedInstance] registerPushToken:] é válido. Você pode consultar o Registro de atividade de mensagens para ver o token de push. Ele deve se parecer com algo como 6e407a9be8d07f0cdeb9e724733a89445f57a89ec890d63867c482a483506fa6, uma string longa contendo uma mistura de letras e números. Se o seu token de push parecer diferente, verifique o seu código de envio dos tokens de push à Braze.
• Confirme se o perfil de provisionamento de push corresponde ao ambiente em que você está testando. Certificados universais podem ser configurados no dashboard da Braze para enviar ao ambiente de APNs de desenvolvimento ou de 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 de push que você enviou à Braze corresponde ao perfil de provisionamento usado para compilar o app de onde o token de push foi enviado.

Token de dispositivo não corresponde ao tópico

Esse erro indica que o certificado de push do seu app e o bundle ID estão incompatíveis. Verifique se o certificado de push que você enviou à Braze corresponde ao perfil de provisionamento usado para compilar o app de onde o token de push foi enviado.

BadDeviceToken ao enviar para token de push

O BadDeviceToken é um código de erro do APNs e não tem origem na Braze. Pode haver vários motivos para essa resposta ser retornada, incluindo os seguintes:

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

Problemas após a entrega de push

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

Cliques em push não registrados

• Se isso estiver ocorrendo apenas no iOS 10, verifique se você seguiu as etapas de integração de push para o iOS 10.
• A Braze não trata notificações por push recebidas silenciosamente em primeiro plano (por exemplo, o 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 em push não serão registrados. Se o seu aplicativo ainda não integrou o framework UserNotifications, a Braze não tratará as notificações por push quando o estado do aplicativo for UIApplicationStateActive. Certifique-se de que seu app não atrase as chamadas aos nossos métodos de tratamento de push; caso contrário, o SDK para iOS pode tratar as notificações por push como eventos silenciosos de push em primeiro plano e não processá-las.

Links da web a partir de cliques em push não abrem

O iOS 9+ exige que os links estejam em conformidade com o ATS para serem abertos em web views. Certifique-se de que seus links da web usam HTTPS. Consulte nosso artigo sobre conformidade com o ATS para saber mais.

Deep links a partir de cliques em push não abrem

A maior parte do código que trata deep links também trata aberturas de push. Primeiro, verifique se as aberturas de push estão sendo registradas. Se não estiverem, corrija esse problema (já que a correção geralmente também resolve o tratamento de links).

Se as aberturas estiverem sendo registradas, verifique se o problema é com o deep link em geral ou com o tratamento de cliques em push via deep linking. Para isso, teste se um deep link a partir do clique em uma mensagem no app funciona.

Poucas ou nenhuma Abertura Direta

Se pelo menos um usuário abrir sua notificação por push no iOS, mas poucas ou nenhuma Abertura Direta for registrada na Braze, pode haver um problema com a integração SDK. Lembre-se de que Aberturas Diretas não são registradas para envios de teste ou notificações por push silenciosas.

• Verifique se as mensagens não estão sendo enviadas como notificações por push silenciosas. A mensagem precisa ter texto no título ou no corpo para não ser considerada silenciosa.
• Confira novamente as seguintes etapas do guia de integração de push:
  • Registrar para push: A cada inicialização do app, preferencialmente dentro de application:didFinishLaunchingWithOptions:, o código da etapa 3 precisa ser executado. A propriedade delegate de UNUserNotificationCenter.current() precisa ser atribuída a um objeto que implemente UNUserNotificationCenterDelegate e contenha o método (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:.
  • Ativar o tratamento de push: Verifique se o método (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler: foi implementado.

Cliques em imagens de Push Stories não fazem nada

Esta seção se aplica à integração de Push Stories com o SDK Objective-C. Se você usa o módulo BrazePushStory do SDK Swift, defina UNNotificationExtensionUserInteractionEnabled como YES. Consulte Push Stories.

Se tocar em uma imagem de Push Story não abrir a ação esperada, abra o Info.plist da Notification Content Extension e confira as chaves na configuração de Push Stories:

• UNNotificationExtensionCategory = ab_cat_push_story_v2
• UNNotificationExtensionDefaultContentHidden = YES
• UNNotificationExtensionInitialContentSizeRatio = 0.65

Se UNNotificationExtensionUserInteractionEnabled estiver nesse plist, remova-o. A configuração de Push Stories para Objective-C não inclui essa chave.