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
- Aggiungi l'SDK Firebase alla tua app seguendo le istruzioni descritte nella Guida introduttiva a Google Analytics per Firebase.
- Utilizza la versione più recente del plug-in google-services.
- Inserisci il file
google-services.json
in ogni modulo. 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.