跳到主要内容

配置中心通道设置

最近更新 2026/10/05

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_versionapp版本文本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
这篇文档对你有帮助吗?