Mierz zakupy w aplikacji

Wybierz platformę: iOS+ Android Unity


Zakupy w aplikacji to treści lub funkcje cyfrowe, które można sprzedawać w aplikacji mobilnej przez Google Play. Aplikacja nie musi więc w ich przypadku przetwarzać transakcji finansowych. Przykładami zakupów w aplikacji są treści dostępne w ramach subskrypcji lub specjalne dodatki do gier.

Analytics wyświetla zdarzenia IAP w raporcie Zakupy w aplikacji.

W przypadku aplikacji na Androida pakiet SDK Analytics integruje się z Google Play.

W większości przypadków pakiet SDK Analytics automatycznie zbiera zdarzenia IAP bez konieczności wywoływania interfejsu API w aplikacji. Oto kilka dodatkowych opcji zbierania zdarzeń IAP:

  • Możesz ręcznie rejestrować zdarzenia zakupu w aplikacji bezpośrednio z aplikacji, bez interakcji ze Sklepem Play.

  • Zdarzenia zakupów w aplikacji możesz też rejestrować ręcznie w komponencie WebView.

Z tego przewodnika dowiesz się, jak skonfigurować projekt pod kątem automatycznego śledzenia. Opisujemy w nim też kilka szczególnych przypadków, które wymagają wdrożenia kilku wierszy kodu.

Zanim zaczniesz

  • Skonfiguruj projekt w Firebase i bazę kodu aplikacji zgodnie z opisem w artykule Pierwsze kroki z Google Analytics.

  • Połącz projekt w Firebase z usługą w Google Analytics 4.

  • Upewnij się, że używasz najnowszego pakietu SDK:

    • Aby automatycznie śledzić zakupy w aplikacji, upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 17.3.0 lub nowszej (lub Firebase Android BoM w wersji 25.2.0 lub nowszej).
    • Aby ręcznie śledzić zakupy w aplikacji: upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 23.2.0 lub nowszej (lub Firebase Android BoM w wersji 34.10.0 lub nowszej).
  • Połącz aplikacje w Firebase z Google Play.

Implementacja

W większości przypadków pakiet SDK Analytics automatycznie rejestruje zdarzenia zakupów w aplikacji bez konieczności dodawania kodu.

W przypadku aplikacji na Androida możesz mierzyć zdarzenia zakupów w aplikacji, gdy tylko połączysz się z Google Play.

Jeśli chcesz śledzić zakupy w aplikacji dokonane poza Sklepem Play, możesz rejestrować zdarzenia zakupów w aplikacji ręcznie, korzystając z poniższego fragmentu kodu lub w komponencie WebView.

Aby ręcznie śledzić zakupy w aplikacji, upewnij się, że używasz pakietu SDK Analytics w wersji 23.2.0 lub nowszej (lub Firebase Android BoM w wersji 34.10.0 lub nowszej).

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);
  }
}