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

Observer モードでは、Adapty SDK は既存の購入システムを通じて行われた購入を単独で追跡することができません。アプリストアからのトランザクションをご自身で報告する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を必ず行ってください。

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

Adapty のペイウォールを使用している場合は、トランザクションをレポートする際に variationId を含めてください。これにより、購入がトリガーされたペイウォールに紐付けられ、正確なペイウォール分析が保証されます。

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        "YOUR_TRANSACTION_ID", 
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

パラメーター:

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

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

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

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

// every time when calling transaction.finish()
if (Platform.isAndroid) {
    try {
        await Adapty().restorePurchases();
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
    }
}

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        "YOUR_TRANSACTION_ID", 
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

パラメーター:

パラメーター	必須/任意	説明
transactionId	必須	iOS、StoreKit 1 の場合：SKPaymentTransaction オブジェクト。 iOS、StoreKit 2 の場合：Transaction オブジェクト。 Android の場合：String 識別子（purchase は billing library の Purchase クラスのインスタンスで、その purchase.getOrderId）。
variationId	任意	バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。

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

final transactionId = transaction.transactionIdentifier
final variationId = paywall.variationId

try {
  await Adapty().setVariationId('transactionId', variationId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}