# 广告聚合平台字段配置

> 来源：https://help.gravity-engine.com/docs/appendix/ad-mediation-fields
> 说明 TopOn 等广告聚合平台中 adUnionType、adPlacementId、adSourceId 与 eCPM 等字段的获取和上报配置。















## 文档概述 [#文档概述]

本文档详细说明了各广告聚合平台中关键字段的获取方式和配置要求，为广告集成上报提供标准化参考。

## 字段说明表 [#字段说明表]

| 英文字段名           | 中文名称           | 是否必填 | 描述            | 备注                                                                                |
| --------------- | -------------- | ---- | ------------- | --------------------------------------------------------------------------------- |
| `adUnionType`   | 广告聚合平台类型       | 否    | 标识使用的广告聚合平台类型 | 取值：`topon`/`gromore`/`self`                                                       |
| `adPlacementId` | 广告瀑布流 ID       | 否    | 广告位唯一标识符      | 各平台获取方式不同                                                                         |
| `adSourceId`    | 广告源 ID（代码位 ID） | 否    | 广告源的唯一标识      | 平台间命名差异较大                                                                         |
| `adType`        | 广告类型           | 是    | 广告展示形式        | 枚举值：`reward`/`banner`/`native`/`interstitial`/`splash`/`video_feed`/`video_begin` |
| `adnType`       | 广告平台类型         | 否    | 广告网络平台标识      | 枚举值：`csj`/`gdt`/`ks`/`mint`/`baidu`/`other`                                       |
| `ecpm`          | 预估 eCPM 价格     | 建议填写 | 千次展示预估收益      | 部分平台不支持获取                                                                         |

## 各平台字段获取详细说明 [#各平台字段获取详细说明]

### 1. TopOn 聚合平台 [#1-topon-聚合平台]

#### adUnionType [#aduniontype]

* 取值：`topon`
* 说明：固定值，标识使用 TopOn 聚合

#### adPlacementId [#adplacementid]

* 获取位置：聚合管理 → 广告位

<img src="__img0" />

#### adSourceId [#adsourceid]

* 获取目标：TopOn 自动生成的广告源 ID
* 获取路径：聚合管理 → 广告列表 → 选择对应广告源

<img src="__img1" />

#### ecpm 获取 [#ecpm-获取]

* 获取方式：通过 TopOn 官方文档里的 `getEcpm` 方法获取
* 文档链接：[TopOn官方文档-回调信息说明](https://newdocs.toponad.com/docs/JSLSJN#b4fab5bf735318c7589a94b4528f00e3)

### 2. Gromore（穿山甲聚合） [#2-gromore穿山甲聚合]

#### adUnionType [#aduniontype-1]

* 取值：`gromore`
* 说明：固定值，标识使用 Gromore 聚合

#### adPlacementId [#adplacementid-1]

* 获取位置：穿山甲聚合平台 → 瀑布流管理 → 广告位 ID

<img src="__img2" />

#### adSourceId [#adsourceid-1]

* 获取目标：瀑布流管理中的代码位 ID
* 获取路径：穿山甲聚合平台 → 瀑布流管理 → 代码位 ID

<img src="__img3" />

#### ecpm 获取 [#ecpm-获取-1]

* 获取方式：通过 Gromore 官方文档里的 `getEcpm` 方法获取
* 文档链接：[Gromore官方文档](https://www.csjplatform.com/union/media/union/download/detail?id=195\&docId=27617\&locale=zh-CN\&osType=android)

### 3. Tobid 聚合平台 [#3-tobid-聚合平台]

#### adUnionType [#aduniontype-2]

* 取值：`tobid`
* 说明：固定值，标识使用 Tobid 聚合

#### adPlacementId [#adplacementid-2]

* 获取路径：Tobid 聚合平台 → 聚合管理 → 流量管理 → 广告位 ID

<img src="__img4" />

#### adSourceId [#adsourceid-2]

* 获取目标：瀑布流管理中的广告源 ID
* 获取路径：Tobid 聚合平台 → 聚合管理 → 瀑布流管理 → 广告源 ID

<img src="__img5" />

#### ecpm 获取 [#ecpm-获取-2]

* 获取方式：通过 Tobid 官方文档的广告回调接口获取的 `AdInfo` 对象获取
* 文档链接：[Tobid官方文档-AdInfo回调信息说明](https://doc.sigmob.com/ToBid%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/SDK%E9%9B%86%E6%88%90%E8%AF%B4%E6%98%8E/iOS/%E9%AB%98%E7%BA%A7%E8%AE%BE%E7%BD%AE/%E5%B9%BF%E5%91%8A%E5%AF%B9%E8%B1%A1/)

### 4. 自建聚合平台 [#4-自建聚合平台]

#### adUnionType [#aduniontype-3]

* 取值：`self`
* 说明：标识使用自建聚合系统

#### adPlacementId [#adplacementid-3]

* 获取方式：自行从自建后台获取

#### adSourceId [#adsourceid-3]

* 获取方式：自行从自建后台获取

#### ecpm 获取 [#ecpm-获取-3]

* 实现方式：自行联系自建后台后端开发

### 5. 腾讯广告联盟（优量汇） [#5-腾讯广告联盟优量汇]

#### adSourceId [#adsourceid-4]

* 获取方式：广告位 ID
* 获取位置：优量汇后台 → 广告位管理

#### ecpm 支持 [#ecpm-支持]

* 状态：不支持获取 eCPM
* 备注：该平台不提供 eCPM 获取接口

### 6. 快手广告联盟 [#6-快手广告联盟]

#### adSourceId [#adsourceid-5]

* 获取方式：广告位 ID
* 获取位置：快手联盟后台 → 广告位管理

#### ecpm 支持 [#ecpm-支持-1]

* 状态：不支持获取 eCPM
* 备注：该平台不提供 eCPM 获取接口

### 7. 百度广告联盟（百青藤） [#7-百度广告联盟百青藤]

#### adSourceId [#adsourceid-6]

* 获取方式：广告位 ID
* 获取位置：百青藤后台 → 广告位管理

#### ecpm 支持 [#ecpm-支持-2]

* 状态：不支持获取 eCPM
* 备注：该平台不提供 eCPM 获取接口

### 8. Mintegral [#8-mintegral]

#### adSourceId [#adsourceid-7]

* 获取方式：广告位 ID
* 获取位置：Mintegral 后台 → 广告位管理

#### ecpm 支持 [#ecpm-支持-3]

* 状态：不支持获取 eCPM
* 备注：该平台不提供 eCPM 获取接口

### 9. OPPO 广告联盟 [#9-oppo-广告联盟]

#### adSourceId [#adsourceid-8]

* 获取方式：广告位 ID
* 获取位置：OPPO 广告联盟后台 → 广告位管理

#### ecpm 支持 [#ecpm-支持-4]

* 状态：白名单支持获取 eCPM
* 备注：需要申请白名单权限后才能获取 eCPM 数据

### 10. 其他平台 [#10-其他平台]

#### adSourceId [#adsourceid-9]

* 获取方式：广告位 ID
* 获取位置：对应平台后台管理界面
* 备注：各平台界面差异较大，需根据具体平台确定

#### ecpm 支持 [#ecpm-支持-5]

* 状态：依具体平台而定
* 备注：需要查询具体平台的 API 文档确认支持情况

## 注意事项 [#注意事项]

1. **必填字段**：`adType` 为必填字段，必须准确填写广告类型
2. **eCPM 统计**：强烈建议填写 `ecpm` 字段，否则无法统计用户 eCPM 数据
3. **平台差异**：不同平台的字段获取方式和命名存在差异，需要仔细区分
4. **权限要求**：部分平台（如 OPPO）的 eCPM 获取需要特殊权限或白名单
5. **更新维护**：各平台接口可能更新，请定期查看官方文档更新信息

## 附录 [#附录]

### 字段取值枚举说明 [#字段取值枚举说明]

#### adType 枚举值 [#adtype-枚举值]

* `reward`：激励视频广告
* `banner`：横幅广告
* `native`：信息流广告
* `interstitial`：插屏广告
* `splash`：开屏广告

#### adnType 枚举值 [#adntype-枚举值]

* `csj`：穿山甲平台
* `gdt`：优量汇平台
* `ks`：快手联盟
* `mint`：Mintegral 平台
* `baidu`：百度联盟
* `other`：其他平台

#### adUnionType 枚举值 [#aduniontype-枚举值]

* `topon`：TopOn 聚合
* `gromore`：Gromore 聚合
* `tobid`：Tobid 聚合
* `self`：自建聚合