iOS SDKのObserverモードでトランザクションをレポートする

Observerモードでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡できません。アプリストアからトランザクションを手動でレポートする必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を行うことが重要です。

reportTransactionを使用して、Adaptyが認識できるよう各トランザクションを明示的にレポートしてください。

Adaptyのペイウォールを使用している場合は、トランザクションをレポートする際にvariationIdを含めてください。これにより、購入がトリガーとなったペイウォールとリンクされ、正確なペイウォールアナリティクスが確保されます。

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プロパティから取得できます。

Observerモードでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡できません。アプリストアからトランザクションをレポートするか、リストアする必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を行うことが重要です。

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モードをサポートしていません。

トランザクションとペイウォールの関連付け

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オブジェクト。