腾讯优量汇 Media API 接入文档
Version: 1.1.46
法律声明
对需要对接腾讯优量汇(以下简称优量汇)Media API的客户,优量汇提供此文档作为对接的指引文档。未经优量汇书面许可,不得以任何形式向第三方披露、泄露有关本文档的任何内容。优量汇拥有修改、调整、增补本文档的权利,并在法律允许范围内对本文档拥有最终解释权。
版本管理
本API文档目前统一为1.1.46版本,所有接口于2020年9月11日统一升级为1.1版本,其中,
- 媒体创建接口和修改接口、报表接口、图片接口1.1版本均兼容1.0版本;
- 广告位创建接口和修改接口1.1版本不兼容1.0版本,1.0版本不再维护,请开发者尽快将广告位创建接口和修改接口升级到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版本变更关键点
- 开屏将开屏广告样式更新为图片、5秒视频,开屏V+更新为5~30秒长视频+首屏续播、图片、5秒视频并支持修改。
- 激励广告、插屏全屏、横幅广告/信息流/详情页/贴片/沉浸式视频流自渲染支持修改。
1.1.31版本变更关键点
- 增加物理广告位管理相关接口,具体参见接口详述物理广告位模块。
- 广告位创建或修改时支持设置物理广告位,广告位查询接口响应字段增加物理广告位id。
1.1.30版本变更关键点
- 新增小时级数据查询接口,接口支持获取当天和最近7天共8天的小时级数据,每次查询时可查一天的小时级数据,指标包括预估收入、曝光、千次展示收入、点击量、点击率,具体参见接口4.4.2。
- 只有过去7天bidding收入占比不少于30%的开发者,才有使用该接口的权限。
1.1.28版本变更关键点
- 设置实时竞价广告位不再受收入门槛限制。
- 为帮助开发者提升和监控实时竞价(bidding)变现效果,Media API增加相关指标,包括:竞胜回传量、竞败回传量、竞价结果回传量、广告及广告位竞价结果回传率、竞胜率、竞胜曝光率,详细数据口径与合理值参考区间可见Media API报表接口相关字段。
- 如您发现上述指标异常,可前往优量汇官网帮助中心查看常见问题与诊断排查指引。
1.1.25版本变更关键点
- 为细化请求链路展示,帮助您变现调优,平台升级了下列指标口径:广告位请求量、广告请求量、广告位填充率、广告填充率。
- 本次更新不会变更收入相关数据。
1.1.24版本变更关键点
- 新增数据保护协议签署状态的校验(2022年4月5日开始)。为了共同营造更健康透明的广告生态,确保广告合规和个人信息保护工作有效落地, 请您尽快访问开发者平台完成《数据保护协议》的线上签署, 以免影响您在Media API和开发者平台的正常使用。
1.1.22版本变更关键点
- 新增支持实时竞价配置。设置前须满足:签署实时竞价协议(请到开发者平台签署)&收入满足竞价广告位配置条件。同媒体下支持设置的实时竞价广告位有数量上限。
- 价格策略类型的枚举值新增实时竞价,详见附录8. 价格策略。创建或更新广告位时,如果价格策略类型设置为实时竞价,则必须填写 实时竞价类型。
- 对于实时竞价广告位,解冻时如果同媒体下实时竞价广告位数目已达到上限,则无法解冻。
1.1.20版本变更关键点
- 新增二级广告场景沉浸式视频流 附录10. 广告二级、三级场景点与场景映射关系;
- 插屏广告-优量汇渲染-模板2.0,半屏新增支持弹窗比例1:1 模板类型 ad_crt_template_type;
- 开发者自渲染,5个场景支持素材类型&素材规格的扩充 附录3.1 自渲染广告样式规格;
1.1.18版本变更关键点
- 新增合规承诺函签署状态的校验(2021年12月15日开始)。为了共同营造更健康透明的广告生态,确保广告合规和个人信息保护工作有效落地, 请您尽快访问开发者平台完成《合规承诺函》的线上签署, 以免影响您在Media API和开发者平台的正常使用。
1.1.15版本变更关键点
- 7个广告场景下细分三级场景点 附录10. 广告二级、三级场景点与场景映射关系;
- 创建广告位时可以使用场景(scene)或者三级场景点(custom_position_scene_level3)设置广告位场景,场景参数必须二选一;使用场景时会默认填写三级场景点,默认值映射广告场景默认三级场景点。
- 7个广告场景的内容与定义做了调整,详情见术语介绍部分 。
1.1.14版本变更关键点
- 创建广告位支持平台模板渲染2.0 模板版本生成规则;平台模板渲染2.0支持模板类型多选、素材类型多选。
- 不支持平台模板渲染的自定义模板(包括:新建广告位、编辑广告位)
1.1.12版本变更关键点
- 新增测试媒体、测试广告位的功能,需要开通白名单。白名单申请,请在线联系优量汇客服。
- 测试媒体的创建,只支持操作系统=APP类型,即os参数仅支持1-Android, 2-iOS。
- 测试广告位的创建,只支持接入方式=SDK类型,即ad_pull_mode仅支持SDK,参见附录#接入方式。
1.1.5版本变更关键点
- 查询报表接口:增加Content-Type格式要求为application/json;不再支持multipart/form-data格式;请开发者做相应调整。
1.1.3版本变更关键点
- 广告场景替代广告位类型的概念,开发者可根据自身需求创建不同的广告场景下的广告位。广告场景与广告位类型的映射关系参见附录5
- 广告位模块切换:
- 对外发布的文档更新为新接口;
- 旧接入的开发者,新旧两套接口都支持调用;
- 新接入的开发者,仅支持新接口调用;
- 新接口创建和更新的请求body改为json格式;
- 1.0版本旧接口不再维护升级,后续下线;
- 目前报表模块依然提供按照不同广告位类型的广告效果数据,后续提供按照不同广告场景的广告效果数据;
1.1.1版本变更关键点
- Media API中过去以mediumid和app_id两个参数均指代媒体id,为了减少混淆进行了优化,统一使用app_id作为媒体id的唯一标识,提醒开发者注意并修改:
- 识别媒体id只需要以app_id为准;
- app_id值与以前mediumid值是不同的值;
1. 关于文档
流量主可以通过对接Media API拥有强大的系统管理能力,更便捷地进行流量管理及快速对接广告统计数据,帮助流量主提升流量变现效率。
Media API提供的功能包含以下部分:
- 媒体模块:创建媒体、修改媒体
- 广告位模块:创建广告位、修改广告位
- 报表模块:查询广告效果数据
2. 背景知识
2.1 术语介绍
- 媒体:包括移动应用(APP)和移动网站;
旧广告场景(scene)定义:
- 开屏:APP开启后全屏沉浸式展示广告
- 动态信息流:广告与APP内容高度自然融合的信息流广告
- 激励视频:用户通过体验某项服务以获取应用内奖励
- 横幅:以较大的矩形区域展示的详情页插入广告
- Banner:在APP顶/中/底部悬浮且可关闭的边栏广告
- 插屏:在弹出窗口上展示的广告
- 视频贴片:在视频片头片尾或随片播放的广告
新广告场景(custom_position_scene)定义:
- 开屏广告:用户启动或切换回 App 时展示的广告
- 信息流广告:App 推荐列表(信息流)里展示的广告
- 激励广告:用户主动体验服务以获取 App 内奖励时展示的广告
- 详情页插入广告:App 详情页内随内容呈现插入展示的广告
- 横幅广告:固定在 App 页面内顶/中/底部展示的广告
- 插屏广告:在 App 自然停顿和切换时弹出展示的广告
- 视频贴片广告:在视频片头、片尾或随片播放展示的广告
- 沉浸式视频流广告:沉浸式视频类内容浏览场景展示的广告
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请求
HTTP Method
如无特殊说明,add、update API请求的HTTP Method为POST;get API请求的HTTP Method均为GETHTTP Header
调用方应遵循HTTP协议设置相应的Header,目前支持的Header有:Content-Type用于指定数据格式。POST请求数据默认格式为:multipart/form-data ,具体情况请参考接口的详细说明文档。HTTP Header示例
Content-Type: multipart/form-data
4.1.6 API响应
- HTTP状态码
支持HTTP标准状态码,具体如下:
状态码 | 名称 | 描述 |
---|---|---|
200 | 成功 | 当 API 请求被正确处理,且能按设计获取结果时,返回该状态码; 亦适用于批量接口返回部分结果 |
3xx | 跳转 | 在特定情况下,API 可能会返回这些状态码; 建议调用方按照 HTTP 标准来处理 |
4xx | 客户端错误 | 由客户端原因造成的错误 |
5xx | 服务器端错误 | API 或其下层服务发生内部错误 |
其中,4xx 和 5xx 的状态码仅用于辅助调用方快速识别问题,不作为包含实际语义的错误码,若有调整也不另行通知,实际操作结果以API返回的数据为准。调用方也应能够识别和处理由于网络异常等因素导致的,由非API 服务返回的 HTTP 状态码,如 504 Gateway Timeout 等。
- HTTP Header
目前API响应的Content-Type为application/json。
- HTTP Body
响应的JSON数据中包含三部分内容,分别为返回码、返回信息和数据,如下表所示:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
code | int32 | 是 | 返回码:0表示成功 |
message | string | 是 | 返回信息:若有错误,此字段为详细的错误信息 |
data | json array 或 json object | 否 | 结果数据 |
4.2 媒体模块
规则说明:
- 创建修改媒体,以app_id作为媒体id的唯一识别
- 只有审核通过的媒体才可以修改
- 每个开发者最多可创建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 彻底删除媒体
规则说明:
- 最近30天无消耗的媒体可以彻底删除。封禁、违规暂停的媒体不可删除。
- 删除后媒体下的符合彻底删除规则的广告位也会彻底删除。
请求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 广告位模块
规则说明:
- 每个媒体最多可创建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 删除广告位
规则说明:
- 处于自动优化层的广告位不得删除;
- 资讯广告位不得删除。
请求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 彻底删除广告位
规则说明:
- 广告位当前状态是冻结或者已删除(调用过4.3.4 删除广告位接口)并且7天无消耗的广告位可以彻底删除。封禁、违规暂停的广告位不可删除。
- 删除后RTB广告位关联关系同步删除。
- 删除后广告位与绑定的流量包自动解绑。
请求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双方广告位映射关系
规则说明:
- 只有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
支持查询参数:
- 目前已支持广告场景2级数据查询,广告位类型字段会逐步废弃,请开发者尽快更新
参数名称 | 参数类型 | 参数描述 | 参数限制 | 是否必填 |
---|---|---|---|---|
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 | 其他 |