Zakupy w aplikacji to treści lub funkcje cyfrowe, które możesz sprzedawać w aplikacji mobilnej przez Google Play lub 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 Androida pakiet SDK Analytics integruje się z Google Play. W przypadku aplikacji na platformę Apple pakiet SDK jest zintegrowany 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 rejestruje zdarzenia IAP bez konieczności wywoływania interfejsu API w aplikacji. W tym przewodniku znajdziesz informacje o tym, jak skonfigurować projekt pod kątem śledzenia automatycznego, oraz opisy kilku szczególnych przypadków, w których konieczne jest wdrożenie kilku linii kodu.
Zanim zaczniesz
Skonfiguruj projekt Firebase i kod źródłowy aplikacji zgodnie z opisem w artykule Początkujący: Google Analytics.
Aplikacje na platformy Apple:
- Upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 6.20.0 lub nowszej.
Aplikacje na Androida:
- Upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 17.3.0 lub nowszej (lub pakietu Firebase Android BoM w wersji 25.2.0 lub nowszej).
- Połącz aplikacje Firebase z Google Play.
Jeśli opracowujesz aplikację na Androida, możesz mierzyć zdarzenia związane z zakupami w aplikacji, gdy tylko ją połączysz z Google Play. Pozostała część tego przewodnika dotyczy aplikacji na platformę Apple.
Jeśli jesteś deweloperem Apple, zapoznaj się z interfejsami API do zakupów w aplikacji Apple StoreKit1 i StoreKit2, korzystając z dokumentacji Apple.
Implementacja
Swift
Jeśli używasz pakietu StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia IAP.
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 pakietu SDK StoreKit 1, Analytics automatycznie rejestruje on zdarzenia IAP.
Interfejs StoreKit 2 jest dostępny tylko w języku Swift, więc implementacja w języku Objective-C nie jest obsługiwana.
Kotlin+KTX
Aby rejestrować zdarzenia IAP, kliknij link do Google Play.
Java
Aby rejestrować zdarzenia IAP, kliknij link do Google Play.