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 Apple App Store. 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 platformy Apple pakiet SDK integruje się ze sklepem Apple App Store za pomocą interfejsów API StoreKit 1 i StoreKit 2 firmy Apple.

W większości przypadków pakiet SDK Analytics automatycznie zbiera zdarzenia IAP bez konieczności wywoływania interfejsu API w aplikacji. Na iOS możesz też rejestrować zdarzenia IAP ręcznie w komponencie WebView, oprócz zdarzeń IAP zbieranych automatycznie. 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 Analytics SDK w wersji 6.20.0 lub nowszej.

    • Aby ręcznie śledzić zakupy w aplikacji, upewnij się, że Twoja aplikacja korzysta z pakietu SDK do Analytics w wersji 12.5.0 lub nowszej.

  • Zapoznaj się z interfejsami API zakupów w aplikacji Apple StoreKit 1 i StoreKit 2, czytając dokumentację Apple.

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 iOS, jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia zakupów w aplikacji. Jeśli używasz StoreKit 2, możesz rejestrować zweryfikowane zdarzenia zakupów w aplikacji za pomocą podanego niżej fragmentu kodu.

Jeśli chcesz śledzić zakupy w aplikacji dokonane poza sklepem z aplikacjami, możesz ręcznie rejestrować zdarzenia IAP w komponencie WebView. Pamiętaj, że pakiet SDK będzie nadal automatycznie rejestrować zakupy w aplikacji, jeśli będzie to możliwe, i nie będzie usuwać duplikatów zdarzeń zakupów w aplikacji zarejestrowanych ręcznie. Jeśli ręcznie śledzisz zakupy w aplikacji, upewnij się, że używasz pakietu SDK Analytics w wersji 12.5.0 lub nowszej.

Swift

Jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia zakupów w aplikacji.

Jeśli używasz StoreKit 2, użyj tego kodu, aby rejestrować zdarzenia IAP.

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

Jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia zakupów w aplikacji.

StoreKit 2 obsługuje tylko język Swift, więc implementacja w języku Objective-C nie jest obsługiwana.