Mesurer les achats via une application

Sélectionnez une plate-forme : iOS+ Android Unity


Les achats via une application sont des contenus ou des fonctionnalités numériques que vous pouvez vendre dans une application mobile via Google Play, afin que votre application n'ait pas à traiter les transactions financières. Les achats via une application incluent, par exemple, les contenus par abonnement ou les éléments de jeu spéciaux.

Analytics affiche les événements d'achat via une application dans le rapport "Achats via une application".

Pour les applications Android, le SDK Analytics s'intègre à Google Play.

Dans la plupart des cas, le SDK Analytics collecte automatiquement les événements d'achat via l'application sans nécessiter d'appels d'API dans votre application. Voici d'autres options pour collecter les événements d'achat via l'application :

  • Vous pouvez enregistrer manuellement les événements d'achat via une application directement depuis votre application, sans interagir avec le Play Store.

  • Vous pouvez également enregistrer manuellement les événements d'achat via l'application dans une WebView.

Ce guide explique comment configurer votre projet pour le suivi automatique et décrit certains cas particuliers qui nécessitent quelques lignes de code pour être implémentés.

Avant de commencer

  • Configurez votre projet Firebase et le codebase de votre application comme décrit dans Premiers pas avec Google Analytics.

  • Associez votre projet Firebase à une propriété Google Analytics 4.

  • Assurez-vous d'utiliser la dernière version du SDK :

    • Pour le suivi automatique des achats via une application : assurez-vous que votre application utilise le SDK Analytics v17.3.0 ou version ultérieure (ou Firebase Android BoM v25.2.0 ou version ultérieure).
    • Pour le suivi manuel des achats via l'application : assurez-vous que votre application utilise le SDK Analytics v23.2.0 ou version ultérieure (ou Firebase Android BoM v34.10.0 ou version ultérieure).

  • Associez vos applications Firebase à Google Play.

Implémentation

Dans la plupart des cas, le SDK Analytics enregistre automatiquement les événements d'achat via l'application sans nécessiter de code supplémentaire.

Pour les applications Android, vous pouvez mesurer les événements d'achat via l'application dès que vous associez votre compte à Google Play.

Si vous devez suivre les achats via une application effectués en dehors du Play Store, vous pouvez consigner manuellement les événements d'achat via une application à l'aide de l'extrait de code suivant ou dans une WebView.

Pour suivre manuellement les achats via une application, assurez-vous d'utiliser le SDK Analytics v23.2.0 ou version ultérieure (ou Firebase Android BoM v34.10.0 ou version ultérieure).

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}