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

Acompanhar o sucesso de um app, instantâneo ou instalado, é importante para cada desenvolvedor. Várias bibliotecas de análise são compatíveis com O Google Play Instant, incluindo Fabric Response (link em inglês), Localytics, e Mixpanel.

Se sua solução de análise atual não estiver listada ou se você achar que não funcionar com o Google Play Instant, use o Google Analytics para Firebase sua solução de telemetria. Nesta página, descrevemos 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 seu app seguindo as instruções descritas nos Guia explicativo 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 projeto de app instantâneo, será possível usar as APIs do Google Analytics para Firebase como faria em um projeto de app instalável.

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

Diferenciar os dados de apps instalados e instantâneos

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

Observação: tanto o app instantâneo quanto o instalado precisam implementar a app_type. Além disso, você deve publicar o aplicativo instalado que contém app_type antes do app instantâneo. Caso contrário, O Google Analytics registra eventos do app instalado no app instantâneo quando os usuários instalam o app.

O snippet de código a seguir mostra uma atividade que recebe uma instância do Google Analytics e, em seguida, define uma propriedade do usuário. Note que o código usa PackageManagerCompat.isInstantApp() neste país: onCreate(android.os.Bundle) para determinar o contexto do app.

Kotlin

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)
    }
}

Java

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, você pode selecionar um evento na guia Eventos do console do Google Analytics e filtre o evento pelo Valor de app_type. A projeção de dados resultante fornece uma contagem dos evento especificado no seu app instantâneo ou instalado.

Para mais informações sobre como registrar e visualizar eventos no Google Analytics para Firebase, consulte Registrar eventos.

Interpretar eventos do Analytics

Com o Google Analytics, você pode acompanhar diversas métricas importantes para um app instantâneo. A tabela a seguir descreve métricas relevantes para sua app instantâneo, incluindo o nome ou a propriedade do evento correspondente no Análise de dados.

Nome	Valor no Analytics	Definição
Visitas	session_start	Sessão iniciada. Esse evento é monitorado automaticamente.
Compras físicas	Firebase.Event.ECOMMERCE_PURCHASE	Compras físicas. Você deve rastrear explicitamente este evento no seu código.
Compras digitais	in_app_purchase	Compras digitais no app. Esse evento é monitorado automaticamente.
Tempo no app	user_engagement	Tempo que o app passa em primeiro plano. Esse evento é monitorado automaticamente.
Contexto do app instantâneo	app_type	Eventos gerados pelo app em execução no instante ou no instalado contexto. É necessário rastrear explicitamente este evento no seu código. Consulte Diferenciando entre dados de apps instalados e instantâneos acima.
Visitantes recorrentes	session_start.count e app_type	Público de usuários que visitam duas vezes ou mais. É necessário informar acompanhe o evento app_type. session_start é rastreado para você. Consulte Como diferenciar entre os dados dos apps instalados e instantâneos acima.

Para mais informações sobre as constantes de eventos que você pode coletar em Analytics, consulte FirebaseAnalytics.Event.