應用程式內購是指可透過 Google Play 或 Apple App Store 在行動應用程式中銷售的數位內容或功能,您的應用程式無需處理金融交易。例如訂閱型內容或特殊遊戲商品。
Analytics 會在應用程式內購報表中顯示應用程式內購事件。
針對 Android 應用程式,Analytics SDK 會與 Google Play 整合。針對 Apple 平台應用程式,SDK 會使用 Apple 的 StoreKit 1 和 StoreKit 2 API 與 Apple App Store 整合。
在多數情況下,Analytics SDK 會自動收集應用程式內的應用程式內購事件,而不需要呼叫 API。本指南說明如何設定自動追蹤專案,並說明需要實作幾行程式碼的特殊情況。
事前準備
按照「開始使用 Google Analytics」一文所述,設定 Firebase 專案和應用程式的程式碼集。
Apple 平台應用程式:
- 請確認應用程式使用的是 Analytics SDK 6.20.0 以上版本。
適用於 Android 應用程式:
- 請確認應用程式使用的是 Analytics SDK 17.3.0 以上版本 (或 Firebase Android BoM 25.2.0 以上版本)。
- 將 Firebase 應用程式連結至 Google Play。
如果您正在開發 Android 應用程式,只要連結至 Google Play,即可立即評估應用程式內購事件。本指南的其餘部分將著重於 Apple 平台應用程式。
如果您是 Apple 開發人員,請務必詳閱 Apple 說明文件,熟悉 Apple StoreKit 1 和 StoreKit 2 應用程式內購 API。
實作
Swift
如果您使用的是 StoreKit 1,Analytics SDK 會自動記錄 IAP 事件。
如果您使用的是 StoreKit 2,請使用下列程式碼記錄應用程式內購事件。
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
如果您使用的是 StoreKit 1,Analytics SDK 會自動記錄 IAP 事件。
StoreKit 2 僅支援 Swift,因此不支援 Objective-C 實作。
Kotlin+KTX
如要記錄 IAP 事件,請連結至 Google Play。
Java
如要記錄 IAP 事件,請連結至 Google Play。