React Native SDKのオブザーバーモードでトランザクションを報告する

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

各トランザクションをAdaptyに明示的に報告するにはreportTransactionを使用します。

Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入が起動元のペイウォールに紐付けられ、正確なペイウォールアナリティクスが確保されます。

const variationId = paywall.variationId;

try {
    await adapty.reportTransaction(transactionId, variationId);
} catch (error) {
    // handle the `AdaptyError`
}

パラメーター:

パラメーター	必須/任意	説明
transactionId	必須	iOS の場合: トランザクションの識別子。 Android の場合: 購入のString識別子（purchase.getOrderId）。purchaseは課金ライブラリのPurchaseクラスのインスタンスです。
variationId	任意	バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。

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

両プラットフォームでreportTransactionを使用して各トランザクションを明示的に報告し、Androidでは追加ステップとしてrestorePurchasesを使用してAdaptyがトランザクションを認識できるようにしてください。

Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入が起動元のペイウォールに紐付けられ、正確なペイウォールアナリティクスが確保されます。

if (Platform.OS === 'android') {
    try {
        await adapty.restorePurchases();
    } catch (error) {
        // handle the error
    }
}

...

const variationId = paywall.variationId;

try {
    await adapty.reportTransaction(transactionId, variationId);
} catch (error) {
    // handle the `AdaptyError`
}

パラメーター:

パラメーター	必須/任意	説明
transactionId	必須	iOS、StoreKit 1 の場合: SKPaymentTransactionオブジェクト。 iOS、StoreKit 2 の場合: Transactionオブジェクト。 Android の場合: 購入のString識別子（purchase.getOrderId）。purchaseは課金ライブラリのPurchaseクラスのインスタンスです。
variationId	任意	バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。

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

Adapty SDKは購入の発生元を判断できません。購入処理はお客様自身が行うためです。そのため、オブザーバーモードでペイウォールやA/B テストを使用する場合は、アプリストアから受け取ったトランザクションをモバイルアプリのコードで対応するペイウォールに関連付ける必要があります。アプリをリリースする前にこれを正しく設定することが重要です。設定しないと、アナリティクスにエラーが生じます。

const variationId = paywall.variationId;

try {
    await adapty.setVariationId('transactionId', variationId);
} catch (error) {
    // handle the `AdaptyError`
}

リクエストパラメーター:

パラメーター	必須/任意	説明
transactionId	必須	iOS、StoreKit 1 の場合: SKPaymentTransactionオブジェクト。 iOS、StoreKit 2 の場合: Transactionオブジェクト。 Android の場合: 購入のString識別子（purchase.getOrderId）。purchaseは課金ライブラリのPurchaseクラスのインスタンスです。
variationId	必須	バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。