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

如果你使用远程配置自定义了付费墙,则需要在移动应用代码中实现渲染逻辑,才能将其展示给用户。远程配置灵活性极高,完全由你决定包含哪些内容以及付费墙的呈现方式。Adapty 提供了获取远程配置的方法,让你可以自主展示自定义付费墙。

获取流程远程配置并展示

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

using System.Linq;
using AdaptySDK;

Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    var config = flow.RemoteConfigs.FirstOrDefault(c => c.Locale == "en")
        ?? flow.RemoteConfigs.FirstOrDefault();
    var headerText = config?.Dictionary?["header_text"] as string;

    // Or access raw JSON data
    var jsonData = config?.Data;
});

此时,一旦获取到所有必要的数据,就可以将其渲染并组合成一个美观的页面。请确保设计能够适配各种手机屏幕尺寸和方向,在不同设备上提供流畅且用户友好的体验。

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

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

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

追踪付费墙查看事件

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

要记录查看事件,只需调用 .LogShowFlow(flow),该事件即会反映在漏斗和 A/B 测试的数据指标中。

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

Adapty.LogShowFlow(flow, (error) => {
    // handle the error
});

请求参数:

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

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

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

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

Adapty.GetPaywall("YOUR_PLACEMENT_ID", (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // Access remote config dictionary
    var dictionary = paywall.RemoteConfig?.Dictionary;
    var headerText = dictionary?["header_text"] as string;
    
    // Or access raw JSON data
    var jsonData = paywall.RemoteConfig?.Data;
});

至此,一旦获取了所有必要的值,就可以将它们渲染并组装成一个美观的页面。请确保设计能够适配各种移动设备屏幕和不同的屏幕方向,在不同设备上提供流畅且友好的用户体验。

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

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

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

追踪付费墙浏览事件

Adapty 可帮助您衡量付费墙的表现。虽然我们会自动收集购买数据,但付费墙浏览记录需要您手动上报,因为只有您才知道用户何时看到了付费墙。

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

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

Adapty.LogShowPaywall(paywall, (error) => {
    // handle the error
});

请求参数:

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