Ajouter Google Analytics pour Firebase à votre appli instantanée

Suivre le succès d'une application, instantanée ou installée, est important pour chacun développeur. Plusieurs bibliothèques d'analyse sont compatibles avec Google Play Instant, y compris Fabric Answers Services de localisation et Mixpanel.

Si votre solution d'analyse actuelle n'est pas répertoriée ou si vous constatez qu'elle n'est pas avec Google Play Instant, envisagez d'utiliser Google Analytics pour Firebase votre solution de télémétrie. Cette page explique comment configurer Google Analytics pour Firebase dans un projet d'appli instantanée.

Ajouter Google Analytics pour Firebase à un projet d'appli instantanée

  1. Ajoutez le SDK Firebase à votre application en suivant les instructions décrits dans le Guide de démarrage de Google Analytics pour Firebase
  2. Utilisez la dernière version du plug-in google-services.
  3. Placez le fichier google-services.json dans chaque module.

  4. 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'appli instantanée, vous pouvez Utilisez les API Google Analytics pour Firebase, comme vous le feriez dans un projet d'application installable.

Pour en savoir plus sur l'utilisation des API Google Analytics pour Firebase, consultez la documentation de démarrage de Google Analytics pour Firebase.

Faire la différence entre les données des applis installées et celles des applis instantanées

Étant donné que votre installation et votre appli instantanée partagent le même nom de package, vous différencier les événements et les données collectés pour chacun d'eux. À différencier vos applis instantanées et installées dans Analytics, une propriété utilisateur app_type, avec la valeur "instantané" ; pour l'appli instantanée et "installé" pour l'application installée.

L'extrait de code suivant montre une activité qui obtient une Analytics, puis définit une propriété utilisateur. Notez que le code utilise PackageManagerCompat.isInstantApp() dans le 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 dans l'onglet Événements de la console Analytics, puis filtrez l'événement selon le Valeur app_type. La projection de données résultante vous donne un décompte des un événement spécifié dans votre appli instantanée ou installée.

Pour en savoir plus sur la journalisation et l'affichage des événements dans Google Analytics pour Firebase, consultez la page Journaliser les événements.

Interpréter les événements Analytics

Analytics vous permet d'effectuer le suivi de différentes métriques à une appli instantanée. Le tableau suivant décrit les métriques pertinentes pour votre votre appli instantanée, y compris la propriété ou le nom d'événement correspondant dans Analytics.

Nom Valeur Analytics Définition
Visites session_start Session démarrée. Cet événement fait l'objet d'un suivi automatique.
Achats physiques Firebase.Event.ECOMMERCE_PURCHASE Achats physiques. Vous devez suivre cet événement explicitement dans votre code.
Achats numériques in_app_purchase Achats numériques via une application Cet événement fait l'objet d'un suivi automatique.
Temps passé dans l'application user_engagement Temps passé par l'application au premier plan. Cet événement fait l'objet d'un suivi automatique.
Contexte de l'appli instantanée app_type Événements déclenchés à partir de l'application s'exécutant dans l'appli instantanée ou installée le contexte. Vous devez suivre cet événement explicitement dans votre code. Consultez l'article Différences entre les données des applis 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 indiquer explicitement suivre l'événement app_type ; session_start est suivie automatiquement. Reportez-vous à la section Différenciation entre les données des applis installées et celles des applis instantanées ci-dessus.

Pour en savoir plus sur les constantes des événements que vous pouvez collecter Analytics, consultez FirebaseAnalytics.Event.