Les achats intégrés (IAP) sont du contenu ou des fonctionnalités numériques que vous pouvez vendre dans une application mobile via Google Play ou l'App Store d'Apple afin que votre application n'ait pas à traiter de transactions financières. Des exemples d'achats intégrés incluent du contenu par abonnement ou des éléments de jeu spéciaux.
Analytics affiche les événements IAP dans le rapport sur les achats intégrés .
Pour les applications Android, le SDK Analytics s'intègre à Google Play. Pour les applications de la plateforme 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 IAP 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 que tu commences
Configurez votre projet Firebase et la base de code de votre application comme décrit dans Premiers pas avec Google Analytics .
Liez votre projet Firebase à une propriété Google Analytics 4.
Pour les applications de la plateforme Apple :
- Assurez-vous que votre application utilise le SDK Analytics v6.20.0+.
Pour les applications Android :
- Assurez-vous que votre application utilise le SDK Analytics v17.3.0+ (ou Firebase Android BoM v25.2.0+).
- Associez vos applications Firebase à Google Play .
Si vous développez une application Android, vous pouvez mesurer les événements IAP dès que vous vous connectez à Google Play. Le reste de ce guide se concentre sur les applications de la plateforme Apple.
Si vous êtes un développeur Apple, assurez-vous de bien connaître les API d'achat in-app Apple StoreKit 1 et StoreKit 2 en consultant la documentation Apple .
Mise en œuvre
Rapide
Si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements IAP.
Si vous utilisez StoreKit 2, utilisez le code suivant pour enregistrer les événements IAP.
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()
...
}
Objectif c
Si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements IAP.
StoreKit 2 est uniquement Swift, donc une implémentation Objective-C n'est pas prise en charge.
Kotlin+KTX
Pour enregistrer les événements IAP, créez un lien vers Google Play .
Java
Pour enregistrer les événements IAP, créez un lien vers Google Play .