O rastreamento de desinstalação do Android utiliza os serviços do Firebase Cloud Messaging. O Firebase está descontinuando a API HTTP legada 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.
O 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 do Singular aproveita os serviços do Google, mas usa uma metodologia diferente do Google. A Google reporta as desinstalações diretamente do sistema operativo no dispositivo. Como resultado, os números relatados pelo Google podem ser diferentes dos relatados 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. Isto pode resultar em taxas de desinstalação superiores a 100%, uma vez que um utilizador pode desinstalar uma aplicação várias vezes ao longo da sua vida.
Se a Partilha com restrição de domínio estiver activada para a sua Organização Google, aplique o ID de organização singular a Valores permitidos:
- Aceder às políticas da organização
- No Console do Google Cloud, navegue até a página Políticas da organização.
- Selecione o recurso da organização onde deseja definir a política.
- Localize e selecione a restrição Compartilhamento rest rito de domínio na lista.
- Clique em Gerenciar política.
Adicionar ID da organização aos valores permitidos
- Em Valores da política, escolha Personalizado.
- Introduza o ID do recurso da organização no formato:
is:principalSet://iam.googleapis.com/organizations/626787461583
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.
- Modificar o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
- Na página Singular Apps > App > Configurações avançadas > Rastreamento de desinstalação, insira a ID do projeto.
Para criar e configurar a ID do 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 seu ID do projeto. Este é o ID do projeto que você precisará inserir na sua 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 a 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 Funções no menu de navegação esquerdo
- Clique em Criar função e introduza as seguintes informações
Título: Rastreamento de desinstalação singular
ID: singular_uninstalls
Fase de lançamento da função: Disponibilidade geral - Clique em Adicionar permissões e adicione cloudmessaging.messages.create. Você pode encontrar isso rapidamente filtrando no administrador da API do Firebase Cloud Messaging.
- Clique em Create para terminar de criar a função
-
Atribuir Singular à função
- Selecione IAM no menu de navegação à esquerda
- No separador Permissões, clique em Conceder acesso
- Em Adicionar entidades > Novas entidades, escreva:
singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
- Em Atribuir funções, selecione a função"Singular Uninstall Tracking" criada nos passos anteriores
A configuração final deve corresponder:
- Clique em Guardar
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.
- Modificar o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
-
Adicione o ID do remetente e a chave do servidor: O 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 Ir para o Console e selecione o projeto.
-
Selecione o ícone de engrenagem e vá para Configurações do projeto > Mensagens na nuvem.
- Na sua conta Singular, vá para Configurações > Aplicativos, localize o aplicativo para o qual você deseja rastrear desinstalações e selecione Editar.
-
Em Rastreamento de desinstalação, adicione o Número do projeto (ID do remetente no Firebase) e a Chave do servidor.
-
Configure o FCM no 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.
- Baixe o arquivo de configuração (google-services.json) e copie-o para o módulo do aplicativo do projeto Android.
- No arquivo build.gradle no nível do projeto (><project>/build.gradle>), adicione o seguinte:
buildscript {
dependencies {
// Add this line or latest version
classpath 'com.google.gms:google-services:3.1.0'
}
} - No ficheiro build.gradle ao nível da aplicação (><project>/<app-module>/build.gradle>), adicione o seguinte:
// Add to the bottom of the file
apply plugin: 'com.google.gms.google-services' - Sincronizar 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();
//now we will have the token
String token = FirebaseInstanceId.getInstance().getToken();
}
} - Adicione o serviço ao ficheiro de manifesto do Android:
<service android:name=".FCMService">
<intent-filter>
<action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
</intent-filter>
</service>
O Singular irá agora rastrear desinstalações para utilizadores que tenham a versão actualizada da sua aplicação.
Testando a notificação
Você pode testar a notificação usando o console fornecendo um token FCM: