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, sodass Ihre App keine Finanztransaktionen verarbeiten muss. Beispiele für In‑App-Käufe sind Inhalte, die auf Abos basieren, oder spezielle Spielgegenstände.

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

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 werden IAP-Ereignisse automatisch über das Analytics SDK erfasst, ohne dass API-Aufrufe in Ihrer App erforderlich sind. Unter iOS können Sie IAP-Ereignisse zusätzlich zu den automatisch erfassten IAP-Ereignissen auch manuell in einer WebView protokollieren. In diesem Leitfaden wird beschrieben, wie Sie Ihr Projekt für das automatische Tracking einrichten. Außerdem werden einige Sonderfälle beschrieben, für die einige Codezeilen erforderlich sind.

Hinweis

Implementierung

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

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

Wenn Sie In-App-Käufe erfassen müssen, die nicht über den App-Shop erfolgen, 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-Käufe 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, werden IAP-Ereignisse automatisch vom Analytics SDK protokolliert.

Wenn Sie StoreKit 2 verwenden, können Sie mit dem folgenden Code IAP-Ereignisse 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, werden IAP-Ereignisse automatisch vom Analytics SDK protokolliert.

StoreKit 2 ist nur in Swift verfügbar, daher wird keine Objective-C-Implementierung unterstützt.