实现用户配置文件服务 UserProfileService

云眼About 3 min

实现用户配置文件服务 UserProfileService

本主题介绍如何设置自定义用户配置文件服务或如何使用云眼灰度实验 JavaScript(节点)SDK 的默认值。

使用用户配置文件服务保留有关用户的信息,并确保变体分配具有粘性。例如,如果正在处理后端网站,则可以创建一个从 Redis 或 Memcached 存储读取和保存用户配置文件的实现。

在 JavaScript Node SDK 中,没有默认实现。实施用户配置文件服务是可选的,仅当希望保持变体分配的粘性时,即使实验条件在运行过程中发生了变化(例如,受众群体、属性、变体暂停和流量分配),才需要实现该服务。否则,JavaScript Node SDK 是无状态的,并且依赖于确定性分桶来返回一致的分配。

如果用户配置文件服务未按预期对用户进行分桶,请检查其他灰度标帜是否覆盖了分桶。有关更多信息,请参阅 分桶的工作原理

实现服务

请参阅下面的代码示例以提供您自己的用户配置文件服务。它应公开两个具有以下签名的函数:

  • lookup :获取用户 ID 字符串并返回与以下架构匹配的用户配置文件。
  • save :获取用户配置文件并保留它。

如果要将用户配置文件服务纯粹用于跟踪目的而不是粘性分桶,则只能实现该方法(始终从 返回)。save``nil``lookup

用户配置文件服务的界面如下所示:

JavaScript

// Sample user profile service implementation const userProfileService = { lookup: userId => { // Perform user profile lookup }, save: userProfileMap => { // Persist user profile }, }; var eyeofcloudClient = eyeofcloud.createInstance({ datafile, userProfileService, });

使用 localStorage 的用户配置文件服务的客户端实现示例如下所示:

JavaScript

var userProfileService = { // Adapter that provides helpers to read and write from localStorage localStorageAdapter: { UPS_LS_KEY: 'eyeofcloud-ups-data', read: function() { var UPSDataObject = JSON.parse(localStorage.getItem(this.UPS_LS_KEY) || '{}'); return UPSDataObject; }, write: function(data) { localStorage.setItem(this.UPS_LS_KEY, JSON.stringify(data)); }, }, // Perform user profile lookup lookup: function(userId) { return this.localStorageAdapter.read()[userId]; }, // Persist user profile save: function(userProfileMap) { var overwriteData = this.localStorageAdapter.read(); overwriteData[userProfileMap.user_id] = userProfileMap; this.localStorageAdapter.write(overwriteData); }, }; // example usage var eyeofcloudClientInstance = window.eyeofcloudSdk.createInstance({ datafile: eyeofcloudDatafile, userProfileService: userProfileService });

下面的代码示例显示了用户配置文件对象的 JSON 架构。在下面的示例中,是实验 ID。^[a-zA-Z0-9]+$

JSON

{ "title": "UserProfile", "type": "object", "properties": { "user_id": { "type": "string" }, "experiment_bucket_map": { "type": "object", "patternProperties": { "^[a-zA-Z0-9]+$": { "type": "object", "properties": { "variation_id": { "type": "string" } }, "required": ["variation_id"] } } } }, "required": ["user_id", "experiment_bucket_map"] }

SDK 使用您提供的用户配置文件服务在保存实验分配的情况下覆盖云眼灰度实验默认分桶行为。

这将覆盖默认的分桶行为,并为给定用户定义备用实验变体。对象中的每个键对应于一个实验替代。实验 ID 是键,值是具有指定所需变体的 'variation_id 属性的对象。如果没有实验条目,则默认分桶行为仍然存在。experiment_bucket_map``experient_bucket_map

实现您自己的用户配置文件服务时,我们建议在初始化时将用户配置文件加载到用户配置文件服务中,并避免对查找函数执行昂贵的阻塞查找,以最大程度地减少合并服务的性能影响。

在多服务器或无状态环境中实现时,我们建议将此接口与 Cassandraopen in new windowRedisopen in new window 等后端一起使用。可以通过配置这些服务来决定将粘性分桶保留多长时间。

Last update:
Contributors: “zhangweixue”