Aggiungi Google Analytics for Firebase alla tua app istantanea

Il monitoraggio del successo di un'app, istantanea o installata, è importante per ogni sviluppatore. Sono compatibili diverse librerie di analisi Google Play Instant, tra cui Risposte del tessuto, Localytics, e Mixpanel.

Se la tua soluzione di analisi corrente non è elencata o se ritieni che non sia inclusa funzionano con Google Play Instant, valuta l'utilizzo di Google Analytics per Firebase come la tua soluzione di telemetria. In questa pagina viene descritto come configurare Google Analytics per Firebase in un progetto di app istantanea.

Aggiunta di Google Analytics for Firebase a un progetto di app istantanea

1. Aggiungi l'SDK Firebase alla tua app seguendo le istruzioni riportate descritti nei Guida introduttiva a Google Analytics per Firebase.
2. Utilizza la versione più recente del plug-in google-services.
3. Inserisci il file google-services.json in ogni modulo.

4. Aggiungi la seguente riga al file build.gradle di ogni modulo:

   Alla moda

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

   Kotlin

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

Dopo aver aggiunto Google Analytics per Firebase al progetto di app istantanea, puoi Utilizzare le API Google Analytics for Firebase come in un progetto di app installabile.

Per saperne di più su come utilizzare le API Google Analytics for Firebase, consulta il documentazione introduttiva su Google Analytics for Firebase.

Capire la differenza tra i dati delle app installate e delle app istantanee

Poiché sia l'app installata che l'app istantanea condividono un nome di pacchetto, potresti voler differenziare gli eventi e i dati raccolti da ciascuno. A differenzia le app istantanee da quelle installate in Analytics, imposta una proprietà utente app_type, con il valore "instant" per l'app istantanea e "installato" per l'app installata.

Il seguente snippet di codice mostra un'attività che riceve un Analytics e poi imposta una proprietà utente. Nota che il codice utilizza PackageManagerCompat.isInstantApp() in onCreate(android.os.Bundle) per determinare il contesto dell'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);
    }

}

Dopo aver impostato la proprietà utente app_type, puoi selezionare un evento nella nella scheda Eventi della console Analytics e filtrare l'evento in base al Valore app_type. La proiezione dei dati risultante fornisce un conteggio per specificato nella tua app istantanea o installata.

Per saperne di più su come registrare e visualizzare gli eventi in Google Analytics per Firebase, consulta Registra eventi.

Interpretazione degli eventi di Analytics

Analytics ti consente di monitorare una serie di metriche importanti a un'app istantanea. La tabella seguente descrive le metriche pertinenti per: di app istantanea, incluso la proprietà o il nome evento corrispondente Analisi.

Per ulteriori informazioni sulle costanti per gli eventi che puoi raccogliere Google Analytics, vedi FirebaseAnalytics.Event.