在 iOS SDK 中实现 Web 付费墙

在开始之前,请确保您已在控制台中配置了 Web 付费墙,并安装了 Adapty SDK 3.6.1 或更高版本。

打开 Web 付费墙

如果您使用的是自行开发的付费墙,则需要使用 SDK 方法来处理 Web 付费墙。.openWebPaywall 方法会:

  1. 生成一个唯一的 URL,使 Adapty 能够将向特定用户展示的付费墙与其被重定向到的网页关联起来。
  2. 追踪用户返回应用的时机,然后以短暂的间隔请求 .getProfile,以判断用户画像的访问权限是否已更新。

这样,如果付款成功且访问权限已更新,订阅将几乎立即在应用中激活。

do {
    try await Adapty.openWebPaywall(for: product)
} catch {
    print("Failed to open web paywall: \(error)")
}

openWebPaywall 方法有两个版本:

  1. openWebPaywall(product):按付费墙生成 URL,并将产品数据添加到 URL 中。
  2. openWebPaywall(paywall):按付费墙生成 URL,但不将产品数据添加到 URL 中。当您在 Adapty 付费墙中的产品与 Web 付费墙中的产品不同时使用此版本。

处理错误

错误描述建议操作
AdaptyError.paywallWithoutPurchaseUrl付费墙未配置 Web 购买 URL检查付费墙是否已在 Adapty 控制台中正确配置
AdaptyError.productWithoutPurchaseUrl产品没有 Web 购买 URL在 Adapty 控制台中验证产品配置
AdaptyError.failedOpeningWebPaywallUrl无法在浏览器中打开 URL检查设备设置或提供其他购买方式
AdaptyError.failedDecodingWebPaywallUrl无法正确对 URL 中的参数进行编码验证 URL 参数是否有效且格式正确

实现示例

class SubscriptionViewController: UIViewController {
    var paywall: AdaptyPaywall?
    
    @IBAction func purchaseButtonTapped(_ sender: UIButton) {
        guard let paywall = paywall, let product = paywall.products.first else { return }
         Task {
            await offerWebPurchase(for: product)
         }
    }
    
    func offerWebPurchase(for paywallProduct: AdaptyPaywallProduct) async {
        do {
            // Attempt to open web paywall
            try await Adapty.openWebPaywall(for: paywallProduct)
        } catch let error as AdaptyError {
            
            switch error {
            case .paywallWithoutPurchaseUrl, .productWithoutPurchaseUrl:
                showAlert(message: "Web purchase is not available for this product.")
            case .failedOpeningWebPaywallUrl:
                showAlert(message: "Could not open web browser. Please try again.")
            default:
                showAlert(message: "An error occurred: \(error.localizedDescription)")
            }
        } catch {
            showAlert(message: "An unexpected error occurred.")
        }
    }
    
    // Helper methods
    private func showAlert(message: String) { /* ... */ }
}

用户返回应用后,请刷新 UI 以反映用户画像的更新。AdaptyDelegate 将接收并处理用户画像更新事件。

在应用内浏览器中打开 Web 付费墙

从 Adapty SDK v. 3.15 开始支持在应用内浏览器中打开 Web 付费墙。

默认情况下,Web 付费墙在外部浏览器中打开。

为了提供无缝的用户体验,您可以在应用内浏览器中打开 Web 付费墙。这会在您的应用内显示 Web 购买页面,让用户无需切换应用即可完成交易。

要启用此功能,请将 in 参数设置为 .inAppBrowser

do {
    try await Adapty.openWebPaywall(for: product, in: .inAppBrowser) // default – .externalBrowser
} catch {
    print("Failed to open web paywall: \(error)")
}