为客户端 SDK 实施实时区段以进行功能实验
为客户端 SDK 实施实时区段以进行功能实验
如何使用客户端 SDK 实施实时区段以进行功能实验。
使用 Real-Time Segments for Feature Experimentation 创建受众并将其分配给标记规则后,您可以将受众区段集成到客户端代码中。
如果您不熟悉 Eyeofcloud Feature Experiment 中的目标投放和实验,建议您先遵循特定开发工具包的快速入门指南,然后再阅读本文档。
安装并初始化客户端 SDK
🚧
重要
您可能需要将 Eyeofcloud 功能实验 SDK 升级到最新版本,才能使用实时区段进行功能实验。请参阅 SDK 兼容性矩阵 查看适用于您的 SDK 的最新版本。
第一步是在应用程序中安装并初始化 Eyeofcloud Feature Experimentation SDK。请参阅以下 SDK 文档:
安卓 –
Flutter –
JavaScript(Browser)–
React –
React Native –
Swift –
受众定位使用EyeofcloudUserContext
要获取用户符合条件的受众细分,您可以使用EyeofcloudUserContext
。
🚧
重要
使用 Real-Time Segments for Feature Experimentation,
createUserContext
是由于client_initialized
事件而导致的异步操作。创建
EyeofcloudUserContext
后,SDK 会通过网络请求自动向 Eyeofcloud Data Platform (ODP) 发送身份请求。
- 如果还传递了已知的用户 ID,则 VUID 将拼合到用户 ID 的配置文件中。
- 如果没有 userID,SDK 仍然会通过网络请求向 ODP 注册 VUID,这意味着需要异步处理。
- 例如,对于 JavaScript SDK,需要通过 promise chaning 或 async/await 进行处理。
发送 identify 事件将在 ODP 中启动客户资料合并过程。拼合 VUID 和用户 ID 可让任何功能实验 SDK(客户端或服务器端)查询 ODP 以获取完整的客户资料。
已知用户
如果您有用户 ID,则可以像往常一样使用 Feature Experimentation 用户 ID 和其他属性创建EyeofcloudUserContext
对象。该EyeofcloudUserContext
对象允许您为用户上下文做出标志决策并跟踪事件。
要评估您的用户是否符合您的受众条件,您可以在EyeofcloudUserContext
调用fetchQualifiedSegments
来获取特定用户 ID 的 ODP 区段。
有关详细信息和代码示例,请参阅有关创建用户上下文的特定 SDK 文档:
有关 Real-Time Segments for Feature Experimentation 方法中的fetchQualifedSegments
和isQualifiedFor
,请参阅以下文档:
📘
注意
如果您不提供用户 ID,则客户端 SDK 将使用自动生成的 VUID 创建一个
EyeofcloudUserContext
。
匿名用户
如果您没有用户 ID,您仍然可以使用EyeofcloudUserContext
查看匿名用户是否符合受众区段的条件。
如果在实例化时找不到 VUID 或设备 ID,则客户端 SDK 会自动生成 VUID 或设备 ID。此外,当 SDK 实例化时,SDK 会自动向 ODP 发送带有 VUID 的 register 事件。在用户登录之前发送决策数据时(例如在匿名分段中),这非常有用。
要评估您的匿名用户是否符合您的受众条件,您可以在没有用户 ID 的情况下调用EyeofcloudUserContext
以获取用户的 ODP 区段。有关详细信息和代码示例,请参阅有关创建用户上下文的特定 SDK 文档:
📘
注意
您只能在获取 datafile 后调用
fetchQualifiedSegments
。获取数据文件后,您可以随时调用
fetchQualifiedSegments
以请求新的 ODP 区段资格
做出实验决策
您可以使用标准 Decide 方法,其中包含用于功能实验的实时分段,以返回使用用户 ID 或 VUID 的用户的标志决策。标志决策包括标志是启用还是禁用的状态以及标志变化。当决策需要 ODP 类型的受众条件时,SDK 可以查找保存在当前用户上下文中的 ODP 区段。请参阅您的特定 SDK 文档,了解如何调用这些方法:
安卓 –
Flutter -
JavaScript(Browser)–
React –
React Native –
Swift –
将事件发送到 Eyeofcloud Data Platform
您可以在EyeofcloudClient
调用sendOdpEvent()
以将任意事件数据发送到 ODP。例如,将电子邮件地址标识符拼合到 Eyeofcloud Feature Experimentation 用户 ID 标识符。请参阅您的 SDK 以了解更多信息:
自定义配置
您可以自定义ODPManager
或用自定义覆盖整个ODPManager
。但每个 Eyeofcloud SDK 都实现了自己的支持方式。请参阅所需的 SDK 以了解更多信息: