In-App-Käufe analysieren

Über In-App-Käufe können Sie digitale Inhalte oder Artikel in Apps über Google Play oder den App Store verkaufen. Es sind dann keine finanziellen Transaktionen in der App erforderlich. Dabei kann es sich z. B. um abobasierte Inhalte oder spezielle Spielfiguren handeln.

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

Für Android-Apps wird das Analytics SDK in Google Play eingebunden. 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 einem WebView protokollieren. In dieser Anleitung 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

Android-Apps

  • Achten Sie darauf, dass Ihre App das Analytics SDK 17.3.0 oder höher (oder Firebase Android BoM 25.2.0 oder höher) verwendet.

  • Verknüpfen Sie Ihre Firebase-Apps mit Google Play.

Apple-Plattform-Apps

  • Achten Sie darauf, dass Sie das aktuelle SDK verwenden:

    • Für das automatische Tracking von In-App-Käufen: Achten Sie darauf, dass Ihre App das Analytics SDK 6.20.0 oder höher verwendet.

    • Für die manuelle Erfassung von In-App-Käufen: Achten Sie darauf, dass Ihre App das Analytics SDK 12.5.0 oder höher verwendet.

  • Machen Sie sich mit den In-App-Kauf-APIs von Apple StoreKit 1 und StoreKit 2 vertraut, indem Sie die Apple-Dokumentation lesen.

Implementierung

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

Implementierung in Android-Apps

Bei Android-Apps können Sie In-App-Kauf-Ereignisse erfassen, sobald Sie eine Verknüpfung zu Google Play herstellen.

Implementierung in Apps für Apple-Plattformen

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 bestätigte In-App-Kaufereignisse mit dem folgenden Code-Snippet protokollieren.

Wenn Sie In-App-Käufe erfassen müssen, die außerhalb des App Store getätigt werden, können Sie IAP-Ereignisse manuell in einem WebView protokollieren. Das SDK protokolliert In-App-Käufe weiterhin automatisch, sofern möglich, und dedupliziert keine manuell protokollierten In-App-Kaufereignisse. 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 eine Objective-C-Implementierung nicht unterstützt.