在 Flutter SDK 中以观察者模式上报交易

在 Observer 模式下,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 是计费库 Purchase 类的实例。
variationId选填实验变体的字符串标识符。请传入用户购买的 AdaptyPaywallProduct 的 paywallVariationId,其值与包含该产品的 AdaptyFlowPaywall 的 variationId 相同。
appleJwsTransaction选填仅限 iOS,SDK 4.3.0 及以上版本。已签名的 StoreKit 2 交易:即与 transactionId 对应交易的验证结果中的 jwsRepresentation。SDK 会原样将其发送给 Adapty。Android 会忽略此参数。

在 iOS 上,如果您的购买系统提供了 StoreKit 2 交易,请在 appleJwsTransaction 中传入其 JWS 表示:

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