在 iOS SDK 中渲染通过远程配置设计的付费墙

如果你通过远程配置自定义了付费墙，则需要在移动应用代码中实现渲染逻辑，才能将其展示给用户。由于远程配置的灵活性完全由你掌控，付费墙的内容和外观都取决于你的设计。Adapty 提供了获取远程配置的方法，让你能够自主展示自定义付费墙。不要忘记在 iOS 中检查用户是否有资格享受新用户优惠，并相应调整付费墙视图以处理用户有资格时的情况。

获取流程远程配置并展示

在 v4 版本中，每个流程在 remoteConfigs 数组中为每个已配置的语言区域携带一条 AdaptyRemoteConfig 条目。选取与用户偏好匹配的语言区域，然后读取所需的值。

do {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
    let config = flow.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
    let flow = try? result.get()
    let config = flow?.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow?.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
}

到这一步，你已经获取了所有必要的值，接下来就可以将它们渲染并组合成一个美观的页面。请确保设计能够适配各种手机屏幕尺寸和横竖屏方向，为不同设备的用户提供流畅、友好的体验。

请务必按照以下说明记录付费墙展示事件，以便 Adapty 分析系统采集漏斗和 A/B 测试所需的数据。

显示付费墙后，继续设置购买流程。当用户发起购买时，只需用流程中的产品调用 .makePurchase() 方法。有关 .makePurchase() 方法的详细信息，请参阅发起购买。

我们建议创建一个备用付费墙。当用户没有网络连接或缓存不可用时，将向用户展示此备用付费墙，确保在这些情况下仍能提供流畅的体验。

追踪付费墙展示事件

Adapty 可以帮助你衡量付费墙的表现。购买数据会自动收集，但付费墙的展示事件需要你手动记录，因为只有你知道用户何时看到了付费墙。

要记录付费墙展示事件，只需调用 .logShowFlow(flow)，该事件将反映在漏斗和 A/B 测试的付费墙数据图表中。

如果您展示的是由 Flow Builder 或付费墙编辑工具渲染的流程或付费墙，则无需调用 .logShowFlow(flow)。Adapty 在这些情况下会自动追踪展示。

try await Adapty.logShowFlow(flow)

请求参数：

参数	是否必填	描述
flow	必填	通过 `Adapty.getFlow(placementId:)` 获取的 `AdaptyFlow` 对象。

如果你使用远程配置自定义了付费墙，则需要在移动应用代码中实现渲染逻辑，才能将其展示给用户。由于远程配置的灵活性完全取决于你的需求，付费墙的内容和样式都由你掌控。我们提供了获取远程配置的方法，让你可以自主展示通过远程配置设置的自定义付费墙。请不要忘记在 iOS 中检查用户是否符合新用户优惠的资格，并相应调整付费墙视图以处理用户符合资格的情况。

获取付费墙远程配置并展示

要获取付费墙的远程配置，请访问 remoteConfig 属性并提取所需的值。

do {
    let paywall = try await Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID")
    let headerText = paywall.remoteConfig?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID") { result in
    let paywall = try? result.get()
    let headerText = paywall?.remoteConfig?.dictionary?["header_text"] as? String
}

此时，一旦您获取了所有必要的值，就可以将它们渲染并组合成一个视觉上美观的页面。请确保设计能够适配各种移动手机屏幕尺寸和方向，在不同设备上提供无缝且友好的用户体验。

请务必按照下文所述记录付费墙查看事件，以便 Adapty 分析系统能够收集漏斗和 A/B 测试所需的数据。

展示完付费墙后，请继续设置购买流程。当用户发起购买时，只需使用付费墙中的产品调用 .makePurchase()。有关 .makePurchase() 方法的详细信息，请阅读发起购买。

我们建议创建一个备用付费墙。当用户没有网络连接或无可用缓存时，该备用付费墙将自动展示，确保用户在这些情况下依然能获得流畅的体验。

追踪付费墙浏览事件

Adapty 可以帮助你衡量付费墙的性能表现。购买数据会自动收集，但付费墙浏览记录需要你手动上报，因为只有你知道用户何时看到了付费墙。

要记录付费墙浏览事件，只需调用 .logShowPaywall(paywall)，该事件将反映在漏斗和 A/B 测试的付费墙数据图表中。

如果你展示的是通过付费墙编辑工具创建的付费墙，则无需调用 .logShowPaywall(paywall)。

Adapty.logShowPaywall(paywall)

请求参数：

参数	是否必填	描述
paywall	必填	一个 `AdaptyPaywall` 对象。