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

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

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

Warning

トランザクションの報告をスキップしないでください! reportTransactionを呼び出さないと、Adaptyはトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。

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

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        transactionId: "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 library の Purchase クラスのインスタンスです。
variationId任意バリアントの文字列識別子。ユーザーが購入した AdaptyPaywallProduct の paywallVariationId を渡してください。これは、このプロダクトを含む AdaptyFlowPaywall の variationId と同じ値です。
appleJwsTransaction任意iOS のみ、SDK 4.3.0 以降。署名済みの StoreKit 2 トランザクション: 検証結果の jwsRepresentation。transactionId と同じトランザクションのものを指定します。SDK はそのまま Adapty に送信します。Android ではこのパラメーターは無視されます。

iOSでは、購入システムからStoreKit 2のトランザクションを受け取った場合、そのJWS表現をappleJwsTransactionに渡してください:

await Adapty().reportTransaction(
    transactionId: "YOUR_TRANSACTION_ID",
    variationId: "PAYWALL_VARIATION_ID", // optional
    appleJwsTransaction: jwsRepresentation, // iOS only, optional
);