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 d'achats intégrés 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 pour être implémentés.
Avant de commencer
Configurez votre projet Firebase et le code de base de votre application comme décrit dans la section 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 6.20.0 ou une version ultérieure.
Pour les applications Android:
- 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).
- Associez vos applications Firebase à Google Play.
Si vous développez une application Android, vous pouvez mesurer les événements IAP dès que vous associez Google Play. Le reste de ce guide est axé sur les applications de la plate-forme Apple.
Si vous êtes développeur Apple, assurez-vous de bien connaître les API Apple StoreKit 1 et StoreKit 2 pour les achats intégrés en consultant la documentation Apple.
Implémentation
Swift
Si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements d'IAP.
Si vous utilisez StoreKit 2, utilisez le code suivant pour journaliser les événements d'achat intégré.
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'IAP.
StoreKit 2 est compatible uniquement avec Swift. Par conséquent, une implémentation Objective-C n'est pas prise en charge.
Kotlin+KTX
Pour consigner les événements IAP, associez-vous à Google Play.
Java
Pour consigner les événements IAP, associez-vous à Google Play.