Aggiungi Google Analytics for Firebase alla tua app istantanea

Monitorare il successo di un'app, istantanea o installata, è importante per ogni sviluppatore. Diverse librerie di analisi sono compatibili con Google Play Instant, tra cui Fabric Response, Localytics e Mixpanel.

Se la tua soluzione di analisi attuale non è presente nell'elenco o se ritieni che non funzioni con Google Play Instant, ti consigliamo di utilizzare Google Analytics per Firebase come soluzione di telemetria. In questa pagina viene descritto come configurare Google Analytics per Firebase in un progetto di app istantanea.

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

  1. Aggiungi l'SDK Firebase alla tua app seguendo le istruzioni descritte nella 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:

    Trendy

    // 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 tuo progetto di app istantanea, puoi utilizzare le API Google Analytics per Firebase come in un progetto di app installabile.

Per ulteriori informazioni su come utilizzare le API di Google Analytics per Firebase, consulta la documentazione introduttiva di Google Analytics per Firebase.

Distinguere tra i dati delle app installate e quelli delle app istantanee

Poiché sia l'app installata che l'app istantanea condividono un nome di pacchetto, ti consigliamo di distinguere gli eventi e i dati raccolti da ciascun pacchetto. Per differenziare le app istantanee e installate in Analytics, imposta una proprietà utente app_type con il valore "istantaneo" per l'app istantanea e "installata" per l'app installata.

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

}

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

Per ulteriori informazioni su come registrare e visualizzare gli eventi in Google Analytics per Firebase, consulta Eventi dei log.

Interpretare gli eventi di Analytics

Analytics ti consente di monitorare una serie di metriche utili per un'app istantanea. La seguente tabella descrive le metriche pertinenti per la tua app istantanea, tra cui il nome o la proprietà dell'evento corrispondente in Analytics.

Nome Valore di Analytics Definizione
Visite session_start Sessione avviata. Questo evento viene monitorato automaticamente.
Acquisti fisici Firebase.Event.ECOMMERCE_PURCHASE Acquisti fisici. Devi monitorare esplicitamente questo evento nel codice.
Acquisti digitali in_app_purchase Acquisti in-app digitali. Questo evento viene monitorato automaticamente.
Tempo nell'app user_engagement Il tempo di permanenza dell'app in primo piano. Questo evento viene monitorato automaticamente.
Contesto dell'app istantanea app_type Eventi generati dall'app in esecuzione nel contesto dell'app istantanea o installata. Devi monitorare esplicitamente questo evento nel codice. Consulta la sezione Differenziare tra i dati delle app installate e quelli delle app istantanee in alto.
Visitatori di ritorno session_start.count e app_type Pubblico di utenti che visitano il sito due o più volte. Devi monitorare esplicitamente l'evento app_type. session_start viene monitorato per te. Consulta la sezione Differenziare tra i dati delle app installate e quelle istantanee in alto.

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