Configurar o rastreio de desinstalação do Android

Documento

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:

Modificar a Política de partilha restrita de domínio
  1. Aceder às políticas da organização
  2. No Console do Google Cloud, navegue até a página Políticas da organização.
  3. Selecione o recurso da organização onde deseja definir a política.
  4. Localize e selecione a restrição Compartilhamento rest rito de domínio na lista.
  5. Clique em Gerenciar política.

Adicionar ID da organização aos valores permitidos

  1. Em Valores da política, escolha Personalizado.
  2. Introduza o ID do recurso da organização no formato:
    is:principalSet://iam.googleapis.com/organizations/626787461583

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

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


    4. Habilite o FCM Cloud Messaging para o projeto navegando até Cloud Messaging e habilitando a 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 Funções no menu de navegação esquerdo
      2. 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
      3. Clique em Adicionar permissões e adicione cloudmessaging.messages.create. Você pode encontrar isso rapidamente filtrando no administrador da API do Firebase Cloud Messaging.
        permissions.png
      4. Clique em Create para terminar de criar a função
    7. Atribuir Singular à função

      1. Selecione IAM no menu de navegação à esquerda
      2. No separador Permissões, clique em Conceder acesso

        iam_grant.png

      3. Em Adicionar entidades > Novas entidades, escreva:

        singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com

        add_principal.png

      4. Em Atribuir funções, selecione a função"Singular Uninstall Tracking" criada nos passos anteriores

        roles.png

        A configuração final deve corresponder:


      5. Clique em Guardar

API HTTP (antiga)

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

      Screen_Shot_2017-12-27_at_4.48.09_PM.png

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

      Screen_Shot_2017-12-27_at_4.56.56_PM.png

  4. Configure o FCM no 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. Baixe o arquivo de configuração (google-services.json) e copie-o para o módulo do aplicativo do projeto Android.
    5. 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'
      }
      }
    6. 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'
    7. Sincronizar o projeto.
    8. No código do Android, crie o seguinte serviço:
      public class FCMService extends FirebaseInstanceIdService {
      @Override
      public void onTokenRefresh() {
      super.onTokenRefresh();
      //now we will have the 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 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:

Screen_Shot_2017-12-27_at_4.56.12_PM.png