腾讯社交联盟广告

Bidding Android iOS 快应用 SDK H5 SDK Media API 常见问题

腾讯优量汇 Media API 接入文档

Version: 1.1.46

法律声明

对需要对接腾讯优量汇(以下简称优量汇)Media API的客户,优量汇提供此文档作为对接的指引文档。未经优量汇书面许可,不得以任何形式向第三方披露、泄露有关本文档的任何内容。优量汇拥有修改、调整、增补本文档的权利,并在法律允许范围内对本文档拥有最终解释权。

版本管理

本API文档目前统一为1.1.46版本,所有接口于2020年9月11日统一升级为1.1版本,其中,

更新日志

版本 更新日期 更新说明
1.1.46 2024年3月6日 JS、SDK接入激励广告场景下的广告位,支持设置自定义奖励信息
1.1.45 2024年2月29日 SDK接入沉浸式视频流支持优量汇渲染
1.1.44 2023年11月30日 快应用SDK(QuickAppSDK)支持创建开屏(FLASH)广告位
1.1.43 2023年10月13日 1.开屏场景下不再支持创建V+(FLASH_V_PLUS)广告位
2.开屏场景下不再支持奖励式开屏(is_open_rewarded='Open')
1.1.42 2023年10月9日 彻底删除广告位时,如果该广告位已经绑定流量包,则会自动解绑
1.1.41 2023年8月31日 广告位接入方式新增快应用SDK(QuickAppSDK)
1.1.40 2023年8月22日 新增接口:4.2.5 彻底删除媒体
1.1.39 2023年6月25日 媒体模块创建和更新媒体调整资质信息
1.1.38 2023年5月25日 1.插屏全屏广告位修改时支持修改素材类型
2.修改插屏全屏广告位模板版本生成规则:模版版本修改为2.0
1.1.37 2023年3月27日 媒体模块增加RTB相关扩展信息的写入和读取
1.1.36 2023年3月15日 增加RTB接入诊断报表接口
1.1.35 2023年2月10日 下线物理广告位(physical_placement)相关接口和字段
1.1.34 2022年12月27日 广告位设置目标价不再需要开通白名单,不再支持设置自定义底价
1.1.33 2022年11月21日 1. 开屏将开屏广告样式更新为图片、5秒视频,开屏V+更新为5~30秒长视频+首屏续播、图片、5秒视频并支持修改
2. 激励广告、插屏全屏、横幅广告/信息流/详情页/贴片/沉浸式视频流自渲染支持修改
1.1.32 2022年8月29日 天级报表接口接口支持分页查询
1.1.31 2022年8月8日 增加物理广告位管理相关接口
1.1.30 2022年6月1日 新增小时级数据查询接口
1.1.29 2022年4月20日 SDK/API接入信息流广告位新增支持20:3图片
1.1.28 2022年4月18日 设置实时竞价广告位不再受收入门槛限制。
报表接口支持bidding相关指标的查询。
1.1.27 2022年4月14日 新增RTB流量天级对账通路上报通路,详见4.8
1.1.26 2022年4月6日 创建和修改媒体废弃“游戏变现类型(profit_mode)”字段
1.1.25 2022年4月2日 平台升级了下列指标口径:广告位请求量、广告请求量、广告位填充率、广告填充率。
本次更新不会变更收入相关数据。
1.1.24 2022年3月21日 新增数据保护协议签署状态的校验
1.1.23 2022年3月16日 支持创建聚合广告位
1.1.22 2022年2月24日 新增实时竞价配置
1.1.21 2022年2月21日 创建修改广告位接口废弃filter_rule
1.1.20 2021年12月23日 1. 新增二级广告场景“沉浸式视频流广告”
2. 插屏广告-全屏-视频,支持奖励发放机制
3. 插屏广告-优量汇渲染-模板2.0,半屏新增支持弹窗比例1:1 &“广告样式多样性探索”
4. 开发者自渲染,针对5个广告场景(横幅广告、信息流广告、详情页插入广告、视频贴片广告、沉浸式视频流广告),支持素材类型&素材规格的扩充
5. 媒体、广告位新增数量配置约束
1.1.19 2021年12月15日 新增媒体删除、广告位冻结接口
1.1.18 2021年12月10日 新增合规承诺函签署状态的校验
1.1.17 2021年11月15日 新增媒体审核拒绝原因
1.1.16 2021年11月2日 支持广告场景维度的变现数据
1.1.15 2021年10月11日 1. 全新定义7个广告场景
2. 7个广告场景下细分三级场景点
3. 简化渲染方式
4. 创建广告位支持插屏广告全屏图片
5. 广告位创建编辑名称最长支持60字符
1.1.14 2021年9月17日 1. 针对SDK接入方式的流量,面向部分场景(信息流广告、详情页插入广告、视频贴片广告、插屏广告半屏)支持平台模板渲染2.0,模板2.0支持广告样式多选,部分场景(信息流广告、详情页插入广告、视频贴片广告)支持“广告样式多样性”开关;模板2.0兼容历史创建的模板广告位。
2.广告位列表接口新增模板版本字段,模板版本值由系统根据创建广告位时选择的广告场景、广告样式等参数生成,不支持开发者自主选择。
1.1.13 2021年8月3日 1. 创建和更新媒体添加新三级行业分类字段(industry_id_v2), 老字段(industry_id)即将废弃
2.创建和更新媒体增加"游戏变现类型(profit_mode)"字段
1.1.12 2021年8月3日 1. 新增广告位暂停接口
2. 新增广告位启动接口
3. 新增测试媒体
4. 新增测试广告位
1.1.11 2021年7月28日 1. 新增广告位删除接口
2. 新增广告位解冻接口
1.1.10 2021年4月26日 1. 调整开屏广告位创建流程,全部接入方式媒体开屏广告可勾选支持视频素材,sdk接入方式媒体支持创建开屏V+广告样式
2. 开屏广告样式枚举值(flash_crt_type)下线FLASH_ERECT、FLASH_JOINT,新增FLASH、FLASH_V_PLUS
1.1.9 2021年3月31日 1. 媒体下线keywords、description参数
2. 废弃参数download_confirm(下载二次确认);新增参数 download_land_page(App广告跳落地页确认)
1.1.8 2021年2月25日 1. 新增查询美元汇率接口
2. 广告位支持价格策略设置
3. 激励视频支持设置服务器端校验
1.1.7 2020年12月21日 查询报表接口增加美元汇率以及ecpm、revenue、cpc美元折算价
1.1.6 2020年12月3日 1. 新增媒体查询接口
2. 新增广告位查询接口
1.1.5 2020年11月16日 1. 报表查询支持最大可查询30天数据;支持多阶价报表分层标签纬度数据
2. 查询报表接口:增加Content-Type格式要求为application/json;不再支持multipart/form-data格式
1.1.4 2020年9月11日 媒体创建和修改接口、报表接口、图片接口均升级到1.1版本
1.1.3 2020年7月15日 1. 广告场景替代广告位类型
2. 广告位创建和修改接口版本号升级到1.1
3. 广告位截图使用单独图片上传接口,并将返回的图片Id作为标识用于广告位创建接口和修改接口
4. 广告位创建接口和修改接口请求body改成json,接口协议字段重新规划命名
1.1.2 2020年6月16日 修复了报表接口填充率计算,新增两个返回字段
1.1.1 2020年6月4日 统一使用app_id作为媒体id的唯一标识;明确RTB对接时创建广告位细分场景
1.0 2020年3月27日 提供媒体、广告位创建功能;报表查看功能

重要知会

1.1.33版本变更关键点

1.1.31版本变更关键点

1.1.30版本变更关键点

1.1.28版本变更关键点

1.1.25版本变更关键点

1.1.24版本变更关键点

1.1.22版本变更关键点

1.1.20版本变更关键点

1.1.18版本变更关键点

1.1.15版本变更关键点

1.1.14版本变更关键点

1.1.12版本变更关键点

1.1.5版本变更关键点

1.1.3版本变更关键点

1.1.1版本变更关键点

1. 关于文档

流量主可以通过对接Media API拥有强大的系统管理能力,更便捷地进行流量管理及快速对接广告统计数据,帮助流量主提升流量变现效率。
Media API提供的功能包含以下部分:

2. 背景知识

2.1 术语介绍

2.2 模块介绍

本节对Media API的各个模块分别做简单介绍,以便对接人员快速了解每个模块的大致功能。
根据接口功能不同,系统可分为媒体模块、广告位模块 、报表模块3类。各模块功能简介如下:

2.3 技术准备

本API文档所涉及接口均遵循HTTP协议。
调用方应根据具体接口的要求设置 HTTP Method为 GET或POST。
您可以使用任何支持HTTP协议和JSON格式的编程语言开发应用程序。

有关标准HTTP协议,可参考 RFC2616 或 维基百科-HTTP 相关介绍。
有关JSON数据格式,可参考 JSON.ORG 或 维基百科?JSON 相关介绍。

3. 对接流程

第1步,开通Media API权限:
    请按以下格式发送邮件到 ADNET@tencent.com 获取授权及密钥:
    邮件主题:Media API开通申请
    邮件内容:开发者名称、会员ID、申请原因
   (我们会在1-2个工作日内核对您的申请,请您后续在优量汇“开发者平台?接入中心?Media API接入?我的密钥”查看您的密钥信息)
第2步,开发对接:对接过程中如果遇到疑问,可联系运营接口人进行相关的产品和技术答疑;
第3步,测试联调:在开发完成,开发者部署好服务器后,优量汇可支持开发者进行测试联调,测试环境使用公共账号和密钥联调;
第4步,正式环境上线:测试联调通过后,向运营接口人申请线上正式环境密钥,并上线。

4. 接口详述

4.1 通用声明

4.1.1 权限认证

Media API 通过授权令牌(TOKEN)进行权限控制。TOKEN需要在每次请求时通过Header中 token 字段来传递,提供测试域名:test-api.adnet.qq.com;测试memberid:608070200058;secret:M#z_:cS7ME.^*;_Abi;r/32n!D}>9JVx。

4.1.2 编码方式

若无特殊说明或响应头中的Content-Type未指定编码,请求和响应中的字符编码均使用 UTF-8(无 BOM 头)。

4.1.3 URL定义

请求URL参考RESTful风格,约定了使用的协议、域名、模块、版本、资源及动作,详细定义如下:
https://api.adnet.qq.com/open/API_VERSION/RESOURCE_NAME/RESOURCE_ACTION
其中:
协议:必须使用HTTPS
API_VERSION:版本号,当前版本号码为 v1
RESOURCE_NAME:表示要操作的资源,如medium、placement
RESOURCE_ACTION:表示对资源的动作,如add、update
RESOURCE_NAME目前支持如下资源:

资源 描述
medium 媒体模块
placement 广告位模块
report 报表模块

RESOURCE_ACTION目前支持如下基本动作:

动作 描述
add 新增
update 更新
get 读取

4.1.4 通用参数

以下是每个接口都会用到的通用参数,详细定义为:

名称 类型 必填 限制 描述
token string 有效期20分钟,失效后需要重新生成 授权令牌,由调用方自行生成

通用参数并不在API请求的body中,而是放在请求头传输,例:curl --location --request POST 'https://test-api.adnet.qq.com/open/v1.1/medium/add' --header 'token:cnRiLDE1ODQ0MzU0MTYsN2MwNWFlMjhlNDM1ZGYwOWM5MmY2MjkxMjEwMGM3ZTQ4NmU1MzgxNQ==' token是合作伙伴重要的身份标识,优量汇会对 token的使用进行校验,请妥善保管好优量汇接口人提供的生成token的关键信息和 token生成算法,防止泄露。一旦发现token泄露,请立即联系优量汇接口人报备处理。
token 生成规则如下:
token = base64('memberid','time','sign');
其中:
memberid:账户ID,由开发者在优量汇开发者平台( https://e.qq.com/dev/index.html )注册获得;
time:发起请求时的unix时间戳(精确到秒),此值跟接收到请求时的服务器时间戳值偏差(正负), 超过1200秒(20分钟)时,请求会被忽略,要求调用方重新组合token(请使用 Asia/Shanghai时区);
sign: 签名字符串,sign = sha1(memberid. secret. time),secret为约定的私钥, 合作伙伴申请 API接口时,由优量汇提供,sign是在时间戳的基础上进行加密的,当时间戳超过系统设定时间间隔之后,请求会被拒绝,要求调用方重新组合 token,加密算法可采用 sha1。
以上参数中,memberid、secret 这两个参数是优量汇生成token的关键参数,请联系优量汇接口人获取secret。
下面举例说明如何生成token(python2语言为例)。
假设生成 token的各个参数取如下数值:
memberid:12345
secret:032742947398^*
生成token代码:

import hashlib
import base64
import time
memberid="12345"
secret="032742947398^*"
timestamp=int(time.time())  //时间戳,精确到秒
sign = hashlib.sha1( memberid + secret + str(timestamp) ).hexdigest()
list_v = [memberid, str(timestamp), sign]
plain = ','.join(list_v)
token = base64.b64encode(plain)
print token

这样,我们就生成了本次API请求的token了。

4.1.5 API请求

4.1.6 API响应

支持HTTP标准状态码,具体如下:

状态码 名称 描述
200 成功 当 API 请求被正确处理,且能按设计获取结果时,返回该状态码;
亦适用于批量接口返回部分结果
3xx 跳转 在特定情况下,API 可能会返回这些状态码;
建议调用方按照 HTTP 标准来处理
4xx 客户端错误 由客户端原因造成的错误
5xx 服务器端错误 API 或其下层服务发生内部错误

其中,4xx 和 5xx 的状态码仅用于辅助调用方快速识别问题,不作为包含实际语义的错误码,若有调整也不另行通知,实际操作结果以API返回的数据为准。调用方也应能够识别和处理由于网络异常等因素导致的,由非API 服务返回的 HTTP 状态码,如 504 Gateway Timeout 等。

目前API响应的Content-Type为application/json。

响应的JSON数据中包含三部分内容,分别为返回码、返回信息和数据,如下表所示:

名称 类型 必填 描述
code int32 返回码:0表示成功
message string 返回信息:若有错误,此字段为详细的错误信息
data json array 或 json object 结果数据

4.2 媒体模块

规则说明:

  1. 创建修改媒体,以app_id作为媒体id的唯一识别
  2. 只有审核通过的媒体才可以修改
  3. 每个开发者最多可创建300个正式媒体

4.2.1 创建媒体

请求URL:https://api.adnet.qq.com/open/v1.1/medium/add

请求方法:POST

Content-Type:multipart/form-data

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 会员ID 必填
medium_name string 媒体名字 必填
industry_id int32 媒体所属2级行业id,参见附录2 非必填(即将废弃)
industry_id_v2 int32 媒体所属新3级行业id,参见附录9 非必填(和industry_id不能同时为空)
os int32 操作系统,数字含义1-Android, 2-iOS, 3-H5 必填
detail_url string 详情页url 支持的各个商店域名约束 当OS不为H5时必填
affiliation string 媒体隶属关系 详见附录7 必填
package_name string 主程序包名 符合包名规范 当OS不为H5时必填,广告请求时只校验主程序包名,其他渠道可不必重复创建媒体
full_package_name string 完整的程序包名 符合包名规范 当OS为Android时必填
wechat_app_id string 微信开放平台AppId 当OS为iOS时非必填
package_name_wx_appid_rel string 包名和wx appid对应关系 json字符串,例如:{"com.xx.xx":"wx9b1xxx3449f","com.xx.xx.xx":"wx9b1xxx3xxx9x"} 当OS为Android时选填
wechat_universal_link string 微信开放平台Universal link 非必填,IOS媒体可用,如果填写wechat_app_id,字段必填
domain string 网站域名 当OS为H5时必填
icp string 网站备案号 当OS为H5时必填
icp_picture file 网站备案截图(待废弃) 当OS为H5时,icp_picture和icp_pictrue_id 两者不能同时为空
icp_picture_img_id int64 icp备案图片ID 当OS为H5时,icp_picture和icp_pictrue_id 两者不能同时为空
soft_right_img_id int64 软件著作权证明图片ID 通过image/upload接口上传图片,获取图片ID 非必填
company_ship_img_id int64 公司关联关系证明图片ID 通过image/upload接口上传图片,获取图片ID 关系类型为与开发者存在主体关系时:选择合作应用商店非必填;应用商店-其他或者包名不唯一必填
biz_right_img_id int64 发行或代理证明图片ID 通过image/upload接口上传图片,获取图片ID 关系类型为代理/发行方时:选择合作应用商店非必填;应用商店-其他或者包名不唯一必填
game_isbn_img_id int64 游戏版号图片ID 通过image/upload接口上传图片,获取图片ID 非必填
brand_img_id int64 商标图片ID 通过image/upload接口上传图片,获取图片ID 非必填
publisher_agree_img_id int64 发行协议图片ID(待废弃) 通过image/upload接口上传图片,获取图片ID 非必填
app_market_img_id int64 应用市场截图图片ID 通过image/upload接口上传图片,获取图片ID 非必填
ad_cooperation_img_id int64 广告合作承诺函图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他并媒体一级行业为棋牌类时或者应用商店-其他并媒体一级行业为棋牌类时出现包名不唯一
play_mod_setup_img_id int64 玩法说明启动页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_cover_img_id int64 玩法说明首页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_detail_img_id int64 玩法说明详情页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_desc string 玩法说明描述 在传入play_mod_detail_img_id时必填 应用商店-其他或者应用商店-其他出现包名不唯一都必填
market_icp string 应用下载网站备案许可证号 应用商店-其他都非必填,资质审核为准(建议上传)
market_icp_img_id int64 应用下载网站备案截图ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
market_company_ship_img_id int64 会员与应用下载网站主体关系证明图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
market_biz_right_img_id int64 会员与应用下载网站代理协议图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
apk_file_name string 上传apk文件名 在支持上传apk文件的时候传入 非必填
medium_test_status enum 媒体测试状态 取值范围参见媒体测试状态 非必填,默认为Formal
media_download_number int64 媒体在厂商应用市场的月累计安装量 快应用媒体表示厂商渠道的月累计打开量 非必填
media_added_time string 媒体在厂商应用市场上架时间 格式为yyyyMMdd 非必填
media_account_name string 媒体在厂商渠道注册的账户名称 非必填
media_rate_number int64 媒体在厂商应用市场累计评价数 非必填
media_store_score string 媒体在厂商应用市场评分 非必填
media_pull_mode enum 媒体在厂商渠道接入方式 取值范围参见媒体在厂商渠道接入方式 非必填
is_quick_app boolean 是否快应用 非必填

资质特殊说明:选择合作应用商店非必填,应用商店-其他(不是常见应用市场上架)或者包名不唯一必填,可以选择四个中的其中一个上传。

参数名称 资质类型
app_market_img_id 应用商店-媒体详情页“开发商”主体截图
soft_right_img_id 计算机软件著作权登记证书
game_isbn_img_id 国家新闻出版广电总局批准的版号证明
brand_img_id 商标图片

应答字段:

名称 类型 描述
app_id int64 媒体id

请求示例:

curl --location --request POST 'https://test-api.adnet.qq.com/open/v1.1/medium/add' \
--header 'token: cnRiLDE1ODQzNzc0MTcsZDVjNjIzNWRkZTY1MTFmMGJmMWQyNzlkMTE0ZjI3M2ZmYzgyMGIxMA==' \
--header 'Content-Type: multipart/form-data' \
--form 'member_id=2763558177' \
--form 'medium_name=腾讯视频' \
--form 'icp_picture=@/Users/Desktop/WechatIMG197.jpeg' \
--fom 'os=1' \
--form 'industry_id_v2=2000402' \
--form 'detail_url=https://android.myapp.com/test' \
--form 'affiliation=Own' \
--form 'soft_right_img_id=1' \
--form 'biz_right_img_id=2'  \
--form 'package_name=com.tencent.live' \
--form 'package_name_wx_appid_rel="{\"com.xx.xx\":\"wx9b1xxx3449f\",\"com.xx.xx.xx\":\"wx9b1xxx3xxx9x\"}"' \
--form 'full_package_name=com.tencent.live' \
--form 'media_download_number=1234' \
--form 'media_added_time=20230301' \
--form 'media_account_name=testName' \
--form 'media_rate_number=4561' \
--form 'media_store_score=4.8' \
--form 'media_pull_mode=SDK' \
--form 'is_quick_app=false'

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "app_id": 1110525172
    }
}

4.2.2 修改媒体

请求URL:https://api.adnet.qq.com/open/v1.1/medium/update

请求方法:POST

Content-Type:multipart/form-data

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
app_id int64 媒体id 根据创建接口返回的app_id指定需要修改的媒体id 必填
medium_name string 64个字以内;媒体名字在同一个会员同一个操作系统下是唯一的,不能重复 非必填
industry_id int32 媒体所属2级行业id,参见附录2 非必填(即将废弃)
industry_id_v2 int32 媒体所属新3级行业id,参见附录9 非必填(和industry_id不能同时为空)
affiliation string 媒体隶属关系 详见附录7 必填
package_name string 主程序包名 符合包名规范 当OS不为H5时必填,广告请求时只校验主程序包名,其他渠道可不必重复创建媒体
full_package_name string 完整的程序包名 符合包名规范 当OS为Android时必填
wechat_app_id string 微信开放平台AppId 当OS为iOS非必填
wechat_universal_link string 微信开放平台Universal link 非必填,IOS媒体可用,如果填写wechat_app_id,字段必填
detail_url string 详情页url 支持的各个商店域名约束,必须为商店名录重的地址类型 当OS不为H5时必填
package_name_wx_appid_rel string 包名和wx appid对应关系 json字符串,例如:{"com.xx.xx":"wx9b1xxx3449f","com.xx.xx.xx":"wx9b1xxx3xxx9x"} 当OS为Android时选填
icp string 网站备案号 当OS为H5时必填
icp_picture_img_id int64 icp备案图片ID 当OS为H5时,icp_picture和icp_pictrue_id 两者不能同时为空
soft_right_img_id int64 软件著作权证明图片ID 通过image/upload接口上传图片,获取图片ID 非必填,不填或填0时为清空该字段
company_ship_img_id int64 公司关联关系证明图片ID 通过image/upload接口上传图片,获取图片ID 关系类型为与开发者存在主体关系时:选择合作应用商店非必填;应用商店-其他或者包名不唯一必填
biz_right_img_id int64 发行或代理证明图片ID 通过image/upload接口上传图片,获取图片ID 关系类型为代理/发行方时:选择合作应用商店非必填;应用商店-其他或者包名不唯一必填
game_isbn_img_id int64 游戏版号图片ID 通过image/upload接口上传图片,获取图片ID 非必填
brand_img_id int64 商标图片ID 通过image/upload接口上传图片,获取图片ID 非必填
publisher_agree_img_id int64 发行协议图片ID(待废弃) 通过image/upload接口上传图片,获取图片ID 非必填
app_market_img_id int64 应用市场截图图片ID 通过image/upload接口上传图片,获取图片ID 非必填
ad_cooperation_img_id int64 广告合作承诺函图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他并媒体一级行业为棋牌类时或者应用商店-其他并媒体一级行业为棋牌类时出现包名不唯一
play_mod_setup_img_id int64 玩法说明启动页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_cover_img_id int64 玩法说明首页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_detail_img_id int64 玩法说明详情页图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他或者应用商店-其他出现包名不唯一都必填
play_mod_desc string 玩法说明描述 在传入play_mod_detail_img_id时必填 应用商店-其他或者应用商店-其他出现包名不唯一都必填
market_icp string 应用下载网站备案许可证号 应用商店-其他都非必填,资质审核为准(建议上传)
market_icp_img_id int64 应用下载网站备案截图ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
market_company_ship_img_id int64 会员与应用下载网站主体关系证明图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
market_biz_right_img_id int64 会员与应用下载网站代理协议图片ID 通过image/upload接口上传图片,获取图片ID 应用商店-其他都非必填,资质审核为准(建议上传)
apk_file_name string 上传apk文件名 在支持上传apk文件的时候传入 非必填
convert_to_formal boolean 是否将测试媒体转为正式 false-不转正式,true-转为正式 非必填,默认为false
media_download_number int64 媒体在厂商应用市场的月累计安装量 快应用媒体表示厂商渠道的月累计打开量 非必填
media_added_time string 媒体在厂商应用市场上架时间 格式为yyyyMMdd 非必填(厂商必填)
media_account_name string 媒体在厂商渠道注册的账户名称 非必填(厂商必填)
media_rate_number int64 媒体在厂商应用市场累计评价数 非必填(厂商必填)
media_store_score string 媒体在厂商应用市场评分 非必填(厂商必填)
media_pull_mode enum 媒体在厂商渠道接入方式 取值范围参见媒体在厂商渠道接入方式 非必填(厂商必填)
is_quick_app boolean 是否快应用 非必填(厂商必填)

资质特殊说明:选择合作应用商店非必填,应用商店-其他(不是常见应用市场上架)或者包名不唯一必填,可以选择四个中的其中一个上传。

参数名称 资质类型
app_market_img_id 应用商店-媒体详情页“开发商”主体截图
soft_right_img_id 计算机软件著作权登记证书
game_isbn_img_id 国家新闻出版广电总局批准的版号证明
brand_img_id 商标图片

应答字段:

名称 类型 描述
code int32 返回码:
0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl --location --request POST 'https://api.adnet.qq.com/open/v1.1/medium/update' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
--form 'member_id=2763558177' \
--form 'industry_id_v2=2000402' \
--form 'detail_url=https://android.myapp.com/test' \
--form 'package_name=com.tencent.live' \
--form 'package_name_wx_appid_rel="{\"com.xx.xx\":\"wx9b1xxx3449f\",\"com.xx.xx.xx\":\"wx9b1xxx3xxx9x\"}"' \
--form 'full_package_name=com.tencent.live' \
--form 'affiliation=Agency' \
--form 'app_id=1110525172' \
--form 'media_download_number=1234' \
--form 'media_added_time=20230301' \
--form 'media_account_name=testName' \
--form 'media_rate_number=4561' \
--form 'media_store_score=4.8' \
--form 'media_pull_mode=SDK' \
--form 'is_quick_app=false'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.2.3 获取媒体

请求URL:https://api.adnet.qq.com/open/v1.1/medium/list

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
filtering struct[] 过滤条件 过滤结构参数限制如下 选填,若此字段不传或传空,则视为无限制条件
- field string 过滤字段 可选值:app_id、medium_name、os、status、industry_id_v2、medium_test_status
- operator enum 操作符 - 当field取值app_id时,枚举列表:{EQUALS, IN}
- 当field取值medium_name时,枚举列表:{CONTAINS}
- 当field取值os时,枚举列表:{EQUALS, IN}
- 当field取值status时,枚举列表:{EQUALS}
- 当field取值industry_id_v2时,枚举列表:{EQUALS}
- 当field取值medium_test_status时,枚举列表:{EQUALS}
- values string[] 字段取值 field 对应字段的实际数值
page int32 搜索页码 默认值:1 选填
page_size int32 每页显示的数据条数 默认值:20,最大值 100 选填

应答字段:

名称 类型 描述
list struct[] 返回媒体列表,结构如下
- app_id int64 媒体id
- medium_name string 媒体名字
- status enum 媒体状态
- industry_id int32 媒体所属2级行业id
- industry_id_v2 int32 媒体所属新3级行业id
- os int32 操作系统
- detail_url string 详情页url(非H5媒体有效)
- affiliation enum 媒体隶属关系
- package_name string 主程序包名(非H5媒体有效)
- full_package_name string 完整的程序包名(非H5媒体有效)
- wechat_app_id string 微信开放平台AppId(非H5媒体有效)
- wechat_universal_link string 微信开放平台Universal link(IOS媒体)
- domain string 网站域名(H5媒体有效)
- icp string 网站备案(H5媒体有效)
- soft_right_img_id int64 软件著作权证明图片ID
- soft_right_img_status int64 软件著作权证明图片审核状态,取值范围参见媒体资质信息审核状态
- company_ship_img_id int64 公司关联关系证明图片ID
- company_ship_img_status int64 公司关联关系证明图片审核状态,取值范围参见媒体资质信息审核状态
- biz_right_img_id int64 发行或代理证明图片ID
- biz_right_img_status int64 发行或代理证明图片审核状态,取值范围参见媒体资质信息审核状态
- game_isbn_img_id int64 游戏版号图片ID
- game_isbn_img_status int64 游戏版号图片审核状态,取值范围参见媒体资质信息审核状态
- brand_img_id int64 商标图片ID
- brand_img_status int64 商标图片审核状态,取值范围参见媒体资质信息审核状态
- publisher_agree_img_id int64 发行协议图片ID(待废弃)
- publisher_agree_img_status int64 发行协议图片审核状态(待废弃),取值范围参见媒体资质信息审核状态
- app_market_img_id int64 应用市场截图图片ID
- app_market_img_status int64 应用市场截图图片审核状态,取值范围参见媒体资质信息审核状态
- ad_cooperation_img_id int64 广告合作承诺函图片ID
- ad_cooperation_img_status int64 广告合作承诺函图片审核状态,取值范围参见媒体资质信息审核状态
- play_mod_setup_img_id int64 玩法说明启动页图片ID
- play_mod_setup_img_status string 玩法说明启动页图片审核状态,取值范围参见媒体资质信息审核状态
- play_mod_cover_img_id int64 玩法说明首页图片ID
- play_mod_cover_img_status string 玩法说明首页图片审核状态,取值范围参见媒体资质信息审核状态
- play_mod_detail_img_id int64 玩法说明详情页图片ID
- play_mod_detail_img_status string 玩法说明详情页图片审核状态,取值范围参见媒体资质信息审核状态
- play_mod_desc string 玩法说明描述
- market_icp string 应用下载网站备案许可证号
- market_icp_img_id int64 应用下载网站备案截图ID
- market_icp_img_status string 应用下载网站备案截图审核状态,取值范围参见媒体资质信息审核状态
- market_company_ship_img_id int64 会员与应用下载网站主体关系证明图片ID
- market_company_ship_img_status string 会员与应用下载网站主体关系证明审核状态,取值范围参见媒体资质信息审核状态
- market_biz_right_img_id int64 会员与应用下载网站代理协议图片ID
- market_biz_right_img_status string 会员与应用下载网站代理协议审核状态,取值范围参见媒体资质信息审核状态
- apk_file_name int64 apk文件名
- medium_test_status enum 媒体测试状态
- media_download_number int64 媒体在厂商应用市场的月累计安装量
- media_added_time string 媒体在厂商应用市场上架时间
- media_account_name string 媒体在厂商渠道注册的账户名称
- media_rate_number int64 媒体在厂商应用市场累计评价数
- media_store_score string 媒体在厂商应用市场评分
- media_pull_mode enum 媒体在厂商渠道接入方式,取值范围参见媒体在厂商渠道接入方式
- is_quick_app boolean 是否快应用
- offline_deadline string 媒体即将下线日期
- offline_reason string 媒体即将下线原因
- reject_reason string 审核拒绝原因
page_info struct[] 分页配置信息
- page int32 网站域名(H5媒体有效)
- page_size int32 每页显示的数据条数
- total_number int32 总条数
- total_page int32 总页数

应答示例:

{
    "code": 0,
    "message": "",
    "data": {
        "list": [
            {
                "app_id": 0,
                "medium_name": "abcdef",
                "industry_id": 0,
                "industry_id_v2": 0,
                "os": 0,
                "detail_url": "abcdef",
                "affiliation": "Unknown",
                "package_name": "abcdef",
                "full_package_name": "abcdef",
                "wechat_app_id": "abcdef",
                "wechat_universal_link": "abcdef",
                "domain": "abcdef",
                "icp": "abcdef",
                "soft_right_img_id": 0,
                "company_ship_img_id": 0,
                "biz_right_img_id": 0,
                "game_isbn_img_id": 0,
                "status": "NotSubmitted",
                "medium_test_status": "Formal",
                "reject_reason": "",
                "media_download_number": 1234,
                "media_added_time": "20230301",
                "media_account_name": "testName",
                "media_rate_number": 4561,
                "media_store_score": "4.3",
                "media_pull_mode": "SDK",
                "is_quick_app": false
            }
        ],
        "page_info": {
            "page": 0,
            "page_size": 0,
            "total_number": 0,
            "total_page": 0
        }
    }
}

4.2.4 获取单个媒体

请求URL:https://api.adnet.qq.com/open/v1.1/medium/get

请求方法:GET

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
app_id int64 媒体ID 必填

请求示例:

curl -X GET 'https://api.adnet.qq.com/open/v1.1/medium/get' -H 'token: {TOKEN}' -H 'Content-Type: application/json' -d '{"member_id":12345,"app_id":123}'

应答字段:

名称 类型 描述
member_id int64 开发者id
app_id int64 媒体id
medium_name string 媒体名字
review_status enum 媒体审核状态
industry_id int32 媒体所属2级行业id
industry_id_v2 int32 媒体所属新3级行业id
os int32 操作系统
detail_url string 详情页url(非H5媒体有效)
affiliation enum 媒体隶属关系
package_name string 主程序包名(非H5媒体有效)
full_package_name string 完整的程序包名(非H5媒体有效)
wechat_app_id string 微信开放平台AppId(非H5媒体有效)
wechat_universal_link string 微信开放平台Universal link(IOS媒体)
domain string 网站域名(H5媒体有效)
icp string 网站备案(H5媒体有效)
soft_right_img_id int64 软件著作权证明图片ID
soft_right_img_status int64 软件著作权证明图片审核状态,取值范围参见媒体资质信息审核状态
company_ship_img_id int64 公司关联关系证明图片ID
company_ship_img_status int64 公司关联关系证明图片审核状态,取值范围参见媒体资质信息审核状态
biz_right_img_id int64 发行或代理证明图片ID
biz_right_img_status int64 发行或代理证明图片审核状态,取值范围参见媒体资质信息审核状态
game_isbn_img_id int64 游戏版号图片ID
game_isbn_img_status int64 游戏版号图片审核状态,取值范围参见媒体资质信息审核状态
brand_img_id int64 商标图片ID
brand_img_status int64 商标图片审核状态,取值范围参见媒体资质信息审核状态
publisher_agree_img_id int64 发行协议图片ID(待废弃)
publisher_agree_img_status int64 发行协议图片审核状态(待废弃),取值范围参见媒体资质信息审核状态
app_market_img_id int64 应用市场截图图片ID
app_market_img_status int64 应用市场截图图片审核状态,取值范围参见媒体资质信息审核状态
ad_cooperation_img_id int64 广告合作承诺函图片ID
ad_cooperation_img_status int64 广告合作承诺函图片审核状态,取值范围参见媒体资质信息审核状态
play_mod_setup_img_id int64 玩法说明启动页图片ID
play_mod_setup_img_status string 玩法说明启动页图片审核状态,取值范围参见媒体资质信息审核状态
play_mod_cover_img_id int64 玩法说明首页图片ID
play_mod_cover_img_status string 玩法说明首页图片审核状态,取值范围参见媒体资质信息审核状态
play_mod_detail_img_id int64 玩法说明详情页图片ID
play_mod_detail_img_status string 玩法说明详情页图片审核状态,取值范围参见媒体资质信息审核状态
play_mod_desc string 玩法说明描述
market_icp string 应用下载网站备案许可证号
market_icp_img_id int64 应用下载网站备案截图ID
market_icp_img_status string 应用下载网站备案截图审核状态,取值范围参见媒体资质信息审核状态
market_company_ship_img_id int64 会员与应用下载网站主体关系证明图片ID
market_company_ship_img_status string 会员与应用下载网站主体关系证明审核状态,取值范围参见媒体资质信息审核状态
market_biz_right_img_id int64 会员与应用下载网站代理协议图片ID
market_biz_right_img_status string 会员与应用下载网站代理协议审核状态,取值范围参见媒体资质信息审核状态
apk_file_name int64 apk文件名
medium_test_status enum 媒体测试状态
media_download_number int64 媒体在厂商应用市场的月累计安装量
media_added_time string 媒体在厂商应用市场上架时间
media_account_name string 媒体在厂商渠道注册的账户名称
media_rate_number int64 媒体在厂商应用市场累计评价数
media_store_score string 媒体在厂商应用市场评分
media_pull_mode enum 媒体在厂商渠道接入方式,取值范围参见媒体在厂商渠道接入方式
is_quick_app boolean 是否快应用
offline_deadline string 媒体即将下线日期
offline_reason string 媒体即将下线原因
reject_reason string 审核拒绝原因

应答示例:

{
    "code":0,
    "data":{
        "member_id":123456,
        "app_id":12345,
        "medium_name":"",
        "industry_id":10,
        "industry_id_v2":7,
        "os":"1",
        "detail_url":"https://appgallery.huawei.com/app/123456",
        "affiliation":"Own",
        "package_name":"com.qq.aaa",
        "wechat_app_id":"",
        "wechat_universal_link":"",
        "domain":"",
        "icp":"",
        "icp_picture_img_id":0,
        "icp_picture_img_status":"",
        "soft_right_img_id":0,
        "soft_right_img_status":"",
        "company_ship_img_id":0,
        "company_ship_img_status":"",
        "biz_right_img_id":0,
        "biz_right_img_status":"",
        "game_isbn_img_id":0,
        "game_isbn_img_status":"",
        "brand_img_id":0,
        "brand_img_status":"",
        "publisher_agree_img_id":0,
        "publisher_agree_img_status":"",
        "app_market_img_id":0,
        "app_market_img_status":"",
        "ad_cooperation_img_id":0,
        "ad_cooperation_img_status":"",
        "play_mod_setup_img_id":0,
        "play_mod_setup_img_status":"",
        "play_mod_cover_img_id":0,
        "play_mod_cover_img_status":"",
        "play_mod_detail_img_id":0,
        "play_mod_detail_img_status":"",
        "market_icp":"",
        "market_icp_img_id":0,
        "market_icp_img_status":"",
        "market_company_ship_img_id":0,
        "market_company_ship_img_status":"",
        "market_biz_right_img_id":0,
        "market_biz_right_img_status":"",
        "play_mod_desc":"",
        "apk_file_name":"",
        "review_status":"Approved",
        "medium_test_status":"Formal",
        "filter_rule_id":40,
        "package_name_wx_appid_rel":"",
        "media_download_number":0,
        "media_added_time":"",
        "media_account_name":"",
        "media_rate_number":0,
        "media_store_score":"",
        "media_pull_mode":"",
        "is_quick_app":false
    },
    "message":"success"
}

4.2.5 删除媒体

请求URL:https://api.adnet.qq.com/open/v1.1/medium/delete

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
app_id int64 媒体id 根据创建接口返回的app_id指定需要修改的媒体id 必填

应答字段:

名称 类型 描述
code int32 返回码:
0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl --location --request POST 'https://api.adnet.qq.com/open/v1.1/medium/delete' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "app_id":1204567
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.2.6 彻底删除媒体

规则说明:

  1. 最近30天无消耗的媒体可以彻底删除。封禁、违规暂停的媒体不可删除。
  2. 删除后媒体下的符合彻底删除规则的广告位也会彻底删除。

请求URL:https://api.adnet.qq.com/open/v1.1/medium/complete_delete

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
app_id int64 媒体id 根据创建接口返回的app_id指定需要彻底删除的媒体id 必填

应答字段:

名称 类型 描述
code int32 返回码:
0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl --location --request POST 'https://api.adnet.qq.com/open/v1.1/medium/complete_delete' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "app_id":1204567
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3 广告位模块

规则说明:

  1. 每个媒体最多可创建250个广告位,开发者可通过冻结、删除接口释放限额

4.3.1 创建广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/add

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
app_id int64 媒体id 根据创建接口返回的app_id指定需要在哪个媒体下创建广告位 必填
placement_name string 广告位名字 最大60个字符(30个汉字或者60个英文字符);同一个媒体下广告位名字不能重复 必填
scene enum 广告场景 取值范围参见场景 非必填,不推荐使用;参数custom_position_scene_level3、scene必须存在且只能存在一个;H5媒体需联系运营经理开通激励广告的白名单权限
rewarded_video_scene enum 激励场景 取值范围参见激励场景 仅场景scene为激励广告时使用
rewarded_video_description string 激励广告场景点为其他时的描述 最大长度200 仅场景scene为激励广告时使用
placement_image_id int 广告位截图资源id,通过图片资源上传接口上传得到 资源必须属于当前会员 选填
ad_pull_mode enum 接入方式 取值范围参见接入方式 必填
render_type enum 渲染方式 取值范围参见渲染方式 非必填,场景为激励广告和开屏广告时可以不填
ad_crt_type_list enum[] 素材类型 取值参考素材类型 必填,模板渲染时,必填,模板渲染时,当素材仅支持一种素材类型时,默认为该类型,选择的素材类型必须要和素材支持的类型匹配
ad_crt_template_type enum[] 模板广告样式 取值范围参见模板类型 非必填,模板渲染时,当场景非激励广告和开屏广告时,模板渲染必填;模板2.0的部分场景支持多个模板类型,模板2.0生成规则模板版本生成规则;不支持自定义模板
ad_crt_normal_type int 自渲染广告样式 取值范围参见自渲染广告样式 逐步废弃,场景非激励广告和开屏时,自渲染必填
ad_crt_normal_types enum[] 自渲染广告样式 取值范围参见自渲染广告样式规格 非必填,场景非激励广告和开屏时,自渲染必填,可多选
flash_crt_type enum 开屏广告样式 取值范围参见开屏广告样式 非必填,仅场景scene为开屏广告时使用
rewarded_video_crt_type enum 激励广告广告样式 取值范围参见激励广告样式 非必填,仅场景scene为激励广告时使用
ad_feedback_element enum[] 广告返回元素 取值范围参考广告返回元素 非必填,原生自渲染可填,不填默认全选
filter_rule(已废弃) FilterRule Api不再支持过滤规则设置,请到开发者平台设置屏蔽规则 非必填
rtb_config RtbConfig 取值范围参见RTB绑定的OS RTB绑定时,使用优量汇协议非必填;使用开发者协议必填
need_server_verify enum 是否开启服务端校验,仅适用于接入方式为sdk的激励广告场景 取值范围参考服务端校验是否开启 非必填
transfer_url string 激励广告、插屏全屏视频 服务端校验回调地址 支持http和https协议地址 非必填,当设置need_server_verify为开启验证时该字段必填
secret string 激励广告服务端校验密钥 32位随机大小写字母和1-9数字组成 非必填,当设置need_server_verify为开启验证时该字段必填
price_strategy_type enum 广告位价格策略 取值范围参考价格策略 非必填
ecpm_price int64 广告位价格 单位:分 非必填,当价格策略设置为目标价(TargetPrice)时该字段必填
real_time_bidding_type enum 实时竞价类型 取值范围参考实时竞价类型 非必填,当价格策略设置为实时竞价(BiddingPrice)时该字段必填
placement_test_status enum 广告位测试状态 取值范围参见广告位测试状态 非必填,默认为Formal
enable_experiment enum 广告样式多样性探索 取值范围参见广告位开关类状态 非必填,默认为Open,模板2.0部分场景(FLOW、VIDEO_PASTE、FOCUS_POINT、INSERTION-半屏)支持当前开关;模板2.0生成规则模板版本生成规则;
custom_position_scene_level3 enum 广告场景三级 参见附录10 非必填,参数custom_position_scene_level3、scene必须存在且只能存在一个。
is_open_rewarded enum 是否开启激励 取值范围参见广告位开关类状态 非必填,默认为Close。
is_mediation bool 是否聚合广告位 非必填,默认为false
custom_reward_content CustomRewardContent 自定义奖励信息 非必填,该参数仅支持JS、SDK接入的激励广告场景下的广告位,需开通白名单

FilterRule 过滤规则(已废弃)

参数名称 参数类型 参数描述 参数限制 是否必填
filter_pkg_names string[] 过滤包名 最大300,单个最大长度100 非必填
filter_ituns_ids string[] 过滤app store 应用id 最大300,单个最大长度100 非必填
filter_keywords string[] 过滤关键词 最大500,单个长度最大100 非必填
filter_categories enum[] 过滤类目 取值范围参考过滤行业 非必填

RtbConfig

参数名称 参数类型 参数描述 参数限制 是否必填
rtb_relation_adx_id* int64 预先给adx分配的id RTB绑定时必填
rtb_relation_pos_adx_id string adx广告id 使用优量汇协议非必填;使用开发者协议必填
rtb_relation_os enum 取值范围参见RTB绑定的OS RTB绑定时,使用优量汇协议非必填;使用开发者协议必填
rtb_relation_name string 非必填
rtb_relation_bundle string 非必填
rtb_relation_posw int32 非必填
rtb_relation_posh int32 非必填
rtb_relation_requestw int32 非必填
rtb_relation_requesth int32 非必填
rtb_relation_placement_type string 非必填
rtb_relation_template_id int64 非必填
rtb_relation_is_paster boolean 非必填
rtb_relation_native_layout string 非必填
rtb_relation_extra string 非必填

CustomRewardContent 自定义奖励信息

参数名称 参数类型 参数描述 参数限制 是否必填
reward_content_description string 奖励内容 不超过7个中文字符/14个英文字符 设置自定义奖励信息时,该字段必填
reward_content_count int64 奖励数量 不超过9999的整数 非必填
second_reward_content_description string 奖励内容 不超过7个中文字符/14个英文字符 非必填,当填写second_reward_content_count时,该字段必填
second_reward_content_count int64 奖励数量 不超过9999的整数 非必填

*RTB对接时创建广告位细分场景说明

1). 使用对方协议合作,使用Media API创建广告位:请求中带了开发者广告位id,且和优量汇广告位id可一一对应:

参数名称 参数类型 参数描述 参数限制 是否必填
rtb_relation_adx_id int64 预先给adx分配的id RTB绑定时必填
rtb_relation_pos_adx_id string adx广告位id 使用开发者协议必填,且广告位id与优量汇广告位id一一对应
rtb_relation_os enum RTB绑定的OS 取值范围参见RTB绑定的OS RTB绑定时必填

应答字段:

名称 类型 描述
placement_id int64 广告位id

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/add' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id": 2763558177,
    "app_id": 1101152570,
    "placement_name": "test 12",
    "ad_pull_mode": "SDK",
    "scene": "FLOW",
    "rewarded_video_scene": "OTHER",
    "rewarded_video_scene_description": "demoData",
    "placement_image_id": 1,
    "render_type": "NORMAL",
    "ad_crt_type_list": [
        "IMAGE"
    ],
    "ad_crt_normal_types": ["16_9_image"],
    "ad_crt_template_type": [
        "RP_LT"
    ],
    "flash_crt_type": "FLASH",
    "rewarded_video_crt_type": "ALL_DIRECTION",
    "ad_feedback_element": [
        "APP_DL_IMG"
    ],
    "is_mediation": false,
    "enable_experiment": true,
    "reject_reason":"详情页地址无效,请填写可选应用市场的有效链接",//审核拒绝时有效
}'

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "placement_id": 9010062089859016
    }
}

4.3.2 修改广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/update

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者id 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要修改哪个广告位 必填
placement_name string 广告位名字 最大长度30个字符;同一个媒体下广告位名字不能重复 非必填
rewarded_video_description string 激励广告激励场景描述,当激励场景点为其它时,可更新位名字 最大200字符 非必填,激励广告,激励场景点为其它时可填
ad_feedback_element enum[] 广告返回元素,当为原生自渲染广告时可填 取值范围参考广告返回元素 非必填,原生自渲染可填
filter_rule(已废弃) FilterRule Api不再支持过滤规则设置,请到开发者平台设置屏蔽规则 非必填
download_land_page enum App广告跳落地页确认 取值范围参考App广告跳落地页确认 非必填,广告位有App广告跳落地页确认白名单可更新
need_server_verify enum 是否开启服务端校验,仅适用于接入方式为sdk的激励广告场景 取值范围参考服务端校验是否开启 非必填
transfer_url string 激励广告、插屏全屏视频 服务端校验回调地址 支持http和https协议地址 非必填,当设置need_server_verify为开启验证时该字段必填
secret string 激励广告服务端校验密钥 32位随机大小写字母和1-9数字组成 非必填,当设置need_server_verify为开启验证时该字段必填
price_strategy_type enum 广告位价格策略 取值范围参考价格策略 非必填
ecpm_price int64 广告位价格 单位:分 非必填,当价格策略设置为目标价(TargetPrice)时该字段必填
real_time_bidding_type enum 实时竞价类型 取值范围参考实时竞价类型 非必填,当价格策略设置为实时竞价(BiddingPrice)时该字段必填
convert_to_formal boolean 是否将测试广告位转为正式 false-不转正式,true-转为正式 非必填,默认为false
ad_crt_type_list enum[] 素材类型 取值参考素材类型 默认值逻辑同创建;仅模板2.0部分场景(FLOW、VIDEO_PASTE、FOCUS_POINT、INSERTION半屏)支持修改;模板2.0生成规则模板版本生成规则;
ad_crt_template_type enum[] 模板广告样式 取值范围参见模板类型 默认值逻辑同创建;仅模板2.0部分场景(FLOW、VIDEO_PASTE、FOCUS_POINT、INSERTION半屏)支持修改;模板2.0生成规则模板版本生成规则;自定义模板广告位不支持修改,如果强行修改会导致自定义模板丢失;
enable_experiment enum 广告样式多样性探索 取值范围参见广告位开关类状态 非必填,默认为Open,仅模板2.0部分场景(FLOW、VIDEO_PASTE、FOCUS_POINT、INSERTION-半屏)支持修改;模板2.0生成规则模板版本生成规则;
is_open_rewarded enum 是否开启激励 取值范围参见广告位开关类状态 非必填,默认为Close。
ad_crt_normal_types enum[] 自渲染广告样式 取值范围参见自渲染广告样式规格 非必填,场景非激励广告和开屏时,自渲染必填,可多选
rewarded_video_crt_type enum 激励广告广告样式 取值范围参见激励广告样式 非必填,仅场景scene为激励广告时使用
custom_reward_content CustomRewardContent 自定义奖励信息 非必填,该参数仅支持JS、SDK接入的激励广告场景下的广告位,需开通白名单

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/update' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id": 2763558177,
    "placement_id":2353536546547235,  
    "placement_name": "demoData",
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.3 获取广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/list

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
filtering struct[] 过滤条件 过滤结构参数限制如下 选填,若此字段不传或传空,则视为无限制条件
- field string 过滤字段 可选值:
placement_id、placement_name、app_id、medium_name、scene、ad_pull_mode、render_type、pause_status、status、placement_test_status、is_mediation
- operator enum 操作符 - 当field取值placement_id时,枚举列表:{EQUALS, IN}
- 当field取值placement_name时,枚举列表:{CONTAINS}
- 当field取值app_id时,枚举列表:{EQUALS}
- 当field取值medium_name时,枚举列表:{CONTAINS}
- 当field取值scene时,枚举列表:{EQUALS}
- 当field取值ad_pull_mode时,枚举列表:{EQUALS}
- 当field取值render_type时,枚举列表:{EQUALS}
- 当field取值pause_status,枚举列表:{EQUALS}
- 当field取值status,枚举列表:{EQUALS}
- 当field取值placement_test_status,枚举列表:{EQUALS}
- 当field取值is_mediation,枚举列表:{EQUALS}
- values string[] 字段取值 数组的个数限制与 operator 的取值相关

- 当field取值scene时,字段取值见场景
- 当field取值ad_pull_mode时,字段取值参见接入方式
- 当field取值render_type时,字段取值参见渲染方式
- 当field取值pause_status,字段取值参见广告位暂停状态
- 当field取值status,字段取值参见广告位状态
- 当field取值placement_test_status,字段取值参见广告位测试状态
- 当field取值is_mediation时,字段取值true或false
page int32 搜索页码 默认值:1 选填
page_size int32 每页显示的数据条数 默认值:20,最大值 100 选填

应答字段:

名称 类型 描述
list struct[] 返回广告位列表,结构如下
- placement_id int64 广告位id
- placement_name string 广告位名字
- status enum 广告位状态
- pause_status enum 广告位暂停状态
- app_id int64 媒体id
- scene enum 广告场景
- rewarded_video_scene enum 激励场景
- rewarded_video_description string 激励广告场景点为其他时的描述
- ad_pull_mode enum 接入方式
- render_type enum 渲染方式
- ad_crt_type_list enum[] 素材类型
- ad_crt_template_type enum[] 模板广告样式
- ad_crt_normal_type int 自渲染广告样式,逐步废弃
- ad_crt_normal_types enum[] 自渲染广告样式
- flash_crt_type enum 开屏广告样式
- rewarded_video_crt_type enum 激励广告样式
- ad_feedback_element enum[] 广告返回元素
- price_strategy_type enum 广告位价格策略
- ecpm_price int64 广告位价格
- real_time_bidding_type enum 实时竞价类型
- need_server_verify enum 激励广告是否开启服务端校验
- transfer_url string 激励广告、插屏全屏视频 服务端校验回调地址
- secret string 激励广告服务端校验密钥
- download_land_page enum App广告跳落地页确认
- placement_test_status enum 广告位测试状态
- template_version int64 模板版本
- enable_experiment enum 广告样式多样性探索开关
- custom_position_scene_level2 enum 广告场景二级
- custom_position_scene_level3 enum 广告场景三级
- position_scene_pro_2 enum 广告场景第二级,逐步废弃,请切换到custom_position_scene_level2
- position_scene_pro_3 enum 广告场景第三级,逐步废弃,请切换到custom_position_scene_level3
- is_open_rewarded enum 是否开启激励
- is_mediation bool 是否聚合广告位
- custom_reward_content CustomRewardContent 自定义奖励信息

| page_info| struct| 分页配置信息|
| - page| int32 | 查询页码 |
| - page_size| int32 | 每页显示的数据条数 |
| - total_number| int32 | 总条数 |
| - total_page| int32 | 总页数 |

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/list' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id": 2763558177,
    "filtering": [
        {
            "field": "ad_pull_mode",
            "operator": "EQUALS",
            "values": [
                "SDK"
            ]
        },
        {
            "field": "scene",
            "operator": "EQUALS",
            "values": [
                "REWARDED_VIDEO"
            ]
        }
    ],
    "page": 1,
    "page_size": 5
}'

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "list": [
            {
                "placement_id": 103000000,
                "placement_name": "广告位名称",
                "app_id": 110000000,
                "scene": "REWARDED_VIDEO",
                "rewarded_video_scene": "TASK_REWARD",
                "rewarded_video_description": "",
                "ad_pull_mode": "SDK",
                "render_type": "NORMAL",
                "ad_crt_type_list": [
                    "VIDEO"
                ],
                "ad_crt_template_type": null,
                "ad_crt_normal_types": ["16_9_image"],
                "flash_crt_type": "",
                "rewarded_video_crt_type": "ALL_DIRECTION",
                "ad_feedback_element": null,
                "status": "Freeze",
                "pause_status": "Normal",
                "filter_rule": null,
                "is_open_rewarded": "Close",
                "is_mediation": false
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 5,
            "total_number": 1,
            "total_page": 1
        }
    }
}

4.3.4 删除广告位

规则说明:

  1. 处于自动优化层的广告位不得删除;
  2. 资讯广告位不得删除。

请求URL:https://api.adnet.qq.com/open/v1.1/placement/delete

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要删除哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/delete' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.5 解冻广告位

规则说明:
解冻广告位状态会实时生效,但解冻后的广告位正常获取到广告存在延迟,最大延迟3小时。

请求URL:https://api.adnet.qq.com/open/v1.1/placement/unfreeze

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要解冻哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/unfreeze' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.6 暂停广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/pause

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要暂停哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/pause' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.7 启动广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/start

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要启动哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/start' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.8 冻结广告位

请求URL:https://api.adnet.qq.com/open/v1.1/placement/freeze

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要冻结哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/freeze' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.9 彻底删除广告位

规则说明:

  1. 广告位当前状态是冻结或者已删除(调用过4.3.4 删除广告位接口)并且7天无消耗的广告位可以彻底删除。封禁、违规暂停的广告位不可删除。
  2. 删除后RTB广告位关联关系同步删除。
  3. 删除后广告位与绑定的流量包自动解绑。

请求URL:https://api.adnet.qq.com/open/v1.1/placement/complete_delete

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
placement_id int64 广告位id 根据创建接口返回的placement_id指定需要删除哪个广告位 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/complete_delete' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id":2763558177,
    "placement_id":5010159514522894
}'

应答示例:

{
    "code": 0,
    "message": "ok"
}

4.3.10 获取RTB双方广告位映射关系

规则说明:

  1. 只有RTB会员才可以使用接口查询数据;

请求URL:https://api.adnet.qq.com/open/v1.1/placement/get_rtb_placement

请求方法:POST

Content-Type:application/json

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
pos_adx_id_list string[] 厂商广告位ID列表 最多传10个,如果page和page_size不填写,此字段必填
page int32 页码 默认值:1 选填,如果pos_adx_id_list不传,此字段必填
page_size int32 每页显示的数据条数 默认值:100,最大值 1000 选填,如果pos_adx_id_list不传,此字段必填

应答字段:

名称 类型 描述
list struct[] 返回广告位列表,结构如下
- member_id int64 开发者id
- adx_id int64 adx id
- pos_adx_id string 厂商广告位id
- placement_id int64 优量汇广告位id
page_info struct 分页配置信息
- page int32 查询页码
- page_size int32 每页显示的数据条数
- total_number int32 总条数
- total_page int32 总页数

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/placement/get_rtb_placement' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id": 2763558177,
    "pos_adx_id_list": [
        "abc","bcd","def"
    ],
    "page": 1,
    "page_size": 3
}'

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "list": [
            {
                "member_id": 12345,
                "adx_id": 22,
                "pos_adx_id": "103000000xxx",
                "placement_id": 103000000
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 3,
            "total_number": 1,
            "total_page": 1
        }
    }
}

4.4 报表模块

4.4.1 查询天级报表

测试联调:使用测试账号,请求测试环境,报表接口是mock数据,日期请求20200414。

请求URL:https://api.adnet.qq.com/open/v1.1/report/get?member_id=xxx

请求方法:GET

支持查询参数:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
medium_name string 媒体名称 非必填
placement_name string 广告位名称 同时传medium_name生效 非必填
placement_type enum 广告位类型 非必填
custom_position_scene_level2 enum 取值参考二级场景点 非必填
price_strategy_type enum 取值参考价格策略类型 非必填
start_date int32 开始日期 格式为yyyyMMdd,
时间跨度不超过30天
必填
end_date int32 截止日期 格式为yyyyMMdd,
时间跨度不超过30天
必填
os_platform string 系统平台 Android/iOS 非必填
page int32 搜索页码 默认值:1 选填
page_size int32 每页显示的数据条数 默认值:0,最大值 1000。不填写默认返回全部数据,推荐您填写该字段,采用分页查询的方式 选填

返回参数

名称 类型 描述
list ReportResult[] 报表结果
last_updated_date string 数据最新更新日期
page_info struct 分页配置信息
- page int32 查询页码
- page_size int32 每页显示的数据条数
- total_number int32 总条数
- total_page int32 总页数

ReportResult参数详情

名称 类型 描述
member_id int64 开发者账号
medium_name string 媒体名称
os_platform string 系统平台
app_id long 媒体id
placement_id int64 广告位ID
placement_name string 广告位名称
placement_type string 广告位类型
date string 日期,yyyy-MM-dd
is_summary boolean 是否是summary,该参数在第一页生效,其余页该参数均为false,即请求第一页时会返回汇总数据
request_count string 广告位请求量
return_count string 广告位返回量
ad_request_count string 广告请求量
ad_return_count string 广告返回量
pv string 曝光量
click string 点击量
fill_rate string 广告位填充率 (广告位返回量 / 广告位请求量 * 100%)
exposure_rate string 广告位曝光率 (曝光量/广告位返回量 * 100%)
ad_fill_rate string 广告填充率 (广告返回量/广告请求量 * 100%)
ad_exposure_rate string 广告曝光率 (曝光量 / 广告返回量 * 100%)
click_rate string 点击率 (点击量 / 曝光量 * 100%)
revenue double 收入 (单位:元)
ecpm double 千次展示收入 (收入 / 曝光量 * 1000) (单位:元)
cpc double 点击成本 (收入 / 点击量) (单位:元)
price_strategy_type string 价格策略类型
custom_position_scene_level2 string 广告场景二级
custom_position_scene_level2_name string 广告场景二级名称
price double 设价
price_level string 分层标签
revenue_usd double 收入 (单位:美元)
ecpm_usd double 千次展示收入 (收入 / 曝光量 * 1000) (单位:美元)
cpc_usd double 点击成本 (收入 / 点击量) (单位:美元)
usd_exchange_rate double 美元/人民币汇率中间价(天级别更新)
bidding_win_report_count string 竞胜回传量,表示优量汇返回广告及报价后,接受到流量方回传的竞胜量
bidding_lose_report_count string 竞败回传量,表示优量汇返回广告及报价后,接受到流量方回传的竞败量
bidding_total_report_count string 竞价结果回传量,表示优量汇返回广告及报价后,接受到流量方回传的竞胜与竞败量之和
bidding_ad_report_rate string 广告竞价结果回传率,表示竞价结果回传量 / 广告返回量,80%~120%为合理值参考区间
bidding_pid_report_rate string 广告位竞价结果回传率,表示竞价结果回传量 / 广告位返回量,当单次请求1条广告时,80%~120%为合理值参考区间
bidding_win_rate string 竞胜率,表示竞胜回传量 / 竞价结果回传量
bidding_win_expose_rate string 竞胜曝光率,表示曝光量 / 竞胜回传量,80%以上为合理值参考区间
cpr double 千次请求价值 (收入 / 请求量 * 1000) (单位:元)
handle_placement_request_count int64 广告位请求承接量
handle_placement_request_rate double 广告位请求承接率

请求示例:

curl --location --request GET 
'https://api.adnet.qq.com/open/v1.1/report/get?member_id=2763558177&page=2&page_size=100' \
--header 'token:
cnRiLDE1ODQzMzI3NDQsNzEwZDY3MjNkNWViOWYxNWEwZmFkMTlhNjRiNWU5NWY1MDgwZDU5Mg==' \

应答示例:

{
    "code": 0,
    "message": "ok",
    "data":{
        "list": [{
        "placement_id": 2040498460877118,
        "member_id": 2763558177,
        "os_platform": "Android",
        "app_id": 1101152570,
        "medium_name": "SDK Demo",
        "placement_name": "模板-图文-浮层单图-勿动",
        "date": "2020-06-09",
        "placement_type": "原生",
        "exposure_rate": "8.13%",
        "fill_rate": "75.00%",
        "click_rate": "10.00%",
        "ecpm": "8.50",
        "revenue": "11.05",
        "click": "130",
        "pv": "1300",
        "request_count": "20000",
        "return_count": "15000",
        "ad_request_count": "22000",
        "ad_return_count": "16000",
        "is_summary": false,
        "cpr": 0.33
      }],
      "page_info": {
            "page": 2,
            "page_size": 100,
            "total_number": 300,
            "total_page": 3
        }
    }
}

4.4.2 查询小时级报表

请求URL:https://api.adnet.qq.com/open/v1.1/report/hourly

请求方法:POST

Content-Type:application/json

请求参数:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填
date string 日期 格式为yyyyMMdd,仅支持当天及过去七天的日期 必填
filtering struct[] 过滤条件 过滤结构参数限制如下 选填,若此字段不传或传空,则视为无限制条件
- field string 过滤字段 可选值:
-app_id:媒体id
-custom_position_scene_level2:广告场景二级
-placement_id:广告位id
- operator enum 操作符 - 当field取值app_id时,枚举列表:{IN}
- 当field取值custom_position_scene_level2时,枚举列表:{IN}
- 当field取值placement_id时,枚举列表:{IN}
- values string[] 字段取值 数组的个数限制与 operator 的取值相关

- 当field取值custom_position_scene_level2时,字段取值见广告场景二级
group_by enum[] 聚合(拆解)维度 可选值:os_platform、app_id、custom_position_scene_level2或placement_id 选填
order_by struct 排序字段 排序字段结构参数限制如下 选填
- sort_field enum 排序字段 可选值:stats_date、hour、app_id、custom_position_scene_level2、placement_id、revenue、ecpm、pv、click或click_rate,含义同返回字段,当按照app_id、custom_position_scene_level2或placement_id排序时,必须在group_by字段内
- sort_type enum 排序类型 可选值:{ASC,DESC}
page int32 搜索页码 默认值:1 选填
page_size int32 每页显示的数据条数 默认值:20,最大值 1000 选填

返回参数

名称 类型 描述
list struct[] 小时级报表结果列表,结构如下
- date string 日期,yyyy-MM-dd
- hour int64 小时,范围0~23,0表示0点-1点的数据,1表示1点-2点的数据,以此类推
- app_id int64 媒体id
- medium_name string 媒体名称
- placement_id int64 广告位ID
- placement_name string 广告位名称
- custom_position_scene_level2 string 广告场景二级
- custom_position_scene_level2_name string 广告场景二级名称
- revenue double 收入 (单位:元)
- ecpm double 千次展示收入 (收入 / 曝光量 * 1000) (单位:元)
- pv string 曝光量
- click string 点击量
- click_rate string 点击率 (点击量 / 曝光量 * 100%)
page_info struct 分页配置信息
- page int32 查询页码
- page_size int32 每页显示的数据条数
- total_number int32 总条数
- total_page int32 总页数

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/report/hourly' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "member_id": 2763558177,
    "date": "20220608",
    "filtering": [
        {
            "field": "custom_position_scene_level2",
            "operator": "IN",
            "values": [
                "FLOW_NORMAL"
            ]
        },
        {
            "field": "app_id",
            "operator": "IN",
            "values": [
                "123456"
            ]
        }
    ],
    "order_by": {
        "sort_field": "ecpm",
        "sort_type": "DESC"
    },
    "group_by": ["app_id", "placement_id"],
    "page": 1,
    "page_size": 5
}'

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "list": [
            {
                "date": "2022-05-20",
                "app_id": 1101152570,
                "medium_name": "SDK Demo",
                "placement_id": 2040498460877118,
                "custom_position_scene_level2": "FLOW_NORMAL",
                "custom_position_scene_level2_name": "常规信息流",
                "revenue": "11.05",
                "revenue": "11.05",
                "ecpm": "8.50",
                "pv": "1300",
                "click": "130",
                "click_rate": "10.00%"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 5,
            "total_number": 1,
            "total_page": 1
        }
    }
}

4.4.3 查询RTB流量诊断报表

请求URL:https://api.adnet.qq.com/open/v1.1/report/rtb_diagnose

请求方法:POST

Content-Type:application/json

请求参数:

参数名称 参数类型 参数描述 参数限制 是否必填
start_date string 开始日期 格式为yyyyMMdd,最多查询过去30天数据 必填
end_date string 结束日期 格式为yyyyMMdd 必填
filtering struct[] 过滤条件 过滤结构参数限制如下 选填,若此字段不传或传空,则视为无限制条件
- field string 过滤字段 可选值:
-pos_adx_id:厂商广告位id
-package_name:请求包名
-error_code:错误码
- operator enum 操作符 - 当field取值pos_adx_id时,枚举列表:{IN}
- 当field取值package_name时,枚举列表:{IN}
- 当field取值error_code时,枚举列表:{IN}
- values string[] 字段取值 数组的个数限制与 operator 的取值相关
group_by enum[] 聚合(拆解)维度 可选值:stats_date、adx_id、pos_adx_id、error_code或package_name 选填,若此字段不传或传空,则返回最细粒度的数据
order_by struct 排序字段 排序字段结构参数限制如下 选填
- sort_field enum 排序字段 可选值:stats_date、pos_adx_id、error_code、package_name或request_count,含义同返回字段
- sort_type enum 排序类型 可选值:{ASC,DESC}
page int32 搜索页码 默认值:1 选填
page_size int32 每页显示的数据条数 默认值:20,最大值 1000 选填

返回参数

名称 类型 描述
list struct[] 小时级报表结果列表,结构如下
- stats_date string 日期,yyyyMMdd
- adx_id int64 ADXID
- package_name string 包名
- pos_adx_id string 厂商广告位ID
- error_code int64 错误码
- error_msg string 错误信息
- request_count int64 过滤请求量
page_info struct 分页配置信息
- page int32 查询页码
- page_size int32 每页显示的数据条数
- total_number int32 总条数
- total_page int32 总页数

请求示例:

curl 'https://api.adnet.qq.com/open/v1.1/report/rtb_diagnose' \
--header 'token: cnRiLDE1ODQyODMzMzgsODUzODhjZTcxMmJmYWZlNmI5NzlmOTNkZGE3Mzk1NTFhZTRhMDc2Ng==' \
--header 'Content-Type: application/json' \
-d '{
    "start_date":"20230301",
    "end_date":"20230310",
    "group_by":[
        "adx_id",
        "pos_adx_id",
        "stats_date",
        "package_name",
        "error_code"
    ],
    "order_by":{
        "sort_field":"pos_adx_id",
        "sort_type":"DESC"
    },
    "filtering":[
        {
            "field":"pos_adx_id",
            "operator":"IN",
            "values":[
                "1",
                "2"
            ]
        },
        {
            "field":"package_name",
            "operator":"IN",
            "values":[
                "com.xx.xstore"
            ]
        },
        {
            "field":"error_code",
            "operator":"IN",
            "values":[
                "100133"
            ]
        }
    ],
    "page":1,
    "page_size":10
}'

应答示例:

{
    "code":0,
    "data":{
        "page_info":{
            "total_number":799,
            "total_page":80,
            "page":1,
            "page_size":10
        },
        "list":[
            {
                "stats_date":"20230307",
                "error_msg":"kNoNeedToAccessMixerService",
                "pos_adx_id":"123",
                "adx_id":12,
                "error_code":109502,
                "package_name":"com.xx.xstore",
                "request_count":581890
            }
        ]
    },
    "message":"success"
}

4.5 图片资源上传

图片类上传,统一先通过该接口上传资源,接口返回资源id之后,通过资源id来标识该图片。

请求URL:https://api.adnet.qq.com/open/v1.1/image/upload

请求方法:POST

Content-Type:multipart/form-data

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int 会员id 当前会员id 必填
type string 图片类型 参考图片类型 必填
file file 待上传图片 必填

返回参数

参数名称 参数类型 参数描述
image_id int 图片资源id

请求示例

curl --location --request POST 'https://api.adnet.qq.com/open/v1.1/image/upload' \
--header 'token: cnRiLDE1ODQzNzc0MTcsZDVjNjIzNWRkZTY1MTFmMGJmMWQyNzlkMTE0ZjI3M2ZmYzgyMGIxMA==' \
--header 'Content-Type: multipart/form-data' \
--form 'member_id=2763558177' \
--form 'type=PLACEMENT_IMAGE' \
--form 'file=@/Users/Desktop/WechatIMG197.jpeg' \

应答示例

{
    "code": 0,
    "message": "ok",
    "data":{
      "image_id" : 1
       }
 }

4.6 工具模块

4.6.1 获取美元汇率

请求URL:https://api.adnet.qq.com/open/v1.1/resource/get_usd_rate

请求方法:GET

支持查询参数:

参数名称 参数类型 参数描述 参数限制 是否必填
member_id int64 开发者账号 必填

返回参数

参数名称 参数类型 参数描述
usd_rate double 汇率

4.7 用户洞察模块

4.7.1 上报用户信息

请求URL:https://api.adnet.qq.com/open/v1.1/insight/upload

请求方法:POST

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
user_list struct[] 用户列表 最大长度1000 必填
- user_id_type enum 用户Id类型 取值范围参见用户Id类型 必填
- user_id string 用户id 最大长度128 必填
- active_time int64 激活时间 秒级时间戳 必填
- main_channel Int64 主渠道 取值参见附录9 必填
- sub_channel string 子渠道 由开发者自定义 必填
- app_id Int64 优量汇appId 必填
- product_id Int64 商品Id 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
    }
}

4.7.2 拉取统计数据

请求URL:https://api.adnet.qq.com/open/v1.1/insight/get_stats

请求方法:POST

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
data_time string 数据日期(20210606) 30天内 必填

应答字段:

名称 类型 描述
stats struct[] 返回统计数据列表,结构如下
- data_time string 数据日期(20210606)
- active_time string 激活日期(20210606)
- product_id int64 商品Id
- product_name string 商品名称
- app_id int64 媒体id
- main_channel enum 主渠道取值参见附录9
- sub_channel string 子渠道
- os string 操作系统(iOS, Android)
- req int64 请求量
- fill int64 填充量
- fill_rate double 填充率
- pv int64 曝光量
- pv_rate double 曝光率
- uv int64 用户曝光量
- click int64 点击量
- click_rate double 点击率
- cost int64 消耗(单位分)
- cpm int64 千次展示消耗(单位分)
- cpc int64 每次点击消耗(单位分)

应答示例:

{
    "code": 0,
    "data": {
        "stats": [
            {
                "data_time": "20210606",
                "active_time": "20210531",
                "product_id": 1738912999,
                "product_name": "",
                "app_id": 1293721361999,
                "main_channel": 1,
                "sub_channel": "wx",
                "os": "",
                "req": 0,
                "fill": 0,
                "fill_rate": 0,
                "pv": 0,
                "pv_rate": 0,
                "uv": 3,
                "click": 0,
                "click_rate": 0,
                "cost": 0,
                "cpm": 0,
                "cpc": 0
            }
        ]
    },
    "message": "success"
}

4.8 对账上报

4.8.1 上报用户信息

请求URL:https://api.adnet.qq.com/open/v1.1/resource/upload_bill

请求方法:POST

请求字段:

参数名称 参数类型 参数描述 参数限制 是否必填
bill_list struct[] 账单列表 最大长度1000 必填
- placement_id int64 广告位id 优量汇广告位id 选填
- adx_placement_id string 厂商广告位id 厂商广告位id 选填
- os enum adx_placement_id所属的OS 取值范围参见RTB绑定的OS 选填
- pv int64 曝光数 必填
- cost int64 消耗(单位分) 必填
bill_date string 账单日期 格式化 "20210607" 必填
adx_id Int64 厂商对接id 必填

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息
data struct
- error_list struct[] 错误列表
- placement_id int64 广告位id
- adx_placement_id string 厂商广告位id
- error_msg string 错误信息

应答字段:

名称 类型 描述
code int32 返回码: 0表示成功
具体见返回码列表
message string 返回信息:
若有错误,此字段为详细的错误信息
data struct
- error_list struct[] 错误列表
- placement_id int64 广告位id
- error_msg string 错误信息

请求示例

{
    "bill_date": "20210805",
    "bill_list": [{
        "placement_id": 4071350381338615,
        "pv": 100,
        "cost": 1000000
    },{
        "placement_id": 4071360393007734,
        "pv": 200,
        "cost": 1500000
    }]
}

应答示例:

{
    "code": 0,
    "message": "ok",
    "data": {
      "error_list":[
        {
          "placement_id": 873498372489,
          "error_msg": "错误信息"
        }
      ]
    }
}

附录

附录1. 返回码定义

返回码 返回消息 返回描述
0 ok 表示请求成功
18001 Your request is missing a required parameter. The required parameter is '%s'. 请求参数缺少必填参数
18003 The value you specified for '%s' is invalid. Valid values must be less than %s. 传入参数不合法,数值必须小于某个值
18004 The value you specified for '%s' is invalid. Valid values must be greater than %s. 传入参数不合法,数值必须大于某个值
18008 The parameter '%s' has too many characters. 输入参数字长度超长
18009 Parameter '%s' must be one of the following values: [%s] 枚举值不在可选范围内
18011 Your request contains too many values for '%s'. This parameter can have a maximum of %s value(s). 参数数组元素数量过多
11003 auth token error 鉴权错误,参考具体返回的错误信息进行调整token
11004 %s/%s no data for %s 没有调用此接口的权限,请联系技术支持或运营接口人申请
130001 parameter error 未知参数异常
130002 Your request is rejected.Please sign the Compliance Statement. 请求被拒绝,因为未签署合规承诺函。请您尽快访问开发者平台(https://e.qq.com/dev) 完成《合规承诺函》的线上签署后再继续使用Media API。如您有任何问题,请发送邮件至优量汇官方邮箱(ADNET@tencent.com)或与您对接的运营经理联系,我们将尽快给您回复。谢谢您的支持。
130003 Your request is rejected.Please sign the Data Protection Agreement. 您尚未签署数据保护协议。请您尽快访问开发者平台(https://adnet.qq.com/) 完成《数据保护协议》的线上签署后再继续使用Media API。如您有任何问题,请发送邮件至优量汇官方邮箱(ADNET@tencent.com)或与您对接的运营经理联系,我们将尽快给您回复。谢谢您的支持。
130105 parameter:%s is invalid 数据错误
130106 no auth 没有权限
130107 medium in blacklist 该媒体被拉黑
130108 wechat app id is invalid 微信开放平台AppId校验不合法,请检查微信AppId和包名是否匹配
130109 param error 参数异常,请检查字段类型是否正确或联系技术支持咨询
130110 file too large 上传文件过大
130111 file format is invalid 文件格式错误
130112 internal error 参数异常,请联系技术支持咨询
130113 medium is not exist 媒体不存在
130114 member id not match 账号信息不匹配
130115 wechat app id can not delete 微信开放平台AppId一旦添加不允许删除
130116 operation forbidden 操作不允许
130117 app detail url invalid 应用详情地址非法
130118 invalid ad pull mode 请求接入方式不支持
130119 invalid ad style type 广告样式不支持
130120 unmatched template type 模板类型不匹配
130121 rewarded scene desc missing 激励场景为其他时,描述为必填
130122 unmatched scene and placement type 场景和广告位类型不匹配
130123 rewarded scene is not allowed empty when scene is RewardedVideo 场景为激励广告时 激励场景不能为空
130124 rewarded scene desc is not allowed empty when scene is RewardedVideo and rewarded scene is default 场景为激励广告时激励场景为其他的时候描述不能为空
130125 no white-list option 没有白名单权限
130126 unmatched app id appid与请求不匹配
130127 invalid app id 非法媒体app id
130128 medium only support one ad_pull_mode 同一媒体只支持一种接入方式
130130 invalid render type 渲染方式不支持
130131 invalid image 无效图片,图片资源不属于当前会员或者图片使用场景不对
130132 flash crt type empty 开屏场景必填开屏广告样式
130133 unspport ad_crt_type_list 不支持的素材样式
130134 member status invalid 会员审核状态不合法
130137 invalid medium, can not create placement 自动生成的资讯媒体下不能创建广告位
130139 freezed member can not operate 会员被封禁
130140 invalid ad crt, please check scene and ad crt which scene suppot 无效的广告样式,场景下不支持该样式
130141 unsupport ad pull mode in current medium 当前媒体不支持改接入方式
130142 invalid download_confirm value 二次下载确认值无效
130300 medium name exist 媒体名称已存在
130301 failed to verify domain 域名验证失败
130302 wechat universal link invalid 微信univeral link不合法
130303 h5 medium not support package_name、wechat_app_id、detail_url H5媒体不支持package_name/wechat_app_id/detail_url
130304 android/ios medium not support domain、icp、icp_picture Android、IOS媒体不支持domain/icp/icp_picture
130305 keywords size too large(over 60) 关键词不得超过60个
130306 package name has been blocked 包名存在封禁记录
130307 domain has been blocked 域名存在封禁记录
130311 mobile games must upload isbn picture 手游未上传isbn图片
130313 package name error 包名错误
130315 apk url not support apk链接不支持
130316 detail url invalid 详情页地址不合法
130317 price strategy set fail 价格策略设置失败,如有需要,请调用placement/update接口重新设置,您也可以直接联系我们获取技术支持
130318 package name hes been registered 包名重复
130319 package name duplicate 包名冲突
130321 create medium reach max 开发者最多可创建300个正式媒体
130322 create placement reach max 每个媒体最多可创建250个正式广告位
130323 medium cannot be delete 封禁、暂停及流量分配中的媒体不能删除
130324 create placement reach max, per member:100000 每个会员最多可创建10万个广告位
130640 placement should be removed from auto-optimized layer before delete 请先将广告位移除自动优化层,再进行删除操作
130641 non-frozen placement cannot be delete 非冻结状态广告位不得删除
130642 placement is in flow distribution cannot be delete 资讯广告位不得删除
130643 placement not freeze 非冻结状态广告位无法解冻
130644 placement should be removed from auto-optimized layer before pause 请先将广告位移除自动优化层,再进行暂停操作
130648 qualification error 请根据返回错误信息上传对应的资质
130321 create medium reach max 媒体创建、修改数量限制
130322 create placement reach max 广告位创建、修改(转正)、解冻数量限制
130325 Each ad placement can only modify physical placement properties once per day. 每个广告位每天只能修改一次物理广告位属性
130326 The number of physical placement in one media is limited to 60. The media quota is full. 单个媒体下物理广告位数量上限为60,该媒体配额已满,请合理分配
130327 A maximum of 250 ad placement can be bound under each physical placement. 每个物理广告位下最多可绑定250个广告位
130328 The name of the physical placement of the same media and the same scene cannot be repeated. 同媒体同场景的物理广告位名称不可重复
130329 Only physical placement without associated ad placement can be deleted. 仅无关联广告位的物理广告位可删除
130330 The physical placement interface is offline. 物理广告位接口能力已下线
130331 medium number exceed 媒体数量达到最大限制
130332 quick app number reached limit 快应用媒体数量达到最大限制
130333 custom_reward_content set fail. 自定义奖励信息设置失败,请检查参数是否合法,或者调用placement/update接口重新设置
130334 price strategy set fail, please check your params. 价格策略设置失败,请检查参数是否合法
130335 price strategy set fail, update frequency reaches upper limit. 价格策略设置失败,超过单日修改频次
130649 This placement cannot be deleted now. 已删除且7天内无消耗且非封禁非违规暂停 或者 冻结且7天内无消耗且非封禁非违规暂停 可彻底删除
130651 This app cannot be deleted now. 最近30天内无消耗的媒体 可彻底删除

附录2. 行业

行业 industry_id 行业 industry_id 行业 industry_id
日程备忘 50102 语言学习 50706 消除游戏 51713
办公室软件 50103 教育工具 50707 模拟经营 51714
文件管理 50104 汽车资讯 50801 益智休闲 51715
网络云盘 50105 驾照考试 50802 游戏助手 51716
输入法 50201 汽车交易 50803 游戏平台 51717
资讯工具 50202 违章查询 50804 其他手游 51718
电池插件 50203 理财服务 50902 报刊杂志 51805
安全防护 50204 股票证券 50904 有声听书 51806
内存清理 50205 彩票双色球 50905 小说阅读 51807
WIFI 50206 支付 50906 手机漫画 51808
账号辅助 50207 旅游服务 51002 幽默段子 51809
系统应用 50208 用车服务 51004 育儿工具 51901
主题美化 50209 地图导航 51006 孕育社区 51902
电话通讯 50210 公交服务 51008 经期健康 51903
性能优化 50211 共享单车 51009 垂类资讯 52001
万年历 50402 航班服务 51010 综合资讯 52002
天气服务 50403 火车服务 51011 网赚资讯 52003
运势信仰 50405 网络K歌 51301 相机 52101
闹钟 50406 音乐播放器 51302 图片美化 52102
红包助手 50407 在线音乐 51304 设计制作 52103
计算器 50408 广播电台 51305 体育资讯 52201
日记手账 50409 音乐乐器 51306 体育直播 52202
辅助工具 50410 在线视频 51401 平台 52301
导购分享 50501 在线直播 51402 美食菜谱 52401
二手交易 50506 视频播放器 51403 求职招聘 52402
移动电商 50507 短视频 51406 快递物流 52403
优惠比价 50508 电视视频 51407 在线团购 52404
运动健身 50603 视频工具 51408 房屋租赁 52405
医疗问询 50604 婚恋交友 51602 装修服务 52406
健康养生 50606 社交交友 51603 票务服务 52407
学前教育 50701 生活社区 51604 网赚平台 52408
词典翻译 50702 微博社交 51605 运营商服务 52409
K12 50703 问答社区 51606 美妆美发 52410
高等教育 50704 论坛贴吧 51607
职业培训 50705 棋牌游戏 51704

附录3. 自渲染广告样式

样式
1 16:9 图片/视频
2 9:16 图片 、9:16 视频
3 16:9 图片/视频、9:16视频
4 16:9 图片/视频、3:2三小图
5 16:9 图片
6 16:9 图片,3:2三小图
7 9:16 图片
8 16:9视频
9 9:16视频
10 16:9 视频、9:16视频
11 16:9 图片,9:16图片
14 16:9 图片/视频、9:16 图片/视频

附录3.1 自渲染广告样式规格

样式 备注
16_9_image 16:9 图片 暂无
16_9_video 16:9 视频 暂无
3_2_image 3:2三小图 暂无
9_16_image 9:16 图片 暂无
9_16_video 9:16视频 暂无
20_3_image 20:3 图片 仅支持信息流广告SDK、API使用

附录4. 枚举值定义

场景 scene

新广告场景(custom_position_scene) 旧广告场景(scene)
FLOW 信息流广告 动态信息流
FOCUS_POINT 详情页插入广告 横幅
FLASH 开屏广告 开屏
VIDEO_PASTE 视频贴片广告 视频贴片
BANNER 横幅广告 Banner
REWARDED_VIDEO 激励广告 激励视频
INSERTION 插屏广告 插屏

模板版本生成规则 template_version

描述 是否支持模板 模板version
FLOW 信息流广告 2.0
FOCUS_POINT 详情页插入广告 2.0
VIDEO_PASTE 视频贴片广告 2.0
INSERTION 插屏广告 2.0
BANNER 横幅广告 1.0
FLASH 开屏广告 1.0
REWARDED_VIDEO 激励广告 1.0

激励场景 rewarded_video_scene

描述
OTHER 其他
LOGIN_REWARD 登陆奖励
TASK_REWARD 任务奖励
PASS_REWARD 过关奖励
CONTINUE_PLAY_REWARD 续玩奖励
DOUBLE_REWARD 翻倍奖励
WAITING 等待时间
CLUES 线索提示
APP_SHOPPING 应用商店购物
LUCKY_TABLE 幸运转盘
APP_OPEN_AGAIN 再次打开应用

接入方式 ad_pull_mode

描述
SDK SDK
JS JS
API API
RTB RTB
QuickAppSDK 快应用SDK

渲染方式 render_type

描述
NORMAL 自渲染
TEMPLATE 模板渲染

素材类型 ad_crt_type

描述
VIDEO 视频素材
IMAGE 图文素材
FLASH_VIDEO_LONG 开屏:5-30秒长视频+首屏续播
FLASH_IMAGE_V 开屏:图片
FLASH_IMAGE_H 开屏:图片(废弃)
FLASH_VIDEO_V 开屏:5s视频
FLASH_VIDEO_H 开屏:5s视频(废弃)

开屏广告样式 flash_crt_type

描述
FLASH_ERECT 竖图(下线)
FLASH_JOINT 接受横版拼接的竖图(下线)
FLASH 开屏
FLASH_V_PLUS 开屏V+(下线)

激励广告样式 rewarded_video_crt_type

描述
ALL_DIRECTION 激励浏览+激励视频
IMAGE 激励浏览
VIDEO 激励视频

模板类型 ad_crt_template_type

描述
TP_BT 上图下文(支持视频)
TT_BP 上文下图(支持视频)
LP_RT 左图右文
RP_LT 左文右图
DB_TI 双图双文(支持视频)
V_IMG 纯图竖版
H_IMG 纯图横版(支持视频)
THR_IMG 三小图双文
TT_BP_MASK 上文下图-文字浮层
TP_BT_MASK 上图下文-文字浮层
TP_IMG_MASK 单图单文-文字浮层
V_ALL 沉浸式视频流(支持图文)
INLINE_H 横版插屏(支持视频)
INLINE_VH 横/竖版插屏(支持视频)
INLINE_FULL 全屏插屏(支持视频)
INLINE_V 半屏插屏-竖版(支持视频)
INLINE_S 半屏插屏-方形(支持视频)
INLINE_HS 半屏插屏-横/方版(支持视频)
INLINE_VS 半屏插屏-竖/方版(支持视频)
INLINE_VHS 半屏插屏-横/竖/方形(支持视频)
BANNER_DP 横幅 小方图双文

过滤行业 filter_categories

描述
ADULT_ALL_PRODUCT 成人医疗减肥类
CONSTELLATION_PRODUCT 星座算命类
P2P_LENDING_PRODUCT P2P网贷类

价格策略类型 price_strategy_type

描述
NOT_SET_PRICE 未设价
BASE_PRICE 底价
TARGET_PRICE 目标价
LEVEL_PRICE 多阶价
BIDDING 实时竞价
ALL_PRICE 全部价格策略类型

广告返回元素 ad_feedback_element

描述
LINK_TITLE 链接标题
LINK_ICON 链接图标
LINK_IMG 链接正图
LINK_DESC 链接描述
APP_DL_NAME 应用名称
APP_DL_ICON 应用图标
APP_DL_IMG 应用正图
APP_DL_DESC 应用描述

rtb绑定的os rtb_relation_os

描述
ANDROID 安卓
IOS 苹果系统

上传图片类型type

描述
PLACEMENT_IMAGE 广告位截图
SOFT_REGISTRATION_IMAGE 软件著作权证书
COMPANY_SHIP_IMAGE 公司关系证明
GAME_ISBN_IMAGE 游戏出版物号
BIZ_RIGHT_IMAGE 发行或代理证明
SITE_ICP_IMAGE 站点ICP备案图片
BRAND_IMAGE 商标证书图片
PUBLISHER_AGREE_IMAGE 发行协议图片(待废弃)
APP_MARKET_IMAGE 应用市场截图
AD_COOPERATION_IMAGE 广告合作承诺函图片
PLAY_MOD_SETUP_IMAGE 玩法说明启动页图片
PLAY_MOD_COVER_IMAGE 玩法说明首页图片
PLAY_MOD_DETAIL_IMAGE 玩法说明详情页图片
MARKET_SITE_ICP_IMAGE 应用下载网站备案截图
MARKET_COMPANY_SHIP_IMAGE 会员与应用下载网站主体关系证明
MARKET_BIZ_RIGHT_IMAGE 会员与应用下载网站代理协议

应用广告跳落地页确认 download_land_page

描述
Default 默认
ToLandPage 任何联网方式都跳
NotToLandPage 任何联网方式都不跳

媒体状态

描述
Pending 待审核
Approved 正常
Rejected 拒绝
Ban 封禁
Violation 违规暂停
ModificationInReview 修改审核中

媒体资质信息审核状态

描述
Pending 待审核
Approved 审核通过
Rejected 审核拒绝

广告位暂停状态

描述
Normal 启动
Pause 暂停

广告位状态

描述
Normal 正常
Ban 封禁
Pause 违规暂停
Freeze 冻结

服务端校验是否开启

描述
NeedServerVerify 开启服务器端校验
NotNeedServerVerify 不开启服务器端校验

媒体测试状态

描述
Test 测试媒体
Formal 正式媒体

用户Id类型 user_id_type

描述
IMEI IMEI
OAID OAID
IDFA IDFA

广告位测试状态

描述
Test 测试广告位
Formal 正式广告位

广告位开关类状态

描述
Close 关闭
Open 开启

媒体在厂商渠道接入方式

描述
SDK SDK
DSP DSP
API API

附录5. 旧广告场景与广告位类型映射关系

旧广告场景 新广告场景 广告位类型
开屏 开屏广告 开屏
动态信息流 信息流广告 原生
激励视频 激励广告 激励视频
横幅 详情页插入广告 原生
Banner 横幅广告 模板渲染??Banner2.0;自渲染??原生
插屏 插屏广告 插屏2.0
视频贴片 视频贴片广告 原生

附录6. 不同接入方式场景下支持的广告样式

接入方式新广告场景渲染方式广告样式(ad_crt_normal_type)
SDK信息流广告模板渲染TP_BT("上图下文"),
TT_BP("上文下图"),
LP_RT("左图右文"),
RP_LT("左文右图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
DB_TI("双图双文"),
TP_IMG_MASK("单图单文-文字浮层"),
V_IMG("竖版纯图片"),
H_IMG("横版纯图片"),
THR_IMG("三小图双文")
自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
4("16:9图片/视频、3:2三小图"),
5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
14("16:9图片/视频、9:16图片/视频")
SDK视频贴片广告模板渲染TP_BT("上图下文"),
TT_BP("上文下图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
DB_TI("双图双文"),
TP_IMG_MASK("单图单文-文字浮层"),
V_IMG("竖版纯图片"),
H_IMG("横版纯图片")
自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
4("16:9图片/视频、3:2三小图"),
5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
14("16:9图片/视频、9:16图片/视频")
SDK/JS横幅广告模板渲染BANNER_DP("小方图双文")
自渲染11("16:9图片,9:16图片")
SDK详情页插入广告模板渲染TP_BT("上图下文"),
TT_BP("上文下图"),
LP_RT("左图右文"),
RP_LT("左文右图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
DB_TI("双图双文"),
TP_IMG_MASK("单图单文-文字浮层"),
H_IMG("横版纯图片")
自渲染1("16:9图片/视频"),
4("16:9图片/视频、3:2三小图"),
5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片"),
8("16:9视频")
SDK沉浸式视频流广告模板渲染V_ALL("沉浸式视频流"),
自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
5("16:9图片"),
7("9:16图片"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
14("16:9图片/视频、9:16图片/视频")
SDK插屏广告模板渲染INLINE_H("横版插屏"),
INLINE_VH("横/竖版插屏"),
INLINE_FULL("全屏插屏"),
INLINE_V("半屏插屏-竖版"),
SDK/API/RTB开屏广告FLASH("开屏")
SDK/JS/API/RTB激励广告ALL_DIRECTION("激励视频+激励浏览")
IMAGE("激励浏览")
VIDEO("激励视频")
JS信息流广告模板渲染TP_BT("上图下文"),
TT_BP("上文下图"),
LP_RT("左图右文"),
RP_LT("左文右图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
TP_IMG_MASK("单图单文-文字浮层"),
V_IMG("竖版纯图片"),
H_IMG("横版纯图片"),
THR_IMG("三小图双文")
自渲染5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片")
JS沉浸式视频流广告自渲染5("16:9图片"),
7("9:16图片"),
11("16:9图片、9:16图片")
JS视频贴片广告模板渲染TP_BT("上图下文"),
TT_BP("上文下图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
TP_IMG_MASK("单图单文-文字浮层"),
V_IMG("竖版纯图片"),
H_IMG("横版纯图片")
自渲染5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片")
JS详情页插入广告模板渲染LP_RT("左图右文"),
RP_LT("左文右图"),
TP_BT("上图下文"),
TT_BP("上文下图"),
TP_BT_MASK("上图下文-文字浮层"),
TT_BP_MASK("上文下图-文字浮层"),
TP_IMG_MASK("单图单文-文字浮层"),
H_IMG("横版纯图片")
自渲染5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片")
API/RTB信息流广告/视频贴片广告自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
4("16:9图片/视频、3:2三小图"),
5("16:9图片"),
6("16:9图片,3:2三小图"),
7("9:16图片"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
14("16:9图片/视频、9:16图片/视频")
API/RTB详情页插入广告自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
4("16:9图片/视频、3:2三小图"),
5("16:9图片"),
6("16:9图片,3:2三小图"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
API/RTB沉浸式视频流广告自渲染1("16:9图片/视频"),
2("9:16图片、9:16视频"),
3("16:9图片/视频、9:16视频")
5("16:9图片"),
7("9:16图片"),
8("16:9视频"),
9("9:16视频"),
10("16:9视频、9:16视频")
14("16:9图片/视频、9:16图片/视频")
API/RTB横幅广告自渲染11("16:9图片,9:16图片")

附录7. 媒体隶属关系

媒体隶属关系 关系描述
Unknown 未知(兼容历史数据,新创建媒体不得使用)
Own 应用开发者
Agency 应用发行/代理方
SamePrincipal 与应用开发者存在主体关联关系(即将下线,请用Agency)

附录8. 价格策略

价格策略 策略描述
Default 默认底价
TargetPrice 目标价
CustomBasePrice 自定义底价(当前已不支持)
BiddingPrice 实时竞价

附录9. 新三级行业

一级行业 二级行业 三级行业 industry_id
游戏 角色扮演类 MMORPG 1000101
游戏 角色扮演类 ARPG 1000102
游戏 角色扮演类 回合制RPG 1000103
游戏 角色扮演类 Roguelike 1000104
游戏 角色扮演类 挂机 1000105
游戏 角色扮演类 文字 1000106
游戏 策略类 战争 1000201
游戏 策略类 塔防 1000202
游戏 策略类 战棋 1000203
游戏 策略类 冒险通关 1000204
游戏 策略类 RTS 1000205
游戏 角色卡牌类 放置卡牌 1000301
游戏 角色卡牌类 抽卡养成 1000302
游戏 角色卡牌类 动作战斗 1000303
游戏 对战卡牌类 集换式 1000401
游戏 对战卡牌类 非集换式 1000402
游戏 模拟经营类 城市建筑 1000501
游戏 模拟经营类 商业运营 1000502
游戏 模拟经营类 农场建造 1000503
游戏 模拟经营类 动物类经营 1000504
游戏 模拟经营类 模拟类 1000505
游戏 模拟经营类 时间管理 1000506
游戏 模拟经营类 物品管理 1000507
游戏 射击类 非对称性对抗射击 1000601
游戏 射击类 枪战射击 1000602
游戏 射击类 飞行射击 1000603
游戏 射击类 载具射击 1000604
游戏 射击类 弹幕射击 1000605
游戏 动作类 MOBA 1000701
游戏 动作类 格斗 1000702
游戏 动作类 竞速 1000703
游戏 动作类 非对称性对抗 1000704
游戏 动作类 冒险战斗 1000705
游戏 动作类 驾驶 1000706
游戏 动作类 跑酷躲避 1000707
游戏 棋牌类 扑克麻将 1000801
游戏 棋牌类 捕鱼 1000802
游戏 棋牌类 棋类 1000803
游戏 棋牌类 综合娱乐 1000804
游戏 养成类 恋爱养成 1000901
游戏 养成类 换装 1000902
游戏 养成类 剧情互动 1000903
游戏 音乐类 音乐节奏 1001001
游戏 音乐类 舞蹈 1001002
游戏 体育类 运动竞技 1001101
游戏 体育类 队伍经营 1001102
游戏 沙盒类 沙盒 1001201
游戏 儿童教育类 儿童教育 1001301
游戏 综合游戏平台类 综合游戏平台 1001401
游戏 益智解谜类 益智 1001501
游戏 益智解谜类 解谜 1001502
游戏 益智解谜类 问答 1001503
游戏 益智解谜类 拼字 1001504
游戏 益智解谜类 敏捷 1001505
游戏 消除类 三消 1001601
游戏 消除类 点消 1001602
游戏 放置类 放置 1001701
游戏 放置类 点击合成 1001702
游戏 io类 io 1001801
游戏 其他 其他 1001901
非游戏 系统工具 安全防护 2000101
非游戏 系统工具 系统应用 2000102
非游戏 系统工具 WIFI 2000103
非游戏 系统工具 内存清理 2000104
非游戏 系统工具 电池插件 2000105
非游戏 系统工具 输入法 2000106
非游戏 系统工具 资讯工具 2000107
非游戏 系统工具 主题美化 2000108
非游戏 系统工具 账号辅助 2000109
非游戏 系统工具 性能优化 2000110
非游戏 系统工具 电话通讯 2000111
非游戏 健康医疗 医疗问询 2000201
非游戏 健康医疗 健康养生 2000202
非游戏 健康医疗 运动健身 2000203
非游戏 生活服务 房屋租赁 2000301
非游戏 生活服务 在线团购 2000302
非游戏 生活服务 票务服务 2000303
非游戏 生活服务 装修服务 2000304
非游戏 生活服务 求职招聘 2000305
非游戏 生活服务 快递物流 2000306
非游戏 生活服务 美食菜谱 2000307
非游戏 生活服务 美妆美发 2000308
非游戏 生活服务 运营商服务 2000309
非游戏 生活服务 网赚平台 2000310
非游戏 生活工具 万年历 2000401
非游戏 生活工具 日记手账 2000402
非游戏 生活工具 运势信仰 2000403
非游戏 生活工具 天气服务 2000404
非游戏 生活工具 红包助手 2000405
非游戏 生活工具 闹钟 2000406
非游戏 生活工具 辅助工具 2000407
非游戏 生活工具 计算器 2000408
非游戏 图片服务 图片美化 2000501
非游戏 图片服务 相机 2000502
非游戏 图片服务 设计制作 2000503
非游戏 平台 平台 2000601
非游戏 商务办公 日程备忘 2000701
非游戏 商务办公 文件管理 2000702
非游戏 商务办公 网络云盘 2000703
非游戏 商务办公 办公室软件 2000704
非游戏 移动购物 优惠比价 2000801
非游戏 移动购物 移动电商 2000802
非游戏 移动购物 导购分享 2000803
非游戏 移动购物 二手交易 2000804
非游戏 教育培训 职业培训 2000901
非游戏 教育培训 教育工具 2000902
非游戏 教育培训 语言学习 2000903
非游戏 教育培训 高等教育 2000904
非游戏 教育培训 词典翻译 2000905
非游戏 教育培训 K12 2000906
非游戏 教育培训 学前教育 2000907
非游戏 汽车服务 驾照考试 2001001
非游戏 汽车服务 汽车资讯 2001002
非游戏 汽车服务 违章查询 2001003
非游戏 汽车服务 汽车交易 2001004
非游戏 财经金融 理财服务 2001101
非游戏 财经金融 支付 2001102
非游戏 财经金融 股票证券 2001103
非游戏 财经金融 彩票双色球 2001104
非游戏 出行旅游 火车服务 2001201
非游戏 出行旅游 共享单车 2001202
非游戏 出行旅游 地图导航 2001203
非游戏 出行旅游 航班服务 2001204
非游戏 出行旅游 用车服务 2001205
非游戏 出行旅游 公交服务 2001206
非游戏 出行旅游 旅游服务 2001207
非游戏 数字阅读 手机漫画 2001301
非游戏 数字阅读 报刊杂志 2001302
非游戏 数字阅读 幽默段子 2001303
非游戏 数字阅读 有声听书 2001304
非游戏 数字阅读 小说阅读 2001305
非游戏 移动音乐 网络K歌 2001401
非游戏 移动音乐 广播电台 2001402
非游戏 移动音乐 音乐乐器 2001403
非游戏 移动音乐 在线音乐 2001404
非游戏 移动音乐 音乐播放器 2001405
非游戏 移动视频 视频播放器 2001501
非游戏 移动视频 在线直播 2001502
非游戏 移动视频 视频工具 2001503
非游戏 移动视频 短视频 2001504
非游戏 移动视频 在线视频 2001505
非游戏 移动视频 电视视频 2001506
非游戏 新闻资讯 网赚资讯 2001601
非游戏 新闻资讯 垂类资讯 2001602
非游戏 新闻资讯 综合资讯 2001603
非游戏 移动社区 问答社区 2001701
非游戏 移动社区 论坛贴吧 2001702
非游戏 移动社区 生活社区 2001703
非游戏 移动社区 微博社交 2001704
非游戏 移动社区 婚恋交友 2001705
非游戏 移动社区 社交交友 2001706
非游戏 体育 体育资讯 2001801
非游戏 体育 体育直播 2001802
非游戏 育儿母婴 孕育社区 2001901
非游戏 育儿母婴 经期健康 2001902
非游戏 育儿母婴 育儿工具 2001903

附录10. 广告二级、三级场景点与场景映射关系

一级场景点 二级场景点 二级场景点枚举值 三级场景点 三级场景点枚举值 场景映射枚举值 新广告场景
开屏类 开屏广告 FLASH 冷启动 FLASH_CODE FLASH 开屏广告
开屏类 开屏广告 FLASH 热启动 FLASH_HOT FLASH 开屏广告
开屏类 开屏广告 FLASH 不区分冷热启动 FLASH_OTHER FLASH 开屏广告
横幅类 横幅广告 FOCUS_POINT 固定在页面顶部 FOCUS_POINT_TOP BANNER 横幅广告
横幅类 横幅广告 FOCUS_POINT 固定在页面中部 FOCUS_POINT_MIDDLE BANNER 横幅广告
横幅类 横幅广告 FOCUS_POINT 固定在页面底部 FOCUS_POINT_BOTTOM BANNER 横幅广告
横幅类 横幅广告 FOCUS_POINT 固定在其他位置的广告 FOCUS_POINT_OTHER BANNER 横幅广告
信息流类 信息流广告 FLOW_NORMAL 出现的第1条广告 FLOW_NORMAL_1 FLOW 信息流广告
信息流类 信息流广告 FLOW_NORMAL 出现的第2条广告 FLOW_NORMAL_2 FLOW 信息流广告
信息流类 信息流广告 FLOW_NORMAL 出现的第3条广告 FLOW_NORMAL_3 FLOW 信息流广告
信息流类 信息流广告 FLOW_NORMAL 其他位置的广告 FLOW_NORMAL_0 FLOW 信息流广告
信息流类 沉浸式信息流广告 FLOW_IMMERSION 出现的第1条广告 FLOW_IMMERSION_1 FLOW 信息流广告
信息流类 沉浸式信息流广告 FLOW_IMMERSION 出现的第2条广告 FLOW_IMMERSION_2 FLOW 信息流广告
信息流类 沉浸式信息流广告 FLOW_IMMERSION 出现的第3条广告 FLOW_IMMERSION_3 FLOW 信息流广告
信息流类 沉浸式信息流广告 FLOW_IMMERSION 其他位置的广告 FLOW_IMMERSION_0 FLOW 信息流广告
插入式类 详情页插入广告 INSERTION_DETAIL 详情页文中 INSERTION_DETAIL_MIDDLE FOCUS_POINT 详情页插入广告
插入式类 详情页插入广告 INSERTION_DETAIL 详情页文末 INSERTION_DETAIL_TAIL FOCUS_POINT 详情页插入广告
插入式类 详情页插入广告 INSERTION_DETAIL 详情页其他位置的广告 INSERTION_DETAIL_OTHER FOCUS_POINT 详情页插入广告
插入式类 视频贴片广告 INSERTION_PASTE 前贴 INSERTION_PASTE_HEAD VIDEO_PASTE 视频贴片广告
插入式类 视频贴片广告 INSERTION_PASTE 中贴 INSERTION_PASTE_MIDDLE VIDEO_PASTE 视频贴片广告
插入式类 视频贴片广告 INSERTION_PASTE 后贴 INSERTION_PASTE_TAIL VIDEO_PASTE 视频贴片广告
插入式类 视频贴片广告 INSERTION_PASTE 暂停贴 INSERTION_PASTE_PAUSE VIDEO_PASTE 视频贴片广告
插入式类 插屏广告 INSERTION_INSERTION 插屏 INSERTION_INSERTION INSERTION 插屏广告
激励类 激励广告 REWARDED_APP 登陆奖励:每日登陆、打卡奖励 REWARDED_APP_LOGIN REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 过关奖励:过关、通关加倍 REWARDED_APP_PASS REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 线索提示:获得提示、生命复活/恢复 REWARDED_APP_TIPS REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 任务奖励:完成应用内指定任务 REWARDED_APP_TASK REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 价值奖励:限时解锁、功能试用 REWARDED_APP_TRY REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 兑换奖励:兑换应用内虚拟货币、付费功能 REWARDED_APP_COINS REWARDED_VIDEO 激励广告
激励类 激励广告 REWARDED_APP 其他奖励:其他类型奖励 REWARDED_APP_OTHER REWARDED_VIDEO 激励广告

附录11. 广告场景默认三级场景点

值(scene) 新广告场景(custom_position_scene) 三级场景默认值(custom_position_scene_level3) 三级场景默认值描述
FLOW 信息流广告 FLOW_NORMAL_1 信息流类-信息流广告-出现的第1条广告
FOCUS_POINT 详情页插入广告 INSERTION_DETAIL_OTHER 插入式类-详情页插入广告-详情页其他位置的广告
FLASH 开屏广告 FLASH_OTHER 开屏类-开屏广告-不区分冷热启动
VIDEO_PASTE 视频贴片广告 INSERTION_PASTE_HEAD 插入式类-视频贴片广告-前贴
BANNER 横幅广告 FOCUS_POINT_OTHER 横幅类-横幅广告-固定在其他位置的广告
REWARDED_VIDEO 激励广告 REWARDED_APP_OTHER 激励类-激励广告-其他奖励:其他类型奖励
INSERTION 插屏广告 INSERTION_INSERTION 插入式类-插屏广告-插屏

附录12. 二级场景点

二级场景点值 二级场景点描述
FLASH 开屏广告
FOCUS_POINT 横幅广告
FLOW_NORMAL 信息流广告
FLOW_IMMERSION 沉浸式视频流广告
INSERTION_DETAIL 详情页插入广告
INSERTION_PASTE 视频贴片广告
INSERTION_INSERTION 插屏广告
REWARDED_APP 激励广告

附录13. 实时竞价类型

实时竞价类型 类型描述
Server_Bidding 服务端竞价
Client_Bidding 客户端竞价

附录9. 用户洞察主渠道

描述
1 AMS
2 字节跳动
3 百度
4 搜狗
5 快手
6 OPPO
7 VIVO
8 华为
9 小米
10 应用宝
11 金立
999 其他
 文档反馈

腾讯公司 版权所有