Zakupy w aplikacji to treści lub funkcje cyfrowe, które można 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 związane z zakupami w aplikacji w raporcie Zakupy w aplikacji.
W przypadku aplikacji na Androida pakiet SDK Analytics jest zintegrowany z usługą Google Play. W przypadku aplikacji na platformę Apple pakiet SDK integruje się z Apple App Store za pomocą interfejsów API StoreKit 1 i StoreKit 2 od Apple.
W większości przypadków pakiet SDK Analytics automatycznie zbiera zdarzenia związane z zakupami w aplikacji bez konieczności wywoływania interfejsu API w aplikacji. W tym przewodniku wyjaśniamy, jak skonfigurować projekt pod kątem automatycznego śledzenia, i opisujemy niektóre przypadki specjalne, które wymagają wdrożenia kilku wierszy kodu.
Zanim zaczniesz
Skonfiguruj projekt Firebase i kod aplikacji zgodnie z opisem w artykule Wprowadzenie do Google Analytics.
W przypadku aplikacji na platformę Apple:
- Upewnij się, że Twoja aplikacja korzysta z pakietu SDK Analytics w wersji 6.20.0 lub nowszej.
W przypadku aplikacji na Androida:
- Upewnij się, że Twoja aplikacja korzysta z pakietu SDK w wersji Analytics17.3.0 lub nowszej (lub Firebase Android BoM25.2.0 lub nowszej).
- Połącz aplikacje Firebase z Google Play.
Jeśli tworzysz aplikację na Androida, możesz mierzyć zdarzenia związane z zakupami w aplikacji od razu po połączeniu z Google Play. Pozostała część tego przewodnika dotyczy aplikacji na platformę Apple.
Jeśli jesteś deweloperem aplikacji na urządzenia Apple, zapoznaj się z interfejsami API do zakupów w aplikacji StoreKit 1 i StoreKit 2, czytając dokumentację Apple.
Implementacja
Swift
Jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia związane z zakupami w aplikacji.
Jeśli używasz StoreKit 2, użyj tego kodu, aby rejestrować zdarzenia związane z zakupami 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
Jeśli używasz StoreKit 1, pakiet SDK Analytics automatycznie rejestruje zdarzenia związane z zakupami w aplikacji.
StoreKit 2 jest dostępny tylko w języku Swift, więc implementacja w Objective-C nie jest obsługiwana.
Kotlin
Aby rejestrować zdarzenia IAP, połącz się z Google Play.
Java
Aby rejestrować zdarzenia IAP, połącz się z Google Play.