Rastreamento de desinstalação
Este artigo mostra como você pode visualizar desinstalações agregadas de aplicativos ao longo do tempo para localizar tendências e anomalias e rastrear desinstalações no nível da Campaign para determinar se uma Campaign específica está impulsionando ou impedindo instalações de aplicativos.
O rastreamento de desinstalação na Braze fornece os seguintes detalhes:
- Estatísticas diárias de desinstalação no nível do app em um gráfico de série temporal na página inicial.
- Estatísticas de desinstalação em nível de Campaign em um gráfico de série temporal na página Campaign Details de uma Campaign específica. Essa estatística especifica o número de destinatários da Campaign que desinstalam a cada dia.

Você deve optar pelo rastreamento de desinstalação no seu dashboard da Braze. Este recurso está disponível para apps no iOS, Android e Fire OS.
Como funciona
A Braze coleta automaticamente um nível básico de informações de desinstalação de suas Campaigns push regulares. No entanto, como a frequência com que diferentes usuários recebem Campaigns push pode variar, oferecemos rastreamento de desinstalação para fornecer um instantâneo mais preciso da atividade de desinstalação entre seus usuários.
Quando a Braze detecta uma desinstalação, o usuário é marcado como tendo desinstalado. Se você usar o filtro Has Not Uninstalled em uma Campaign, esses usuários marcados serão excluídos. Se um usuário reinstalar o app mas não abri-lo, a tag de desinstalação permanece no perfil. A tag é removida somente quando o usuário inicia uma nova sessão no app reinstalado. Isso significa que um usuário que reinstala mas nunca abre o app continua aparecendo como desinstalado.
Para mais informações sobre como usar o rastreamento de desinstalação, veja nosso post no blog Uninstall Tracking: An Industry Look at its Strengths and Limitations.
Ativação do rastreamento de desinstalação
Você pode ativar o rastreamento de desinstalação na página Configurações do app, em Configurações, para cada app que deseja rastrear.
Quando você ativa o rastreamento de desinstalação para um app, a Braze envia uma mensagem push em segundo plano à noite para usuários que não registraram uma sessão ou não receberam um push nas últimas 24 horas.
Configuração
Para configurar o rastreamento de desinstalação para seu aplicativo iOS, use um método utilitário. Para seu aplicativo Android, use isUninstallTrackingPush(). Quando a Braze detectar uma desinstalação, seja por rastreamento de desinstalação ou por entrega normal de Campaign push, registraremos o melhor horário estimado da desinstalação para o usuário. Esse horário é armazenado no perfil do usuário como um atributo padrão e pode ser usado para definir um segmento de usuários para Campaigns de recuperação.
Filtragem de segmentos por desinstalações
O filtro Uninstalled seleciona usuários que desinstalaram seu app dentro de um intervalo de tempo. Como é difícil determinar a hora exata de uma desinstalação, recomendamos que os filtros de desinstalação tenham intervalos de tempo mais amplos para garantir que todos os que desinstalam sejam incluídos no segmento em algum momento.
As estatísticas diárias sobre desinstalações estão na página inicial.

O gráfico pode ser dividido por app e segmento, semelhante a outras estatísticas que a Braze fornece. Na seção Performance overview, selecione o intervalo de datas e, se desejar, um app. Em seguida, role a tela para baixo até o gráfico Performance Over Time e faça o seguinte:
- No menu suspenso Statistics For, selecione Uninstalls.
- No menu suspenso Breakdown, selecione By segment.
- No menu suspenso Breakdown Values, selecione os segmentos a serem incluídos no gráfico.

Os apps sem rastreamento de desinstalação ativado reportarão desinstalações de apenas um subconjunto de seus usuários (aqueles que foram direcionados com notificações por push), portanto, os totais diários de desinstalação podem ser maiores do que o mostrado.
Rastreamento de desinstalação para Campaigns
O rastreamento de desinstalação de Campaigns mostra o número de usuários que receberam uma Campaign específica e, posteriormente, desinstalaram seu app dentro do período de tempo selecionado. Essa ferramenta fornece insight sobre como as Campaigns podem estar incentivando comportamentos negativos não intencionais dos usuários e ajuda a medir a eficácia geral da Campaign.
As estatísticas de desinstalação de Campaigns estão localizadas na página Campaign Analytics de uma Campaign específica. Para Campaigns multicanais e multivariantes, as desinstalações podem ser divididas por canal e variante, respectivamente.
![]()
Como funciona
A Braze rastreia as desinstalações observando quando as mensagens push enviadas aos dispositivos dos usuários retornam um sinal do Firebase Cloud Messaging (FCM) ou do serviço de Notificações por Push da Apple (APNs) de que o app não está mais instalado. Se você ativar o rastreamento global de desinstalação para um app, a Braze envia uma mensagem push silenciosa diária para os usuários para detectar se eles desinstalaram. A Braze envia este push “silencioso” para todos os usuários (a menos que o usuário tenha desativado os pushes silenciosos nas configurações do app); o push não aparece para os usuários. Se a Braze detectar que um usuário desinstalou, nós:
- Aumentamos a contagem total de desinstalações do app em um.
- Aumentamos em um a contagem de desinstalações para cada Campaign que o usuário recebeu com êxito nas últimas 24 horas.
- Se um usuário receber três Campaigns em um período de 24 horas e depois desinstalar, incrementamos a contagem de “desinstalações” para todas as três Campaigns.
FCM e APNs impõem restrições ao rastreamento de desinstalação. A Braze incrementa apenas a contagem de desinstalação quando FCM ou APNs nos informam que um usuário desinstalou, mas esses sistemas de terceiros podem nos notificar sobre desinstalações a qualquer momento. Use o rastreamento de desinstalação para detectar tendências direcionais em vez de estatísticas precisas.
A Braze trata as seguintes respostas do FCM como respostas de remoção de token (desinstalação): DEVICE_UNREGISTERED, BAD_REGISTRATION e SENDER_ID_MISMATCH.
Para mais informações sobre como usar o rastreamento de desinstalação, veja nosso post no blog Uninstall Tracking: An Industry Look at its Strengths and Limitations.
Solução de problemas
Por que de repente estou vendo um pico de desinstalações?
Se você observar um pico nas desinstalações de aplicativos, isso pode ser devido ao Firebase Cloud Messaging (FCM) e ao serviço de Notificações por Push da Apple (APNs) revogando tokens antigos em uma frequência diferente.

Por razões de privacidade, os provedores de push da Braze podem revogar tokens em intervalos irregulares, o que significa que as contagens de desinstalação podem às vezes aumentar em um determinado período de tempo.
Para validar essas mudanças, monitore o rastreamento de desinstalação juntamente com uma métrica de ação do usuário, como a taxa de abertura de push direto. Se as desinstalações aumentarem drasticamente, mas as aberturas de push direto permanecerem estáveis, o pico provavelmente reflete um parceiro revogando tokens antigos em vez de um comportamento real do usuário.
Como determinar se uma Campaign específica causou desinstalações?
Verifique a análise de dados das Campaigns que enviaram mensagens por volta do mesmo período em que o pico de desinstalação ocorreu. Se uma mensagem específica se correlacionar com um aumento nas desinstalações, ela pode estar influenciando os usuários a desinstalar.
Para visualizar desinstalações por segmento:
- Acesse a página inicial do dashboard.
- Na seção Performance Over Time, selecione Uninstalls em Statistics For e By Segment em Breakdown.
Se você tiver um segmento rastreando usuários inativos com rastreamento de análise de dados ativado, compare a tendência de desinstalação dele com a tendência geral do app.
Como confirmar se as desinstalações são genuínas?
Para APNs, verifique os perfis de usuário em busca do erro de push BadDeviceToken. Se você observar esse erro em massa no mesmo período do pico de desinstalação, as desinstalações provavelmente são genuínas. BadDeviceToken indica que o token de push do dispositivo não é mais válido, o que normalmente acontece quando o app é desinstalado.
Por que o número de desinstalações de apps é diferente do que está no APNs?
A diferença é esperada.
A Apple usa um cronograma aleatório para atrasar a notificação quando um token de push se torna inválido, o que significa que mesmo após um usuário desinstalar um app, o APNs pode continuar a retornar respostas bem-sucedidas para notificações por push por um período de tempo. Esse atraso é intencional e projetado para proteger a privacidade do usuário. Nenhum bounce ou falha será relatado até que o APNs retorne um status 410 para um token inválido.