云控配置概览

云控配置（Remote Config） 是 ABC 提供的服务端参数管理能力。需要打开一个开关、改一段文案、调一个数值参数时，不必发新版本——在 ABC 上保存新值，客户端下次拉取就能拿到。

本页面是入门篇，帮你建立「云控配置能干什么、长什么样、怎么用」的整体认知。深入用法见：

• 参数取值与规则—— 动手创建 / 编辑配置时看
• 云控配置概览—— 想把规则升级成 A/B 实验时看

1. 云控配置能解决的业务问题

场景 1：不发版也能调参数

背景：游戏上线后，发现某个节日活动的奖励系数设偏高，收益不达预期。传统做法是改代码 → 编译 → 发新版 → 等用户更新，快也要一周。

云控配置做法：在云控配置里把 event_reward_multiplier 从 1.5 改成 1.2 → Save → 下次 SDK 拉取生效，几分钟内全量生效。

场景 2：不同人群看不同值

背景：xiaomi、oppo、vivo、transsion看到的广告媒体策略应该不同。传统做法是代码里写累赘的 if / else，业务一变就要同步上线。

云控配置做法：为 iaa_mediation_reward_conf 加三条规则：

推送代码一行不动，云控配置会根据用户特征返回对应值。

场景 3：紧急止血（Kill Switch）

背景：某个新上线的活动页面发现高频 crash。传统做法是出热修复 → 发新版，快也要几小时。

云控配置做法：提前在代码里加一个 enable_event_page 开关，出事时把云控配置里的值从 true 改成 false → 用户下次启动不再看到该页面，避免大量用户 crash。

场景 4：分级发布（Gradual Rollout）

背景：首页 promo banner 改版。不想全量上线，想先让 5% 用户看到，指标健康后再扩到 25% / 50% / 100%。

云控配置做法：为 show_new_banner 加一条规则绑定受众「新版本用户」，流量比例从 5% 逐步调到 25% / 50% / 100%。出问题随时改回 0%，全量回退。

2. 一份云控配置包含什么

每份配置由四件事组成，全部在同一张 setup 页编辑：

字段	含义
名称（Name）	SDK 读取的稳定标识。仅字母 / 数字 / 下划线，创建后不可改
取值类型（Value Type）	String / Number / Boolean / JSON 之一，决定规则编辑器样式
规则（Rules）	IF / ELSE IF 分支，把受众和流量比例映射到具体值，最终用 ELSE 兜底
分组（Group）	配置所在的文件夹（默认 Ungrouped），也是多参数实验的边界

取值类型如何选、规则如何编排、各字段细节，详见参数取值与规则。

3. 在哪里管理

左侧导航点 Remote Config，页面分两块：

• 左侧 Groups 侧栏 —— All Configurations、Ungrouped，以及自定义分组（如 iaa）
• 右侧表格 —— 列：Name、Status、Experiments、Value Type、Creator、Created At、Actions 支持 Owned by Me / All / Starred 视图切换，搜索框按 name / owner 子串匹配。

---

4. 云控配置与实验的关系

云控配置和实验共用同一套求值流水线。具体逻辑如下：

1. 规则按从上到下顺序，依次匹配用户属性是否命中受众，并按规则流量百分比抽样
2. 一旦命中，返回该规则的 Value，停止求值
3. 都没命中时，返回配置的 Default Value

任何一条规则都可作为一个实验的流量来源。实验把规则匹配到的用户切分到不同变体，按变体上报指标——配置本身继续通过同一份规则给其他人下发对应的值。详见云控配置概览。

5. 生命周期速览

一份云控配置的生命周期被刻意设计得很简短：创建后默认 Active，可复制、移动分组，最终 Archive 退场。

状态	含义
Active	配置参与 SDK 求值。新创建条目默认状态
Archived	配置从默认列表隐去，不再参与求值。已关联实验仍能解析

归档不是删除——配置的名字、规则、历史、关联关系都保留，可以 Unarchive 找回。归档配置的名字也仍然占用：不能用相同名字再创建 Active 配置。

存在线上实验的配置无法直接归档，需先结束或停止该实验。

6. 分组速览

分组（Group） 是文件夹，存放项目里的一部分云控配置。主要解决两件事：

1. 项目里配置数量多时，把列表整理得能扫一眼看清
2. 限定多参数实验的边界（同一参数组内的参数才能放在同一个配置实验里一起测）

分组	含义
All Configurations	项目里所有 Active 和 Archived 的配置（忽略分组，适合全局搜索）
Ungrouped	默认归宿，新建配置未指定分组都落这里
自定义分组（如 iaa、growth）	用户创建的分组

常见命名维度

• 按方向（initiative） —— iaa、iap、liveops、growth
• 按业务面（surface） —— home_page、checkout、push_notifications
• 按生命周期 —— experimental、stable、to_archive

只挑一个维度，并保持一致。分组不支持嵌套（没有子文件夹），多维度同时使用会让分组列表迅速膨胀。