配置中心通道设置
AE 运营模块推出 配置中心 功能,让您无需重新发布版本,即可实现应用外观和应用内活动内容的更新。 配置中心提供通过 Webhook 服务下发配置和 客户端 SDK 拉取配置两种配置获取方式,本章节会对两种获取方式下的通道配置方式进行说明。
- 通过 Webhook 获取:通过较为轻量的 REST API 开发对接,提供Webhook 地址获取 配置信息,在适配处理后转交下游系统。
- 通过客户端 SDK 获取:集成 AE RemoteConfig SDK,实现客户端配置拉取。
本文对两种获取方式下的通道设置进行说明。通道创建完成后,绑定至 配置项 ,可通过 配置模板发送测试 验证通道的有效性。
Webhook 通道
入口:配置中心 - 通道管理 - Webhook 通道
通道名称
Webhook 通道的名称。
Url
接收消息推送的接口地址。
正式环境 接口地址用于配置下发。
测试环境 接口地址用于策略发送测试验证。
自定义请求头
开启后,可以为发往该 URL 的请求添加自定义请求头(Header 名称和 Header 值),用于传递 Authorization、API Key 或业务标识,最多添加 10 个。
通道鉴权
您可以开启通道鉴权填写密钥,以防止非法调用,提高通道的安全性。
用户参数
进行用户级配置下发时, AE系统将满足目标条件的人群 #user_id 及通道用户参数推送至下游服务端。请在通道中添加下游可解析的id字段作为用户参数(如#account_id)。用户参数仅在「用户级配置」下发时使用,当选择目标环境下发时,不提供用户属性数据。
当应用场景为对接多个下游系统时,您可指定某一用户参数作为下游系统对接标识字段(如为多个游戏服务器下发配置,指定服务器ID为系统对接标识字段)。指定后,配置下发将按照字段值拆包处理,webhook中转服务仅面向目标系统做转发即可。具体下发格式见Webhook配置接入文档。
环境参数
环境参数用来指定配置策略的目标环境。使用场景如多服游戏对部分服务器开放某活动配置、面向某系统语言用户下发该语言的站内信等,配置下发目标为环境条件而非具体的目标用户群。
以上两个场景,可将"服务器"和"语言"添加为环境参数,添加后,可在配置策略中用于配置环境条件。环境值将直接透传下发至下游服务器。
当选择环境参数类型为"文本"时,可为环境参数指定备选值。备选值支持两种指定类型:
- 您可在下方输入框中直接定义,如操作系统取值 Android、iOS
- 您也可以选择从配置表获取备选值(此时只能选择配置表中的选项作为环境值,为保证配置表信息时效性,可使用配置表api更新配置表)。
- 同样,若您的使用场景为对接多下游系统,可设置某环境参数为下游系统对接标识字段。设置后,在操作暂停或下线策略时,下发消息中也将携带完整的系统对接标识值列表,方便下游webhook服务做转发处理。具体下发格式见Webhook配置接入文档。
客户端通道
入口:配置中心 - 通道管理 - 客户端通道
通道名称
客户端通道的名称
用户参数
将希望随配置下发到客户端的「用户属性」信息定义为用户参数。当客户端请求配置时,将实时计算该用户的参数信息,随配置下发。
环境参数
终端设备请求时可携带的请求参数,V4.4 仅支持数数 SDK 可自动采集的参数作为环境参数。支持明细如下:
| 参数名 | 参数显示名 | 参数类型 | 说明 |
|---|---|---|---|
| #app_version | app版本 | 文本 | APP 的版本 |
| #bundle_id | 应用包名 | 文本 | APP 包名或者进程名 |
| #device_model | 设备型号 | 文本 | 用户设备的型号,如:iPhone 8 等 |
| #device_type | 设备类型 | 文本 | 用户设备的类型,如:iPad,iPhone 等 |
| #manufacturer | 生产商 | 文本 | 用户设备的制造商,如:Apple,vivo 等 |
| #network_type | 网络类型 | 文本 | 事件发生时的网络状态,如:WIFI、3G、4G 等 |
| #os | 操作系统 | 文本 | 如:Android、iOS 等 |
| #os_version | 操作系统版本 | 文本 | 如:iOS 11.2.2、Android 8.0.0 等 |
| #simulator | 是否为模拟器 | 布尔 | 设备是否是模拟器 true/false |
| #system_language | 系统语言 | 文本 | 用户设备的系统语言(ISO 639-1,即两位小写英文字母),如:zh, en 等 |
| #zone_offset | 时区偏移 | 数值 | 数据时间相对 UTC 时间的偏移小时数 |
| #device_id | 设备号 | 文本 | 用户的设备 ID,iOS 取用户的 IDFV 或 UUID,Android 取 androidID |

