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 utilizzando alcun meccanismo.
Stiamo apportando questa modifica in base al feedback degli sviluppatori e ai nostri continui investimenti 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 alla loro app o al loro gioco normale utilizzando i deep link per reindirizzarli a percorsi o funzionalità specifici, se pertinenti.
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 Answers, Localytics e Mixpanel.
Se la tua attuale soluzione di analisi non è elencata o se non funziona con Google Play Instant, ti consigliamo di utilizzare Google Analytics for Firebase come soluzione di telemetria. Questa pagina descrive come configurare Google Analytics per Firebase in un progetto di app istantanea.
Aggiungere 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 for Firebase.
- Utilizza l'ultima versione 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:Groovy
// 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 tuo 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 di Google Analytics for Firebase, consulta la documentazione introduttiva di Google Analytics for Firebase.
Differenza tra i dati delle app installate e delle app istantanee
Poiché sia l'app installata sia l'app istantanea condividono un nome del pacchetto, ti
consigliamo di differenziare 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 "istantanea" per l'app istantanea e
"installata" per l'app installata.
Il seguente snippet di codice mostra un'attività che ottiene un'istanza di 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); } }
Una volta impostata 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 per l'evento specificato nell'app istantanea o installata.
Per saperne di più 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 utili per un'app istantanea. La seguente tabella descrive le metriche pertinenti per la tua app istantanea, incluso il nome dell'evento o la proprietà 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 tuo codice. |
Acquisti digitali | in_app_purchase |
Acquisti in-app digitali. Questo evento viene monitorato automaticamente. |
Tempo nell'app | user_engagement |
Quantità di tempo che l'app trascorre 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. Devi monitorare esplicitamente questo evento nel tuo codice. Vedi Differenza tra dati di app installate e app istantanee sopra. |
Visitatori di ritorno | session_start.count e app_type |
Pubblico di utenti che effettuano due o più visite. Devi monitorare
esplicitamente l'evento app_type ; session_start
viene monitorato per te. Vedi Differenza tra dati di app installate e app istantanee sopra. |
Per saperne di più sulle costanti per gli eventi che puoi raccogliere in Analytics, consulta FirebaseAnalytics.Event.