Gerenciando sua base de assinantes de push

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

Entendendo os push tokens e como eles funcionam

Um push token é 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 push token inclui estas etapas principais:

Quando o aplicativo é iniciado pela primeira vez, ele solicita ao sistema operacional (SO) do dispositivo permissão para receber notificações push.
O serviço de push do aplicativo (por exemplo, APNs para iOS, FCM para Android) gera um push token ú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 de exibição de notificação. 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, 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 juntamente 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 mensagens futuras.
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 push token 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. Em seguida, 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 push tokens 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 push tokens 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 é imediatamente invalidado 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	Mesmo comportamento do APNs. Também acionado pela limpeza de dados do aplicativo ou restauração do dispositivo. Saiba mais
Inatividade do token	Nenhuma expiração documentada devido à 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 push tokens 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 não é entregue, 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 push tokens 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 de nível gratuito ou aqueles inativos por X dias).
Exporte o segmento usando o Control Panel ou o método da API exportSegment.
Chame /bulkUnregisterDevice para excluir os push tokens dos dispositivos nesse segmento.

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

O algoritmo de limpeza automática por inatividade no Pushwoosh ajuda a manter sua lista de assinantes limpa, removendo push tokens de usuários que não estão ativos há 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 push token é marcado como inativo e removido da sua base de assinantes.

Use o Rastreamento de Desinstalação (Uninstall Tracking)

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 em iOS e Android.

Funciona da seguinte forma:

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 push token ú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 > Dashboards > Painel do Aplicativo no seu Control Panel do Pushwoosh. O gráfico de Desinstalações do Aplicativo 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 push token?

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

Quando um usuário reabre seu aplicativo:

O SDK do Pushwoosh solicita automaticamente um novo push token.
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.