Mesurer les achats via une application

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


Les achats via une application désignent des contenus ou fonctionnalités numériques que vous pouvez vendre dans une application mobile via Google Play. Cela évite d'effectuer des transactions financières dans votre application. Il peut s'agir, par exemple, de contenus vendus par abonnement ou de pièces spéciales dans un jeu.

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

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

Dans la plupart des cas, le Analytics SDK collecte automatiquement les événements d'achat via une application sans nécessiter d'appels d'API dans votre application. Voici quelques options supplémentaires pour collecter des événements d'achat via une 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 une 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 la 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 17.3.0 ou version ultérieure (ou Firebase Android BoM 25.2.0 ou version ultérieure).
    • Pour le suivi manuel des achats via une application : assurez-vous que votre application utilise le Analytics 23.2.0 ou version ultérieure (ou Firebase Android BoM 34.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 une application sans nécessiter de code supplémentaire.

Pour les applications Android, vous pouvez mesurer les événements d'achat via une application dès que vous vous connectez à Google Play.

Si vous devez suivre les achats via une application effectués en dehors du Play Store, vous pouvez enregistrer 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 Analytics SDK 23.2.0 ou version ultérieure (ou Firebase Android BoM 34.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);
  }
}