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 Google Play 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 Android-Apps wird das Analytics SDK in Google Play eingebunden.

In den meisten Fällen erfasst das Analytics SDK IAP-Ereignisse automatisch, ohne dass API-Aufrufe in Ihrer App erforderlich sind. Außerdem gibt es noch weitere Optionen zum Erfassen von IAP-Ereignissen:

  • Du kannst In-App-Kaufereignisse direkt in deiner App manuell protokollieren, ohne mit dem Play Store zu interagieren.

  • Sie können IAP-Ereignisse 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 Zeilen Code erforderlich sind.

Hinweis

  • Richten Sie Ihr Firebase-Projekt und die Codebasis Ihrer App ein, wie unter Erste Schritte mit Google Analytics beschrieben.

  • Verknüpfen Sie Ihr Firebase-Projekt mit einer Google Analytics 4-Property.

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

    • Für das automatische Tracking von In-App-Käufen: Achten Sie darauf, dass Ihre App das Analytics SDK v17.3.0 oder höher (oder Firebase Android BoM v25.2.0 oder höher) verwendet.
    • Für das manuelle Tracking von In-App-Käufen: Achten Sie darauf, dass Ihre App das Analytics SDK v23.2.0 oder höher (oder Firebase Android BoM v34.10.0 oder höher) verwendet.

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

Implementierung

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

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

Wenn Sie In-App-Käufe außerhalb des Google Play Store erfassen möchten, können Sie IAP-Ereignisse manuell mit dem folgenden Code-Snippet oder in einer WebView protokollieren.

Wenn Sie In-App-Käufe manuell erfassen möchten, müssen Sie das Analytics SDK ab Version 23.2.0 (oder Firebase Android BoM ab Version 34.10.0) verwenden.

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}