アプリ内購入(IAP)とは Google Play または Apple App Store 経由で販売できる、モバイルアプリ内のデジタル コンテンツまたは機能で、販売する際にアプリ内で決済を処理する必要がありません。アプリ内購入の例としては、定期購入コンテンツや特別なゲーム コンテンツが挙げられます。
アナリティクスでは、アプリ内購入レポートに IAP イベントが表示されます。
Android アプリの場合、アナリティクス SDK は Google Play に統合されています。Apple プラットフォーム アプリの場合、SDK は、Apple の StoreKit 1 API と StoreKit 2 API を使用して Apple App Store に統合されています。
ほとんどの場合、アナリティクス SDK は自動的に IAP イベントを収集するため、アプリ内で API 呼び出しを行う必要はありません。このガイドでは、プロジェクトの自動トラッキングを設定する方法と、数行のコードを記述する必要がある特殊なケースについて説明します。
準備
Google アナリティクスのスタートガイドの説明に沿って、Firebase プロジェクトとアプリのコードベースを設定します。
Apple プラットフォーム アプリの場合:
- アプリでアナリティクス SDK v6.20.0 以降を使用していることを確認します。
Android アプリの場合:
- アプリでアナリティクス SDK v17.3.0 以降(または Firebase Android BoM v25.2.0 以降)を使用していることを確認します。
- Firebase アプリを Google Play にリンクします。
Android アプリを開発している場合は、Google Play にリンクするとすぐに IAP イベントを測定できます。このガイドの残りの部分では、Apple プラットフォーム アプリの場合について説明します。
Apple のデベロッパーの方は、Apple のドキュメントをお読みになり、アプリ内購入 API である Apple StoreKit 1 と StoreKit 2 について十分に理解していることを確認してください。
実装
Swift
StoreKit 1 を使用している場合、アナリティクス 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
StoreKit 1 を使用している場合、アナリティクス SDK は自動的に IAP イベントをロギングします。
StoreKit 2 は Swift のみであるため、Objective-C 実装はサポートされていません。
Kotlin+KTX
IAP イベントをロギングするには、Google Play にリンクします。
Java
IAP イベントをロギングするには、Google Play にリンクします。