Mesurer les achats via une application

Les achats via une application désignent des contenus ou fonctionnalités numériques que vous pouvez vendre dans une application mobile via 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 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 Analytics SDK collecte automatiquement les événements d'achat via une application sans nécessiter d'appels d'API dans votre application. Sur iOS, vous pouvez également enregistrer manuellement les événements d'achat via une application dans une WebView en plus de ceux collectés automatiquement. 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 base de code 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 6.20.0 ou une version ultérieure.

  • Pour le suivi manuel des achats via une application : assurez-vous que votre application utilise le SDK Analytics 12.5.0 ou une version ultérieure.

• Familiarisez-vous avec les API d'achat via une application Apple StoreKit 1 et StoreKit 2 en consultant la documentation Apple.

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 iOS, si vous utilisez StoreKit 1, le SDK Analytics enregistre automatiquement les événements d'achat via une application. Si vous utilisez StoreKit 2, vous pouvez enregistrer les événements d'achat via une application validés à l'aide de l'extrait de code ci-dessous.

Vous pouvez également enregistrer manuellement les événements d'achat via une application dans une WebView si vous devez suivre les achats via une application effectués en dehors de l'App Store. Notez que le SDK continuera d'enregistrer automatiquement les achats via une application lorsque cela est possible et ne supprimera pas les doublons des événements d'achat via une application enregistrés manuellement. Assurez-vous d'utiliser le SDK Analytics 12.5.0 ou une version ultérieure lorsque vous effectuez le suivi manuel des achats via une 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()
  ...
}