In-App-Käufe analysieren

Plattform auswählen: iOS+ Android Unity


In-App-Käufe (IAP) sind digitale Inhalte oder Funktionen, die Sie in einer mobilen App über den Apple App Store verkaufen können, damit Ihre App keine Finanztransaktionen verarbeiten muss. Beispiele für In-App-Käufe sind abonnementbasierte Inhalte oder spezielle Spielfiguren.

Analytics zeigt IAP-Ereignisse im Bericht „In-App-Käufe“ an.

Bei Apps für Apple-Plattformen wird das SDK über die StoreKit 1- und StoreKit 2-APIs von Apple in den Apple App Store eingebunden.

In den meisten Fällen erfasst das Analytics SDK automatisch IAP-Ereignisse, ohne dass API-Aufrufe in Ihrer App erforderlich sind. Unter iOS können Sie zusätzlich zu den automatisch erfassten IAP-Ereignissen auch IAP-Ereignisse manuell in einer WebView protokollieren. In diesem Leitfaden wird erläutert, wie Sie Ihr Projekt für das automatische Tracking einrichten. Außerdem werden einige Sonderfälle beschrieben, für die einige Zeilen Code erforderlich sind.

Hinweis

Implementierung

In den meisten Fällen protokolliert das Analytics SDK IAP-Ereignisse automatisch, ohne dass zusätzlicher Code erforderlich ist.

Wenn Sie StoreKit 1 für iOS-Apps verwenden, werden In-App-Kauf-Ereignisse automatisch vom Analytics SDK protokolliert. Wenn Sie StoreKit 2 verwenden, können Sie bestätigte In-App-Kaufereignisse mit dem folgenden Code-Snippet protokollieren.

Wenn Sie In-App-Käufe außerhalb des App Store erfassen möchten, können Sie IAP-Ereignisse manuell in einer WebView protokollieren. Das SDK protokolliert In-App-Käufe weiterhin automatisch, sofern möglich. Manuell protokollierte In-App-Kaufereignisse werden nicht dedupliziert. Achten Sie darauf, dass Sie das Analytics SDK v12.5.0 oder höher verwenden, wenn Sie In-App-Käufe manuell erfassen.

Swift

Wenn Sie StoreKit 1 verwenden, protokolliert das Analytics SDK automatisch IAP-Ereignisse.

Wenn Sie StoreKit 2 verwenden, verwenden Sie den folgenden Code, um In-App-Kauf-Ereignisse zu protokollieren.

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

Wenn Sie StoreKit 1 verwenden, protokolliert das Analytics SDK automatisch IAP-Ereignisse.

StoreKit 2 ist nur für Swift verfügbar. Eine Objective-C-Implementierung wird nicht unterstützt.