本頁面由 Cloud Translation API 翻譯而成。

評估應用程式內購

應用程式內購是指可透過 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 呼叫。在 iOS 上，除了自動收集的應用程式內購事件，您也可以在 WebView 中手動記錄應用程式內購事件。本指南說明如何設定專案以進行自動追蹤，並介紹一些特殊情況，需要幾行程式碼才能實作。

事前準備

按照「開始使用 Google Analytics」一文所述，設定 Firebase 專案和應用程式的程式碼集。
將 Firebase 專案連結至 Google Analytics 4 資源。

Android 應用程式

請確認應用程式使用的是 Analytics SDK v17.3.0 以上版本 (或 Firebase Android BoM v25.2.0 以上版本)。
將 Firebase 應用程式連結至 Google Play。

注意： 如果是 Android 應用程式，只要連結至 Google Play，即可評估應用程式內購事件。本指南的其餘部分著重於 Apple 平台應用程式。

Apple 平台應用程式

請確認您使用的是最新版 SDK：
- 如要自動追蹤應用程式內購，請確認應用程式使用的是 Analytics SDK 6.20.0 以上版本。
- 如要手動追蹤應用程式內購事件，請確認應用程式使用的是 Analytics SDK 12.5.0 以上版本。
請參閱 Apple 說明文件，確保您熟悉 Apple StoreKit 1 和 StoreKit 2 應用程式內商品 API。

導入作業

在大多數情況下，Analytics SDK 會自動記錄應用程式內商品交易事件，不需要額外程式碼。

在 Android 應用程式中實作

如果是 Android 應用程式，只要連結至 Google Play，就能評估應用程式內購事件。

在 Apple 平台應用程式中導入

如果是 iOS 應用程式，如果您使用 StoreKit 1，Analytics SDK 會自動記錄應用程式內購事件。如果您使用 StoreKit 2，可以透過下列程式碼片段記錄已驗證的應用程式內購事件。

或者，如果您需要追蹤在 App Store 以外進行的應用程式內購交易，可以在 WebView 中手動記錄 IAP 事件。請注意，SDK 會盡可能繼續自動記錄應用程式內購事件，且不會移除任何手動記錄的應用程式內購事件。手動追蹤應用程式內購時，請務必使用 Analytics SDK 12.5.0 以上版本。

Swift

如果您使用 StoreKit 1，Analytics SDK 會自動記錄應用程式內購事件。

如果您使用 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