在 iOS SDK 中进行应用内购买

在 SDK 3.x 中，SDK 会调用 shouldAddStorePayment 代理方法：

• 立即处理交易： 在 shouldAddStorePayment 中返回 true，这将立即触发 Apple 购买系统界面。
• 暂存产品对象，稍后处理： 在 shouldAddStorePayment 中返回 false，之后再调用 makePurchase 并传入已暂存的产品对象。

final class YourAdaptyDelegateImplementation: AdaptyDelegate {
    nonisolated func shouldAddStorePayment(for product: AdaptyDeferredProduct) -> Bool {
        // 1a.
        // Return `true` to continue the transaction in your app. The Apple purchase system screen will show automatically.

        // 1b.
        // Store the product object and return `false` to defer or cancel the transaction.
        false
    }
    
    // 2. Continue the deferred purchase later on by passing the product to `makePurchase` when the timing is appropriate
    func continueDeferredPurchase() async {
        let storedProduct: AdaptyDeferredProduct = // get the product object from 1b.
        do {
            try await Adapty.makePurchase(product: storedProduct)
        } catch {
            // handle the error
        }
    }
}

优惠码允许你向特定用户提供折扣或免费试用。与自动应用的常规优惠不同，优惠码通过应用外渠道分发——例如电子邮件营销、社交媒体或印刷材料。用户可通过在 App Store 中输入代码、访问兑换链接或使用应用内对话框来兑换。

要设置优惠码，请在 App Store Connect 中打开某个订阅，并进入其 Offer Codes 部分。你可以创建三种类型的优惠码：

• Free — 订阅在设定时长内免费，下次续费恢复原价。
• Pay as you go — 用户在设定时长内每个计费周期以折扣价付费，之后订阅恢复原价续费。
• Pay up front — 用户为整个优惠期限支付一次性折扣价，之后订阅恢复原价续费。

你无需将优惠码添加到 Adapty。Apple 会在优惠期间为每笔交易打上优惠码类别标签，包括初次兑换和所有后续折扣续费。Adapty 检测到该标签后，会将每笔交易记录为优惠类别 offer_code。优惠期结束、订阅以原价续费后，该标签将不再存在。你可以在 Adapty 看板中通过 Offer Code 优惠类型筛选分析数据。

收入差异排查

如果你发现 Adapty 中某笔优惠码交易显示的是产品原价而非折扣价，请在 App Store Connect 中核查以下内容：

• 优惠码已为用户可兑换的所有地区配置了正确的定价。
• 已为用户所在的特定国家或地区设置了优惠价格。Apple 在交易中发送的是地区价格。如果该优惠未配置对应地区的价格，Apple 可能会发送产品原价。

你可以在 Adapty 看板中通过 Offer Code 优惠类型和 Offer Discount Type 筛选条件来过滤和核查优惠码交易。

旧版促销码（已弃用）

旧版促销码（每个应用每个版本限 100 个）可免费授予订阅访问权限。与优惠码不同，Apple 不会在促销码交易中包含折扣信息——它在收据中发送的是产品原价。因此，Adapty 会以原价记录这些交易，导致 Adapty 分析数据与 App Store Connect 之间出现收入差异。

如果你看到历史交易以原价记录但实际上应为免费，这些很可能来自旧版促销码。由于这些代码现已弃用，请迁移至优惠码以确保收入数据准确。