Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mierz zakupy w aplikacji

Wybierz platformę:

iOS+ Android

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 zakupu w aplikacji w raporcie Zakupy w aplikacji.

W przypadku aplikacji na platformę Apple pakiet SDK integruje się z 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 zakupu w aplikacji bez konieczności wywoływania interfejsu API w aplikacji. W iOS oprócz automatycznie zbieranych zdarzeń zakupu w aplikacji możesz też ręcznie rejestrować zdarzenia zakupu w aplikacji w WebView. Z tego przewodnika dowiesz się, jak skonfigurować projekt pod kątem automatycznego śledzenia, oraz poznasz kilka szczególnych przypadków, które wymagają dodania kilku wierszy kodu.

Zanim zaczniesz

Skonfiguruj projekt w Firebase i bazę kodu aplikacji zgodnie z opisem w artykule Pierwsze kroki w 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 SDK Analytics w wersji 6.20.0 lub nowszej.
- W przypadku ręcznego śledzenia zakupów w aplikacji: upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 12.5.0 lub nowszej.
Zapoznaj się z dokumentacją Apple, aby dowiedzieć się więcej o interfejsach API StoreKit 1 i StoreKit 2 do obsługi zakupów w aplikacji, przeglądając dokumentację Apple.

Implementacja

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

W przypadku aplikacji na iOS, jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia zakupu w aplikacji. Jeśli używasz StoreKit 2, możesz rejestrować zweryfikowane zdarzenia zakupu w aplikacji za pomocą fragmentu kodu poniżej.

Jeśli chcesz śledzić zakupy w aplikacji dokonane poza App Store, możesz też ręcznie rejestrować zdarzenia zakupu w aplikacji w WebView. Pamiętaj, że pakiet SDK będzie nadal automatycznie rejestrować zakupy w aplikacji, gdy będzie to możliwe, i nie będzie usuwać duplikatów ręcznie rejestrowanych zdarzeń zakupu w aplikacji. Podczas ręcznego śledzenia zakupów 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 zakupu w aplikacji.

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

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