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 dotyczące zakupów w aplikacji w raporcie Zakupy w aplikacji.

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

W większości przypadków pakiet Analytics SDK automatycznie zbiera zdarzenia dotyczące zakupów w aplikacji bez konieczności wywoływania interfejsu API w aplikacji. Oto dodatkowe opcje zbierania zdarzeń dotyczących zakupów w aplikacji:

  • Możesz ręcznie rejestrować zdarzenia dotyczące zakupów w aplikacji bezpośrednio z aplikacji, bez interakcji ze Sklepem Play.

  • Możesz też ręcznie rejestrować zdarzenia dotyczące zakupów w aplikacji w widoku WebView.

Z tego przewodnika dowiesz się, jak skonfigurować projekt pod kątem automatycznego śledzenia, oraz poznasz przypadki specjalne, które wymagają dodania 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:

    • W przypadku automatycznego śledzenia zakupów w aplikacji: upewnij się, że Twoja aplikacja korzysta z pakietu Analytics w wersji 17.3.0 lub nowszej (albo z Firebase Android BoM w wersji 25.2.0 lub nowszej).
    • W przypadku ręcznego śledzenia zakupów w aplikacji: upewnij się, że Twoja aplikacja korzysta z pakietu Analytics w wersji 23.2.0 lub nowszej (albo z Firebase Android BoM w wersji 34.10.0 lub nowszej).
  • Połącz aplikacje Firebase z Google Play.

Implementacja

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

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

Jeśli musisz śledzić zakupy w aplikacji dokonane poza Sklepem Play, możesz ręcznie rejestrować zdarzenia dotyczące zakupów w aplikacji, korzystając z tego fragmentu kodu lub w widoku WebView.

Aby ręcznie śledzić zakupy w aplikacji, upewnij się, że używasz Analytics SDK w wersji 23.2.0 lub nowszej (albo 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);
  }
}