在 Observer 模式下,Adapty SDK 无法自动追踪通过现有购买系统完成的购买。你需要手动上报应用商店的交易记录。为避免分析数据出错,请务必在发布应用之前完成此配置。
使用 reportTransaction 可以明确地向 Adapty 上报每笔交易。
Warning
不要跳过交易上报!
如果不调用 reportTransaction,Adapty 将无法识别该交易,它不会出现在分析数据中,也不会被发送到集成服务。
如果你使用 Adapty 流程与付费墙,请在上报交易时附带 variationId。这样可以将购买行为关联到触发它的流程或付费墙,从而确保分析数据准确无误。
do {
// every time when calling transaction.finish()
// verificationResult is the VerificationResult<Transaction> StoreKit 2 returns
try await Adapty.reportTransaction(verificationResult, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}
参数:
| 参数 | 是否必填 | 描述 |
|---|
| transaction | required | - 适用于 StoreKit 1:SKPaymentTransaction。
- 适用于 StoreKit 2:
Transaction,或在 SDK 3.12.0 及更高版本中,可传入 StoreKit 返回的 VerificationResult<Transaction>,无需提前解包。
|
| variationId | optional | 付费墙实验变体的唯一 ID。可从 AdaptyPaywall 对象的 variationId 属性中获取。 |
在观察者模式下,Adapty SDK 无法自动追踪通过现有购买系统完成的交易。您需要手动上报来自应用商店的交易,或对其进行恢复。务必在发布应用之前完成此配置,以避免分析数据出现错误。
使用 reportTransaction 将交易数据发送至 Adapty。
Warning
不要跳过交易上报!
如果你不调用 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
}
Parameters:
| 参数 | 是否必填 | 描述 |
|---|
| 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
}
}
请求参数: