Aggiungi Google Analytics for Firebase alla tua app istantanea

Avviso: Google Play Instant non sarà più disponibile. A partire da dicembre 2025, le app istantanee non potranno essere pubblicate tramite Google Play e tutte le API istantanee di Google Play Services non funzioneranno più. Gli utenti non riceveranno più app istantanee da Play tramite alcun meccanismo.

Stiamo apportando questa modifica in base al feedback degli sviluppatori e ai nostri investimenti continui per migliorare l'ecosistema dall'introduzione di Google Play Instant.

Per continuare a ottimizzare per la crescita degli utenti, invitiamo gli sviluppatori a indirizzare gli utenti a alla loro app o al loro gioco normale utilizzando i deep link per reindirizzarli a percorsi o funzionalità specifici, se pertinenti.

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

Se la tua soluzione di analisi attuale non è elencata o se ritieni che non funzioni con Google Play Instant, valuta la possibilità di utilizzare Google Analytics for Firebase come soluzione di telemetria. Questa pagina descrive come configurare Google Analytics for Firebase in un progetto di app istantanea.

Aggiungere Google Analytics for 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 for 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 for Firebase al progetto di app istantanea, puoi utilizzare le API Google Analytics for Firebase come faresti in un progetto di app installabile.

Per ulteriori informazioni su come utilizzare le API Google Analytics for Firebase, consulta la documentazione Guida introduttiva a Google Analytics for Firebase.

Distinguere i dati delle app installate da quelli delle app istantanee

Poiché sia l'app installata sia l'app istantanea condividono un nome del pacchetto, potresti voler distinguere gli eventi e i dati raccolti da ciascuna. Per distinguere le app istantanee e installate in Analytics, imposta una proprietà utente app_type con il valore "instant" per l'app istantanea e "installed" per l'app installata.

Il seguente snippet di codice mostra un'attività che recupera un'istanza di Analytics e poi imposta una proprietà utente. Tieni presente che il codice utilizza PackageManagerCompat.isInstantApp() nel onCreate(android.os.Bundle) metodo 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 e poi filtrare l'evento in base al valore app_type. La proiezione dei dati risultante fornisce un conteggio dell'evento specificato nell'app istantanea o installata.

Per ulteriori informazioni su come registrare e visualizzare gli eventi in Google Analytics for Firebase, consulta Registrare eventi.

Interpretare gli eventi di Analytics

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

Nome Valore di Analytics Definizione
Visite session_start Sessione avviata. Questo evento viene monitorato automaticamente.
Acquisti di beni fisici Firebase.Event.ECOMMERCE_PURCHASE Acquisti di beni fisici. Devi monitorare esplicitamente questo evento nel codice.
Acquisti digitali in_app_purchase Acquisti in-app digitali. Questo evento viene monitorato automaticamente.
Tempo trascorso nell'app user_engagement Quantità di tempo trascorso dall'app in primo piano. Questo evento viene monitorato automaticamente.
Contesto dell'app istantanea app_type Eventi generati dall'app in esecuzione nel contesto istantaneo o installato contesto. Devi monitorare esplicitamente questo evento nel codice. Vedi Distinguere i dati delle app installate da quelli delle app istantanee sopra.
Visitatori di ritorno session_start.count e app_type Pubblico di utenti che visitano due o più volte. Devi monitorare esplicitamente l'evento app_type ; session_start viene monitorato automaticamente. Vedi Distinguere i dati delle app installate da quelli delle app istantanee sopra.

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