在 Kotlin Multiplatform SDK 中渲染远程配置设计的付费墙

如果您使用远程配置自定义了付费墙，则需要在移动应用的代码中实现渲染逻辑，以便向用户展示。由于远程配置具有高度灵活性，您可以完全掌控付费墙的内容和显示方式。Adapty 提供了获取远程配置的方法，让您能够自主展示自定义付费墙。

获取流程远程配置并展示

在 v4 中，一个流程会在 remoteConfigs 列表中为每个已配置的语言环境携带一个 AdaptyRemoteConfig 条目。选取与用户偏好匹配的语言环境，然后读取所需的值。


Adapty.getFlow("YOUR_PLACEMENT_ID")
    .onSuccess { flow ->
        val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
            ?: flow.remoteConfigs.firstOrNull()
        val headerText = config?.dataMap?.get("header_text") as? String
        // use the remote config values
    }
    .onError { error ->
        // handle the error
    }

至此，获取所有必要的值后，接下来需要将它们渲染并组合成一个视觉上吸引人的页面。确保设计能够适配各种手机屏幕尺寸和方向，在不同设备上提供流畅且友好的用户体验。

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

展示付费墙后，继续设置购买流程。当用户发起购买时，直接调用 .makePurchase() 并传入流程中的产品即可。有关 .makePurchase() 方法的详细信息，请参阅发起购买。

我们建议创建一个备用付费墙（即备用付费墙）。当设备没有网络连接或无可用缓存时，系统会向用户展示此备用付费墙，从而确保用户在上述情况下依然能获得流畅的体验。

追踪付费墙浏览事件

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

要记录一次浏览事件，只需调用 .logShowFlow(flow)，该事件随即会反映在漏斗和 A/B 测试的数据中。

如果你正在展示由流程编辑工具或付费墙编辑工具渲染的流程或付费墙，则无需调用 .logShowFlow(flow)。在这些情况下，Adapty 会自动记录浏览。

Adapty.logShowFlow(flow)
    .onSuccess {
        // flow view logged successfully
    }
    .onError { error ->
        // handle the error
    }

请求参数：

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

如果您通过远程配置自定义了付费墙，则需要在移动应用的代码中实现渲染逻辑，才能将其展示给用户。由于远程配置的灵活性完全由您掌控，付费墙视图的内容和呈现方式均可自定义。我们提供了一个获取远程配置的方法，让您能够自主展示通过远程配置设置的自定义付费墙。

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

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


Adapty.getPaywall(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
    // use the remote config values
}.onError { error ->
    // handle the error
}

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

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

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

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

追踪付费墙浏览事件

Adapty 可帮助您衡量付费墙的效果。虽然我们会自动收集购买数据，但记录付费墙浏览事件需要您的配合，因为只有您知道用户何时看到了付费墙。

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

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

Adapty.logShowPaywall(paywall = paywall)
    .onSuccess {
        // paywall view logged successfully
    }
    .onError { error ->
        // handle the error
    }

请求参数：

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