Observer モードでは、Adapty SDK は既存の購入システムを通じて行われた購入を単独で追跡することができません。アプリストアからのトランザクションをレポートする必要があります。アナリティクスのエラーを避けるために、アプリをリリースする前にこれを設定しておくことが重要です。
reportTransaction を使用して、各トランザクションを明示的に Adapty にレポートしてください。
Warning
トランザクションのレポートを忘れずに!
reportTransaction を呼び出さないと、Adapty はトランザクションを認識できず、アナリティクスにも表示されず、インテグレーションにも送信されません。
Adapty のフローやペイウォールを使用している場合は、トランザクションをレポートする際に variationId を含めてください。これにより、購入がトリガーとなったフローまたはペイウォールに紐付けられ、正確なアナリティクスが確保されます。
do {
// every time when calling transaction.finish()
// verificationResult is the VerificationResult<Transaction> StoreKit 2 returns
try await Adapty.reportTransaction(verificationResult, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}
パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|
| transaction | 必須 | - StoreKit 1 の場合: SKPaymentTransaction。
- StoreKit 2 の場合:
Transaction、または SDK 3.12.0 以降では、StoreKit が返すままの(アンラップ前の)VerificationResult<Transaction>。
|
| variationId | 任意 | ペイウォールバリアントの一意の ID。AdaptyPaywall オブジェクトの variationId プロパティから取得してください。 |
Observerモードでは、Adapty SDKは既存の購入システムを通じて行われた購入を単独で追跡することができません。アプリストアのトランザクションをレポートするか、復元する必要があります。アナリティクスのエラーを避けるため、アプリをリリースする前にこの設定を行うことが重要です。
reportTransactionを使用して、トランザクションデータをAdaptyに送信します。
Warning
トランザクションのレポートをスキップしないでください!
reportTransaction を呼び出さないと、Adapty はトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adapty のフローやペイウォールを使用している場合は、トランザクションをレポートする際に withVariationId を含めてください。これにより、購入がそれをトリガーしたフローまたはペイウォールにリンクされ、正確なアナリティクスが確保されます。
do {
// every time when calling transasction.finish()
try await Adapty.reportTransaction(transaction, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}
パラメーター:
| パラメータ | 必須/任意 | 説明 |
|---|
| transaction | 必須 | - StoreKit 1 の場合: SKPaymentTransaction。
- StoreKit 2 の場合: Transaction。
|
| variationId | 任意 | ペイウォールバリアントの一意のID。AdaptyPaywall オブジェクトの variationId プロパティから取得します。 |
トランザクションの報告
- バージョン3.1.x以前は、App Storeのトランザクションを自動的にリッスンするため、手動での報告は不要です。
- バージョン3.2はObserver Modeをサポートしていません。
フローとペイウォールのトランザクションへの関連付け
Adapty SDK は購入のソースを判断できません。購入処理はお客様側で行っているためです。そのため、Observer モードでフロー、ペイウォール、および/または A/B テストを使用する場合は、アプリストアからのトランザクションを、モバイルアプリのコード内で対応するフローまたはペイウォールに関連付ける必要があります。アプリをリリースする前にこの設定を正しく行っておくことが重要です。行わない場合、アナリティクスにエラーが発生します。
let variationId = paywall.variationId
// There are two overloads: for StoreKit 1 and StoreKit 2
Adapty.setVariationId(variationId, forPurchasedTransaction: transactionId) { error in
if error == nil {
// successful binding
}
}
リクエストパラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|
| variationId | 必須 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。 |
| transactionId | 必須 | StoreKit 1 の場合: SKPaymentTransaction オブジェクト。 StoreKit 2 の場合: Transaction オブジェクト。 |