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, 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“.

Für Android-Apps wird das Analytics SDK in Google Play eingebunden.

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

  • Sie können In-App-Kaufereignisse aus Ihrer App direkt manuell protokollieren, ohne mit dem Google Play Store interagieren zu müssen.

  • Sie können IAP-Ereignisse auch manuell in einer 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

  • 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 aktuelle SDK verwenden:

    • Für das automatische Erfassen von In-App-Käufen muss Ihre App das Analytics SDK ab Version 17.3.0 (oder Firebase Android BoM ab Version 25.2.0) verwenden.
    • Für die manuelle Erfassung von In-App-Käufen: Achten Sie darauf, dass Ihre App das Analytics SDK ab Version 23.2.0 (oder Firebase Android BoM ab Version 34.10.0) verwendet.

  • Firebase-Apps mit Google Play verknüpfen

Implementierung

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

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

Wenn Sie In-App-Käufe erfassen möchten, die nicht über den Google Play Store getätigt wurden, können Sie IAP-Ereignisse manuell mit dem folgenden Code-Snippet oder in einem WebView protokollieren.

Wenn Sie In-App-Käufe manuell erfassen möchten, müssen Sie das Analytics SDK v23.2.0 oder höher (oder Firebase Android BoM v34.10.0 oder höher) 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);
  }
}