广告聚合平台字段配置说明

文档概述

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

字段说明表

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

---

各平台字段获取详细说明

1. TopOn聚合平台

adUnionType

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

adPlacementId

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

adSourceId

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

ecpm获取

• 获取方式：通过TopOn官方文档里的 getEcpm 方法获取
• 文档链接：TopOn官方文档-回调信息说明

---

2. Gromore（穿山甲聚合）

adUnionType

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

adPlacementId

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

adSourceId

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

ecpm获取

• 获取方式：通过Gromore官方文档里的 getEcpm 方法获取
• 文档链接：Gromore官方文档

---

---

4. 自建聚合平台

adUnionType

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

adPlacementId

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

adSourceId

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

ecpm获取

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

---

5. 巨量广告联盟（穿山甲）

adSourceId

• 获取方式：广告位ID
• 获取位置：穿山甲后台 → 广告位管理

ecpm支持

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

---

6. 腾讯广告联盟（优量汇）

adSourceId

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

ecpm支持

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

---

7. 快手广告联盟

adSourceId

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

ecpm支持

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

---

8. 百度广告联盟（百青藤）

adSourceId

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

ecpm支持

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

---

9. Mintegral

adSourceId

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

ecpm支持

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

---

10. OPPO广告联盟

adSourceId

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

ecpm支持

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

---

11. 其他平台

adSourceId

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

ecpm支持

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

注意事项

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

附录

字段取值枚举说明

adType枚举值

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

adnType枚举值

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

adUnionType枚举值

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