Suivre le succès d'une application, instantanée ou installée, est important pour chaque développeur. Plusieurs bibliothèques d'analyse sont compatibles avec Google Play Instant, y compris Fabric Answers, Localytics et Mixpanel.
Si votre solution d'analyse actuelle n'est pas répertoriée ou si vous constatez qu'elle ne fonctionne pas avec Google Play Instant, envisagez d'utiliser Google Analytics pour Firebase comme solution de télémétrie. Cette page explique comment configurer Google Analytics pour Firebase dans un projet d'application instantanée.
Ajouter Google Analytics pour Firebase à un projet d'application instantanée
- Ajoutez le SDK Firebase à votre application en suivant les instructions décrites dans le guide de démarrage de Google Analytics pour Firebase.
- Utilisez la dernière version du plug-in google-services.
- Placez le fichier
google-services.json
dans chaque module. Ajoutez la ligne suivante au fichier
build.gradle
de chaque module:Groovy
// android { ... } // dependencies { ... } plugins { id 'com.google.gms.google-services' }
Kotlin
// android { ... } // dependencies { ... } plugins { id("com.google.gms.google-services") }
Une fois que vous avez ajouté Google Analytics pour Firebase à votre projet d'application instantanée, vous pouvez utiliser les API Google Analytics pour Firebase, comme vous le feriez dans un projet d'application installable.
Pour découvrir comment utiliser les API Google Analytics pour Firebase, consultez la documentation de démarrage de Google Analytics pour Firebase.
Différencier les données des applis installées et celles des applis instantanées
Étant donné que votre application installée et votre appli instantanée partagent un nom de package, vous pouvez différencier les événements et les données collectés de chacun d'eux. Pour différencier vos applis instantanées et vos applications installées dans Analytics, définissez une propriété utilisateur app_type
, avec la valeur "instantané" pour l'appli instantanée et "installée" pour l'application installée.
L'extrait de code suivant montre une activité qui récupère une instance Analytics, puis définit une propriété utilisateur. Notez que le code utilise PackageManagerCompat.isInstantApp()
dans la méthode onCreate(android.os.Bundle)
pour déterminer le contexte de l'application.
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); } }
Une fois que vous avez défini la propriété utilisateur app_type
, vous pouvez sélectionner un événement dans l'onglet Événements de la console Analytics, puis filtrer l'événement selon la valeur app_type
. La projection de données résultante vous indique le décompte de l'événement spécifié dans votre application instantanée ou installée.
Pour découvrir comment consigner et afficher des événements dans Google Analytics pour Firebase, consultez Journaliser les événements.
Interpréter des événements Analytics
Analytics vous permet de suivre diverses métriques utiles pour une application instantanée. Le tableau suivant décrit les métriques pertinentes pour votre application instantanée, y compris le nom ou la propriété de l'événement correspondant dans Analytics.
Nom | Valeur Analytics | Définition |
---|---|---|
Visites | session_start |
Session démarrée. Cet événement fait automatiquement l'objet d'un suivi. |
Achats physiques |
Firebase.Event.ECOMMERCE_PURCHASE
|
Achats physiques. Vous devez suivre explicitement cet événement dans votre code. |
Achats numériques | in_app_purchase |
Achats numériques via les applications. Cet événement fait automatiquement l'objet d'un suivi. |
Temps dans l'application | user_engagement |
Temps passé par l'application au premier plan. Cet événement fait automatiquement l'objet d'un suivi. |
Contexte de l'appli instantanée | app_type |
Événements déclenchés par l'application exécutée dans le contexte instantané ou installé. Vous devez suivre explicitement cet événement dans votre code. Voir Différencier les données des applications installées et instantanées ci-dessus. |
Visiteurs connus | session_start.count et app_type |
Audience composée d'utilisateurs qui visitent le site deux fois ou plus. Vous devez suivre explicitement l'événement app_type . session_start est automatiquement suivi. Voir Faire la différence entre les données des applications installées et instantanées ci-dessus. |
Pour en savoir plus sur les constantes des événements que vous pouvez collecter dans Analytics, consultez FirebaseAnalytics.Event.