O rastreamento de desinstalação do Android utiliza os serviços do Firebase Cloud Messaging. O Firebase está descontinuando a API HTTP herdada em 22 de julho de 2024. Se você ainda estiver usando a API HTTP herdada, atualize para usar a API HTTP V1 por meio da página de configuração do aplicativo Singular. Saiba mais.
A Singular oferece a opção de rastrear desinstalações de aplicativos, como outra forma de medir a qualidade do tráfego que você obtém por meio de suas campanhas de marketing. Essa capacidade está disponível no Singular Android SDK versão 7.x+ e sua ativação requer uma atualização do aplicativo.
Observações:
- O rastreamento de desinstalação da Singular aproveita os serviços do Google, mas usa uma metodologia diferente da do Google. O Google informa as desinstalações diretamente do sistema operacional no dispositivo. Como resultado, os números informados pelo Google podem ser diferentes dos informados pela Singular.
- As desinstalações são rastreadas como eventos na Singular e, como resultado, não removem o link de atribuição da fonte de instalação ou reengajamento de origem. Isso pode resultar em taxas de desinstalação superiores a 100%, uma vez que um usuário pode desinstalar um aplicativo várias vezes durante sua vida útil.
Instruções de configuração
- Integrar o Android SDK 7.x+: O rastreamento de desinstalação está disponível no Android SDK versão 7.x e superior. Para obter instruções sobre como atualizar seu SDK, consulte nosso guia de integração do Android SDK.
- Modifique o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
- Na página Singular Apps> App > Advanced Settings> Uninstall Tracking, insira o ID do projeto.
Para criar e configurar o IDdo projeto
- Vá para o console do Firebase Cloud Messenger
- Selecione ou crie um novo projeto
- Navegue até Visão geral do projeto > Configurações do projeto e copie o ID do projeto. Esse é o ID do projeto que você precisará inserir na página de aplicativos Singular depois que o projeto tiver recebido as funções e permissões adequadas nas etapas subsequentes.
- Habilite o FCM Cloud Messaging para o projeto navegando até Cloud Messaging e habilitando o Firebase Cloud Messaging API (V1)
- Navegue até Contas de serviço > Gerenciar permissões de conta de serviço
- Atribua a função e as permissões corretas do projeto
- Selecione Roles (Funções ) no menu de navegação à esquerda
- Clique em Criar função e insira as seguintes informações
Título: Singular Uninstall Tracking (Rastreamento de desinstalação singular)
ID: singular_uninstalls
Estágio de lançamento da função: Disponibilidade geral
- Clique em Adicionar permissões e adicione cloudmessaging.messages.create
- Clique em Create para concluir a criação da função
- Atribuir Singular à função
- Selecione IAM no menu de navegação à esquerda
- Na guia Permissões, clique em Conceder acesso
- Em Add principals (Adicionar entidades ) > New principals (Novas entidades), digite singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
- Em Assign roles (Atribuir funções), selecione o Singular Uninstall Tracking (Rastreamento de desinstalação da Singular) criado nas etapas anteriores.
- Clique em Salvar
Para configurar o rastreamento de desinstalação no Android:
- Integrar o Android SDK 7.x+: O rastreamento de desinstalação está disponível no Android SDK versão 7.x e superior. Para obter instruções sobre como atualizar seu SDK, consulte nosso guia de integração do Android SDK.
- Modifique o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
-
Adicione seu ID do remetente e a chave do servidor: A Singular requer um número de projeto do Google e uma chave de servidor para ativar o rastreamento de desinstalação. Para recuperar esses valores:
- No Firebase, selecione Go to Console (Ir para o console ) e selecione o projeto.
-
Selecione o ícone de engrenagem e vá para Configurações do projeto > Cloud Messaging.
- Em sua conta Singular, vá para Configurações > Aplicativos, localize o aplicativo para o qual deseja rastrear desinstalações e selecione Editar.
-
Em Uninstall Tracking (Rastreamento de desinstalação), adicione o número do projeto (ID do remetente no Firebase) e a chave do servidor.
-
Configure o FCM em seu aplicativo da seguinte forma:
- No console do Firebase, crie um projeto do Firebase.
- No painel do projeto, selecione Adicionar Firebase ao seu aplicativo Android.
-
Insira o ID do pacote do aplicativo Android.
- Faça o download do arquivo de configuração (google-services.json) e copie-o para o módulo do aplicativo do projeto Android.
- No arquivo build.gradle em nível de projeto (><project>/build.gradle>), adicione o seguinte:
buildscript {
dependencies {
// Adicione esta linha ou a versão mais recente
classpath 'com.google.gms:google-services:3.1.0'
}
} - No arquivo build.gradle em nível de aplicativo (><project>/<app-module>/build.gradle>), adicione o seguinte:
// Adicione ao final do arquivo
apply plugin: 'com.google.gms.google-services' - Sincronize o projeto.
- No código do Android, crie o seguinte serviço:
O método onTokenRefresh obtém um token FCM que é necessário para enviar notificações.public class FCMService extends FirebaseInstanceIdService {
@Override
public void onTokenRefresh() {
super.onTokenRefresh();
//agora teremos o token
String token = FirebaseInstanceId.getInstance().getToken();
}
} - Adicione o serviço ao arquivo de manifesto do Android:
<service android:name=".FCMService">
<intent-filter>
<action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
</intent-filter>
</service>
O Singular agora rastreará as desinstalações dos usuários que têm a versão atualizada do seu aplicativo.
Teste da notificação
Você pode testar a notificação usando o console, fornecendo um token FCM: