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

如果您使用远程配置自定义了付费墙,则需要在移动应用代码中实现渲染逻辑,以便向用户展示。由于远程配置提供了灵活性,您可以完全控制付费墙视图的内容和显示方式。我们提供了一种获取远程配置的方法,让您能够自主展示通过远程配置设置的自定义付费墙。

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

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

import com.adapty.kmp.Adapty
import com.adapty.kmp.models.AdaptyPaywallFetchPolicy

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 对象。