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 ou l'App Store d'Apple. 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 SDK Analytics s'intègre à Google Play. Pour les applications de la plate-forme Apple, le SDK s'intègre à l'App Store d'Apple à l'aide des API StoreKit 1 et StoreKit 2 d'Apple.
Dans la plupart des cas, le SDK Analytics collecte automatiquement les événements liés aux achats via l'application sans nécessiter d'appels d'API dans votre application. Ce guide explique comment configurer votre projet pour le suivi automatique et décrit certains cas particuliers qui nécessitent quelques lignes de code à implémenter.
Avant de commencer
Configurez votre projet Firebase et le code de base de votre application comme décrit dans Premiers pas avec Google Analytics.
Associez votre projet Firebase à une propriété Google Analytics 4.
Pour les applications de la plate-forme Apple :
- Assurez-vous que votre application utilise le SDK Analytics v6.20.0 ou version ultérieure.
Pour les applications Android :
- 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).
- Associez vos applications Firebase à Google Play.
Si vous développez une application Android, vous pouvez mesurer les événements d'achats via l'application dès que vous établissez un lien vers Google Play. Le reste de ce guide se concentre sur les applications pour la plate-forme Apple.
Si vous êtes un développeur Apple, assurez-vous de bien connaître les API d'achat via l'application Apple StoreKit 1 et StoreKit 2 en consultant la documentation Apple.
Implémentation
Swift
Si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements d'achats via l'application.
Si vous utilisez StoreKit 2, utilisez le code suivant pour consigner les événements d'achats via l'application.
import StoreKit import FirebaseAnalytics // A user tapped a button to purchase an item. func userTappedPurchaseUpgradeButton() { let product = ... purchaseSomeProduct(product) } func purchaseSomeProduct(_ product: Product) { // Purchase a Product. This is mostly standard boilerplate StoreKit 2 // code, except for the Analytics.logTransaction() call. let result = try await product.purchase() switch result { case .success(let verification): let transaction = try checkVerified(verification) // Call this Firebase API to log the in-app purchase event. Analytics.logTransaction(transaction) await transaction.finish() ... }
Objective-C
Si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements d'achats via l'application.
StoreKit 2 est uniquement disponible en Swift. Une implémentation Objective-C n'est donc pas possible.
Kotlin
Pour consigner les événements IAP, créez un lien vers Google Play.
Java
Pour consigner les événements IAP, créez un lien vers Google Play.