인앱 구매 측정

인앱 구매(IAP)는 Google Play 또는 Apple App Store를 통해 모바일 앱에서 판매할 수 있는 디지털 콘텐츠 또는 기능으로, 앱에서 금융 거래를 처리할 필요가 없습니다. 인앱 구매의 예로는 구독 기반 콘텐츠 또는 특별 게임 피스가 있습니다.

Analytics의 인앱 구매 보고서에 IAP 이벤트가 표시됩니다.

Android 앱의 경우 Analytics SDK가 Google Play와 통합됩니다. Apple 플랫폼 앱의 경우에는 SDK가 Apple의 StoreKit 1 API와 StoreKit 2 API를 사용하여 Apple App Store와 통합됩니다.

대부분의 경우 Analytics SDK는 앱에서 API를 호출하지 않아도 IAP 이벤트를 자동으로 수집합니다. iOS에서는 자동으로 수집되는 IAP 이벤트 외에도 WebView에서 IAP 이벤트를 수동으로 로깅할 수도 있습니다. 이 가이드에서는 자동 추적을 위해 프로젝트를 설정하는 방법을 설명하고 코드 몇 줄을 구현해야 하는 몇 가지 특별한 사례를 설명합니다.

시작하기 전에

Google Analytics 시작하기의 설명에 따라 Firebase 프로젝트와 앱의 코드베이스를 설정합니다.
Firebase 프로젝트를 Google 애널리틱스 4 속성에 연결합니다.

Android 앱

앱이 Analytics SDK v17.3.0 이상(또는 Firebase Android BoM v25.2.0 이상)을 사용하는지 확인합니다.
Firebase 앱을 Google Play에 연결합니다.

참고: Android 앱의 경우 Google Play에 연결하는 즉시 IAP 이벤트를 측정할 수 있습니다. 이 가이드의 나머지 부분은 Apple 플랫폼 앱에 중점을 두고 있습니다.

Apple 플랫폼 앱

최신 SDK를 사용하고 있는지 확인합니다.
- 자동 인앱 구매 추적: 앱이 애널리틱스 SDK v6.20.0 이상을 사용하는지 확인합니다.
- 수동 인앱 구매 추적: 앱이 애널리틱스 SDK v12.5.0 이상을 사용하는지 확인합니다.
Apple 문서를 검토하여 Apple StoreKit 1 및 StoreKit 2 인앱 구매 API를 숙지해야 합니다.

구현

대부분의 경우 애널리틱스 SDK는 추가 코드가 없어도 IAP 이벤트를 자동으로 로깅합니다.

Android 앱에서의 구현

Android 앱의 경우 Google Play에 연결하는 즉시 IAP 이벤트를 측정할 수 있습니다.

Apple 플랫폼 앱에서의 구현

iOS 앱의 경우 StoreKit 1을 사용하면 애널리틱스 SDK가 IAP 이벤트를 자동으로 로깅합니다. StoreKit 2를 사용하는 경우 아래 코드 스니펫을 사용하여 확인된 인앱 구매 이벤트를 로깅할 수 있습니다.

또는 App Store 외부에서 이루어진 인앱 구매를 추적해야 하는 경우 WebView에서 IAP 이벤트를 수동으로 로깅할 수 있습니다. SDK는 가능한 경우 인앱 구매를 계속 자동으로 로깅하며 수동으로 로깅된 인앱 구매 이벤트는 중복 삭제하지 않습니다. 인앱 구매를 수동으로 추적할 때는 애널리틱스 SDK v12.5.0 이상을 사용해야 합니다.

Swift

StoreKit 1을 사용하는 경우 Analytics SDK가 IAP 이벤트를 자동으로 로깅합니다.

StoreKit 2를 사용하는 경우에는 다음 코드를 사용하여 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