Gerenciando sua base de assinantes de push

No Pushwoosh, cada assinante é identificado por um token de push, um identificador único que permite a entrega de mensagens a um dispositivo específico. Este post aborda como os tokens de push funcionam e como manter apenas tokens válidos em sua base de assinantes.

Entendendo os tokens de push e como eles funcionam

Um token de push é um identificador único e anônimo atribuído a uma instância específica de um aplicativo em um dispositivo pelo seu provedor de serviço de push:

Apple Push Notification Service (APNs) para dispositivos iOS
Firebase Cloud Messaging (FCM) para dispositivos Android

Este token garante que as notificações push sejam entregues ao aplicativo correto no dispositivo do usuário.

No Pushwoosh, o ciclo de vida do token de push inclui estas etapas principais:

Quando o aplicativo é iniciado pela primeira vez, ele solicita permissão ao sistema operacional (SO) do dispositivo para receber notificações push.
O serviço de push do aplicativo (por exemplo, APNs para iOS, FCM para Android) gera um token de push único para essa instância do aplicativo. Por padrão, o SDK do Pushwoosh coleta e armazena esse token mesmo que o usuário não tenha concedido permissões para exibir notificações. As mensagens push não serão mostradas a esses usuários, mas o token ainda pode ser usado para enviar mensagens para a caixa de entrada do aplicativo deles, outro canal de mensagens no Pushwoosh.

No entanto, você pode configurar o SDK para coletar tokens apenas de usuários que concederam permissão.
O aplicativo usa o SDK do Pushwoosh para enviar este token ao banco de dados do Pushwoosh junto com os dados do dispositivo (incluindo um ID de hardware ou HWID) para o Pushwoosh através do endpoint da API /registerDevice.
O Pushwoosh armazena o token de forma segura para futuras mensagens.
Quando uma notificação é acionada, o Pushwoosh usa o token armazenado para rotear a mensagem através do gateway de entrega apropriado.
O gateway escolhido entrega a mensagem ao dispositivo, e o SO a exibe com base nas configurações de notificação do sistema e do aplicativo.
Se o token de push se tornar inválido (por exemplo, devido à desinstalação do aplicativo), o Pushwoosh detecta a falha na entrega após outro envio de notificação, quando o gateway retorna a lista de erros de envio, incluindo tokens expirados/inválidos/etc. Então, o Pushwoosh marca o token como inativo e o exclui do banco de dados. Se o aplicativo for reinstalado no mesmo dispositivo, um novo token será emitido.

Razões comuns para os tokens de push se tornarem inválidos

Embora o Apple Push Notification Service (APNs) e o Firebase Cloud Messaging (FCM) não forneçam total transparência sobre as políticas do ciclo de vida dos tokens ou permitam a validação proativa de tokens, existem cenários conhecidos nos quais os tokens de push podem se tornar inválidos ou expirar.

Causa	APNs (iOS)	FCM (Android)
Desinstalação do aplicativo	O token se torna inválido após a desinstalação do aplicativo. O APNs eventualmente retorna um erro `410 Unregistered`. A Apple não especifica quando a invalidação ocorre; pode levar de alguns minutos a vários dias. Saiba mais	O token é invalidado imediatamente após a desinstalação. Envios subsequentes retornam um erro `Unregistered`. Saiba mais
Atualização do token	O APNs emite um novo token após atualizações do SO, backup/restauração do dispositivo, reinstalação do aplicativo ou atualizações do SO. Saiba mais	Comportamento igual ao do APNs. Também é acionado pela limpeza de dados do aplicativo ou restauração do dispositivo. Saiba mais
Inatividade do token	Não há expiração documentada por inatividade. Saiba mais	Tokens inativos por mais de 270 dias são considerados obsoletos/expirados. O FCM os marca como inválidos. Saiba mais

Como manter sua lista de assinantes limpa removendo tokens de push inválidos

Para manter sua lista de assinantes de push limpa, verifique regularmente as estatísticas de entrega, remova tokens inválidos e garanta que seu aplicativo e backend sempre tenham os dados de token mais recentes.

O Pushwoosh oferece várias maneiras de ajudá-lo a fazer isso:

Envie notificações push para toda a sua base de assinantes regularmente

Envie mensagens push para toda a sua base de assinantes regularmente. Isso ajuda o Pushwoosh a identificar tokens inválidos. Quando uma mensagem falha na entrega, geralmente devido a um token inválido, o gateway de push retorna um erro. O SDK captura essa resposta e remove o token inválido automaticamente, garantindo que ele seja excluído de envios futuros.

Importante: A validade do token só é verificada quando um push é enviado. O Pushwoosh não realiza verificações em segundo plano sobre a validade do token.

Cancele o registro de dispositivos usando a API

Você pode usar o método da API de Dispositivo /bulkUnregisterDevice para remover tokens de push da sua base de assinantes, por exemplo, quando os usuários optam por não receber ou não estão mais ativos.

Para fazer isso:

Crie um segmento de usuários que corresponda aos seus critérios (por exemplo, usuários que optaram por não receber, usuários do plano gratuito ou aqueles inativos por X dias).
Exporte o segmento usando o Painel de Controle ou o método da API exportSegment.
Chame /bulkUnregisterDevice para excluir os tokens de push dos dispositivos nesse segmento.

Remova automaticamente tokens inativos após 90 dias com a autovalidação

O algoritmo de limpeza automática por inatividade no Pushwoosh ajuda a manter sua lista de assinantes limpa, removendo tokens de push de usuários que não estiveram ativos por 90 dias.

Ele funciona rastreando a última vez que os usuários abriram seu aplicativo usando a tag padrão Last Application Open. Se um usuário não abrir o aplicativo por 90 dias ou mais, seu token de push é marcado como inativo e removido da sua base de assinantes.

Use o Rastreamento de Desinstalação

O Rastreamento de Desinstalação (Uninstall Tracking) mantém sua lista de assinantes de push precisa, detectando quando os usuários desinstalam seu aplicativo. Isso permite que o Pushwoosh remova automaticamente os tokens inválidos.

Nota: O Rastreamento de Desinstalação é suportado apenas no iOS e Android.

Veja como funciona:

O Pushwoosh envia uma notificação push silenciosa uma vez por dia para todos os dispositivos inscritos. Essas notificações silenciosas são invisíveis para os usuários, sem alertas, sons ou emblemas.
Cada dispositivo tem um token de push único fornecido por um gateway de notificação. Se o aplicativo foi desinstalado, o token se torna inválido. Quando o push silencioso falha, o gateway retorna um erro.
O Pushwoosh detecta o erro e remove o token inválido da sua lista de assinantes.

Limitações do rastreamento de desinstalação

Os gateways de notificação não garantem a entrega de pushes silenciosos. Essas mensagens podem ser despriorizadas ou descartadas pelo gateway, o que pode atrasar ou limitar a precisão da detecção de desinstalação. Saiba mais

Visualizar dados de desinstalações

Para monitorar a atividade de desinstalação, navegue para Estatísticas > Painéis > Painel do Aplicativo no seu Painel de Controle Pushwoosh. O gráfico de Desinstalações de Aplicativos fornece uma visão cronológica das tendências de desinstalação para o seu aplicativo.

É possível restaurar usuários após a exclusão do token de push?

A exclusão de um token de push usando qualquer método suportado é facilmente reversível.

Quando um usuário reabre seu aplicativo:

O SDK do Pushwoosh solicita automaticamente um novo token de push.
Em seguida, ele registra novamente o dispositivo (via registerDevice).
O usuário se torna um assinante ativo novamente e receberá notificações push a partir de então.