Ajouter Google Analytics pour Firebase à votre appli instantanée

Avertissement : Google Play Instant ne sera plus disponible. À partir de décembre 2025, les Applis instantanées ne pourront plus être publiées sur Google Play, et toutes les API Instant des services Google Play ne fonctionneront plus. Play ne proposera plus d'applis instantanées aux utilisateurs, quel que soit le mécanisme utilisé.

Nous apportons cette modification en fonction des commentaires des développeurs et de nos investissements continus pour améliorer l'écosystème depuis l'introduction de Google Play Instantané.

Pour continuer à optimiser la croissance du nombre d'utilisateurs, nous encourageons les développeurs à rediriger les utilisateurs vers leur application ou leur jeu habituels à l'aide de liens profonds pour les rediriger vers des parcours ou des fonctionnalités spécifiques, le cas échéant.

Il est important pour chaque développeur de suivre le succès d'une application, qu'elle soit instantanée ou installée. Plusieurs bibliothèques d'analyse sont compatibles avec Google Play Instantané, y compris Fabric Answers, Localytics et Mixpanel.

Si votre solution d'analyse actuelle ne figure pas dans la liste ou si vous constatez qu'elle ne fonctionne pas avec Google Play Instantané, 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'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écrites dans le guide de démarrage de Google Analytics for 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 utiliser les API Google Analytics pour Firebase comme vous le feriez dans un projet d'appli installable.

Pour savoir comment utiliser les API Google Analytics pour Firebase, consultez la documentation sur les premiers pas avec Google Analytics pour Firebase.

Différencier les données des applications installées et instantanées

Étant donné que votre application installée et votre application instantanée partagent un nom de package, vous pouvez différencier les événements et les données collectés pour chacune d'elles. Pour différencier vos applications instantanées et installées dans Analytics, définissez une propriété utilisateur app_type avec la valeur "instant" pour l'application instantanée et "installed" pour l'application installée.

L'extrait de code suivant montre une activité qui obtient 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 par la valeur app_type. La projection de données qui en résulte vous donne un nombre pour l'événement spécifié dans votre application instantanée ou installée.

Pour savoir comment consigner et afficher des événements dans Google Analytics pour Firebase, consultez Journaliser les événements.

Interpréter les événements Analytics

Analytics vous permet de suivre différentes 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 de l'événement ou de la propriété correspondants dans Analytics.

Nom Valeur Analytics Définition
Consultations session_start La session a commencé. Cet événement est suivi automatiquement.
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 l'application Cet événement est suivi automatiquement.
Temps passé dans l'application user_engagement Temps passé par l'application au premier plan. Cet événement est suivi automatiquement.
Contexte de l'appli instantanée app_type Événements déclenchés par l'application s'exécutant dans le contexte instantané ou installé. Vous devez suivre explicitement cet événement dans votre code. Consultez la section Différencier les données des applications installées et instantanées ci-dessus.
Visiteurs connus session_start.count et app_type Audience des utilisateurs qui ont visité votre site au moins deux fois. Vous devez suivre explicitement l'événement app_type. session_start est suivi pour vous. Consultez Différencier 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.