Adicionar o Google Analytics para Firebase ao seu app instantâneo

O monitoramento do sucesso de um app, seja instantâneo ou instalado, é importante para todos os desenvolvedores. Várias bibliotecas de análise são compatíveis com o Google Play Instant, entre elas Fabric Answers, Localytics e Mixpanel (links em inglês).

Se sua solução atual de análise não estiver listada ou se você achar que ela não funciona com o Google Play Instant, use o Google Analytics para Firebase como solução de telemetria. Esta página descreve como configurar o Google Analytics para Firebase em um projeto de app instantâneo.

Adicionar o Google Analytics para Firebase a um projeto de app instantâneo

1. Adicione o SDK do Firebase ao app seguindo as instruções descritas no guia Primeiros passos do Google Analytics para Firebase.
2. Use a versão mais recente do plug-in google-services.
3. Coloque o arquivo google-services.json em cada módulo.

4. Adicione a linha a seguir ao arquivo build.gradle de cada módulo:

   Groovy

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

Depois de adicionar o Google Analytics para Firebase ao seu projeto de app instantâneo, é possível usar as APIs do Google Analytics para Firebase da mesma forma que em um projeto de app instalável.

Para mais informações sobre como usar as APIs do Google Analytics para Firebase, consulte a documentação de primeiros passos do Google Analytics para Firebase.

Diferenciar os dados de apps instalados e instantâneos

Como o app instalado e o app instantâneo têm o mesmo nome de pacote, diferencie os eventos e os dados coletados de cada um. Para diferenciar seus apps instantâneos e instalados no Analytics, defina uma propriedade de usuário app_type, com o valor "instant" para o app instantâneo e "installed" para o app instalado.

O snippet de código a seguir mostra uma atividade que recebe uma instância do Analytics e define uma propriedade de usuário. Observe que o código usa PackageManagerCompat.isInstantApp() no método onCreate(android.os.Bundle) para determinar o contexto do app.

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

Depois de definir a propriedade do usuário app_type, é possível selecionar um evento na guia Eventos do console do Analytics e filtrar o evento pelo valor de app_type. A projeção de dados resultante disponibiliza uma contagem do evento especificado no seu app instantâneo ou instalado.

Para saber mais sobre como registrar e ver eventos no Google Analytics para Firebase, consulte Registrar eventos.

Interpretar eventos do Analytics

O Analytics permite monitorar diversas métricas importantes para o app instantâneo. A tabela a seguir descreve métricas relevantes para o app instantâneo, incluindo o nome ou a propriedade do evento correspondente no Analytics.

Para mais informações sobre as constantes de eventos que podem ser coletadas no Analytics, consulte FirebaseAnalytics.Event.