Configurando rastreamento de desinstalação do Android

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

API HTTP V1
  1. 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.
  2. Modifique o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
  3. Na página Singular Apps> App > Advanced Settings> Uninstall Tracking, insira o ID do projeto.


    Para criar e configurar o IDdo projeto

    1. Vá para o console do Firebase Cloud Messenger
    2. Selecione ou crie um novo projeto
    3. 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.


    4. Habilite o FCM Cloud Messaging para o projeto navegando até Cloud Messaging e habilitando o Firebase Cloud Messaging API (V1)
    5. Navegue até Contas de serviço > Gerenciar permissões de conta de serviço
    6. Atribua a função e as permissões corretas do projeto
      1. Selecione Roles (Funções ) no menu de navegação à esquerda
      2. 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
      3. Clique em Adicionar permissões e adicione cloudmessaging.messages.create
      4. Clique em Create para concluir a criação da função
    7. Atribuir Singular à função

      1. Selecione IAM no menu de navegação à esquerda
      2. Na guia Permissões, clique em Conceder acesso
      3. Em Add principals (Adicionar entidades ) > New principals (Novas entidades), digite singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
      4. Em Assign roles (Atribuir funções), selecione o Singular Uninstall Tracking (Rastreamento de desinstalação da Singular) criado nas etapas anteriores.
      5. Clique em Salvar
API HTTP (legada)

Para configurar o rastreamento de desinstalação no Android:

  1. 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.
  2. Modifique o AndroidManifest.xml: Consulte os detalhes do guia de rastreamento de desinstalação do Android SDK.
  3. 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.

      Screen_Shot_2017-12-27_at_4.48.09_PM.png

    • 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.

      Screen_Shot_2017-12-27_at_4.56.56_PM.png

  4. Configure o FCM em seu aplicativo da seguinte forma:

    1. No console do Firebase, crie um projeto do Firebase.
    2. No painel do projeto, selecione Adicionar Firebase ao seu aplicativo Android.
    3. Insira o ID do pacote do aplicativo Android.

      Screen_Shot_2017-12-27_at_4.55.41_PM.png

    4. Faça o download do arquivo de configuração (google-services.json) e copie-o para o módulo do aplicativo do projeto Android.
    5. 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'
      }
      }
    6. 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'
    7. Sincronize o projeto.
    8. No código do Android, crie o seguinte serviço:
      public class FCMService extends FirebaseInstanceIdService {
      @Override
      public void onTokenRefresh() {
      super.onTokenRefresh();
      //agora teremos o token
      String token = FirebaseInstanceId.getInstance().getToken();
      }
      }
      O método onTokenRefresh obtém um token FCM que é necessário para enviar notificações.
    9. 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:

Screen_Shot_2017-12-27_at_4.56.12_PM.png