媒体对接文档

接入须知

法律声明

媒体与本公司签订合同后，本公司向媒体提供对接协议作为指引文档。

未经我方书面许可，不得以任何形式向第三方披露、泄露有关本文档的任何内容。

修订历史

文档版本	修订日期	修订描述
2.0.0	2024-06-04	修改imp.adtype,imp.ctype,device.connection_type 定义
2.1.0	2024-06-05	增加response app定义，app_version下列字段，提供给app下载用
2.2.0	2024-07-12	增加设备启动时间等
2.3.0	2024-08-01	广告位宽高，formids信息变成必填，废弃tagid
2.4.0	2024-08-23	新增paid，caids字段
2.5.0	2024-08-27	增加imp.support_size_type 支持横竖版强制要求
2.6.0	2025-01-16	支持loss notice, 支持返回code & not biding reason
2.7.0	2025-02-11	添加华为媒体特殊字段支持: 响应中，bid.ext新增huawei_cat、language、advertiser字段，img和video新增mime字段
2.8.0	2025-02-20	支持请求Ext字段，增加流量来源标识
2.9.0	2025-04-18	请求Imp中支持填入多个广告位尺寸
2.9.1	2025-10-01	优化video事件上报字段

[TOC]

整体流程

本文档描述媒体方如何通过客户端c2s的方式或者服务端s2s的方式请求我方SSP广告系统的通用接口。

基本流程如下：

媒体方向SSP发送广告请求，请求数据见BidRequest说明。
SSP内部通过竞价产生出合适的广告，SSP将内部竞价成功的广告返回给向媒体方，返回数据格式详情见BidResponse说明。
媒体上报返回的曝光点击监控等。

广告竞价

所有参数均采用UTF-8编码。

HTTP请求类型

媒体方设置HTTP Method为POST。

HTTP请求Header

媒体方设置Content-type为application/json

媒体方设置在条件允许的前提下使用长链接来持续发起广告请求。

1. 广告请求Bid Request说明

字段	类型	必须	说明
id	string	Y	请求唯一ID
imp	object[]	Y	广告位信息，1.1imp对象
app	object	Y	媒体的app信息 1.2app对象
device	object	Y	设备信息
site	object	N	站点信息对象，浏览器端
user	object	N	用户信息对象
tmax	int	N	超时时间（毫秒），默认100ms
test	bool	N	测试模式，默认false
ext	object	N	扩展字段，详见章节1.8

1.1 Imp 对象

字段	类型	必须	说明
id	string	Y	imp唯一id
slotid	string	Y	平台分配的广告位id，推荐使用平台分配广告位id
tagid	string	N	媒体方广告位ID，废弃, 不使用
w	int	Y	广告位宽，推荐必填
h	int	Y	广告位高，推荐必填
sizes	Size[]	N	额外可支持的广告位尺寸
minduration	int	N	视频广告最小播放时长，单位：秒
maxduration	int	N	视频广告最大播放时长，单位：秒
formids	int[]	Y	广告广告展现形式ids，见附录1。推荐必填
adtype	int	N	广告位类型（1 ：视频贴片， 2 ：视频暂停，3. 视频悬浮，4 ：横幅， 5 ：开屏， 6 ：插屏， 7 ：信息流，8：文字链， 10：激励视频）。
ctype	int[]	N	允许的素材类型 (1: JPG，2. PNG， 3：GIF， 4：JPEG， 5：SWF， 6：MP4， 7：FLV， 8：文字链， 9：信息流， 10：视频信息流 )。
bidfloor	float	N	底价（分/cpm）
bidtype	int	N	售卖方式，0：cpm；1：cpc ，default = 0
pmp	PMP[]	N	PMP 模式
secure	int	N	是否只支持https,0-无要求，http和https都支持；1-只支持https
support_interact	int[]	N	支持的交互类型（0：不限；1：webview；2：下载；3：微信小程序唤起；4：deeplink唤起），为空或者传0则默认都支持
support_size_type	int[]	N	支持的素材的横竖版判断，1：横版，2：竖版。支持多选，不填则为不限。

1.2 Size 对象

字段	类型	必须	说明
w	int	Y	广告位宽
h	int	Y	广告位高

1.3 App 对象

字段	类型	必须	说明
id	string	N	app id
name	string	N	app name
ver	string	N	app 版本
sdk_version	string	N	sdk版本
bundle	string	N	app 包名
cat	string[]	N	app 类型

1.4 Device 对象

字段	类型	必须	说明
imei	string	N	设备号，IMEI（安卓设备imei，imeimd5至少一个必填）
imeimd5	string	N	设备号的imei MD5值，32位小写
oaid	string	N	设备标识，OAID（安卓10以上，oaid,oaidmd5至少一个必填）
oaidmd5	string	N	设备标识的oaid MD5，32位小写
aid	string	N	Android Id
aidmd5	string	N	Android Id 的 MD5，32位小写
idfa	string	N	Ios唯一标示，idfa原值（ios系统idfa，idfamd5至少一个必填）
idfamd5	string	N	idfa的md5, 32位小写
caid	string	N	IOS14后idfa的替代方案，广协caid
caid_version	string	N	caid sdk版本号，多个使用最新版本
ali_aaid	string	N	ali aaid,需对接ali aaid sdk，可不填
os	int	N	操作系统（0 ：未知，1 ：ios，2 ：android，3 ：windows phone， 4 : symbian， 5 ：windows， 6 ：Mac OS，7：其他）
osv	string	N	操作系统版本号字符串
make	string	N	设备制造商同brand
model	string	N	设备型号
devicetype	int	N	设备类型 1：手机；2：PAD ；3:移动设备；4: PC；5：智能电视
ip	string	N	ip
mac	string	N	mac 地址
macmd5	string	N	mac地址的md5
ua	string	N	user agent
carrier	int	N	运营商 0：未知；1：移动；2：联通；3：电信
connection_type	int	N	网络类型 0：其他；1：WIFI；2：2G；3：3G；4：4G；5：5G；6：局域网
sw	int	N	屏幕宽
sh	int	N	屏幕高
den	float	N	屏幕密度
ori	int	N	屏幕方向 1：竖屏，2：横屏，0：未知
geo	object	N	地域信息
boot_mark	string	N	系统启动标识，取原值回传。 iOS：1623815045.970028；Android：ec7f4f33-411a-47bc-8067-744a4e7e0723
update_mark	string	N	系统启动标识，取原值回传。 iOS：1581141691.570419583；Android：1004697.709999999
verCodeOfHms	string	N	HMS Core 版本号。实现被推广应用的静默安装依赖 HMS Core 能力，华为设备必填: 61504322
verCodeOfAG	string	N	应用市场版本号。与下载类广告的转化路径有关。华为设备必填: 150601300
agCountry_code	string	N	应用市场中设置的国家地区，华为设备推荐填，例：CN
device_name	string	N	设备名
device_model	string	N	硬件机型如"iPhone10,3"
device_init_time	string	N	系统初始化时间, PDD iOS参数: 1611888252.123456789
device_startup_time	string	N	系统启动时间, PDD iOS参数: 1763878638
device_upgrade_time	string	N	系统更新时间, PDD iOS参数: 1611888252.123456
system_total_mem	int64	N	系统总内存，单位：KB
system_free_mem	int64	N	系统剩余内存，单位：KB
system_total_disk	int64	N	系统总磁盘，单位：KB
system_free_disk	int64	N	系统剩余磁盘，单位：KB
language	string	N	例：zh-Hans-CN
ppi	int	N	屏幕 ppi
paid	string	N	拼多多paid
caids	[]string	N	历史版本caid，格式：version+_+ caid ，(CaidVersion+下划线+Caid)

1.5 Geo 对象

字段	类型	必须	说明
lat	float	N	纬度
lon	float	N	经度
geotype	int	N	geo坐标系类型（1: WGS84，2:GCJ_02火星，3:BD_09百度，4:BD_09_LL百度墨卡）
city	string	N	城市名

1.6 Site 对象

字段	类型	必须	说明
name	string	N	站点名称
domain	string	N	站点域名
page	string	N	当前站点页面url
ref	string	N	Referrer url

1.7 User 对象

字段	类型	必须	说明
id	string	N	媒体端用户id，一般pc和wap端为媒体cookie id
gender	string	N	性别（M: 男，F: 女，缺省：未知）
age	int	N	年龄
audience_tag	string[]	N	兴趣标签，标签体系线下沟通
app_list	string[]	N	用户app安装列表

1.8 PMP 对象

字段	类型	必须	说明
deal	string	Y	deal id
price	int	N	deal 价格，单位：分

1.9 Ext 对象

字段	类型	必须	说明
source	string	N	流量来源标识，例如: huawei, xiaomi, sina, ...

附录

1. 广告展现形式id（formid)

形式id	说明
1	一图二文标题描述
2	一图一文
3	单图片
4	单视频
5	三图文
6	一图一视频
7	一图一icon
8	文字链
9	三图一icon

2. 广告响应Bid Response说明

正常竞价返回 HTTP 200 OK，同时返回body。

无广告返回。

字段	类型	必须	说明
id	string	Y	response id 和request id保持一致
seatbid	object[]	N	如果参与竞价，必须包含一个seatbid对象， 2.1seatbid对象
bidid	string	N	由ssp生成的response id
code	int	N	接口返回码，0：成功（默认情况），其他情况下返回错误码，详见章节2.12
msg	string	N	成功时默认返回空字符串，其他情况下返回对应的错误内容，详见章节2.12

2.1 SeatBid 对象

字段	类型	必须	说明
seat	string	Y	ssp为广告主分配的广告主id。
bid	object[]	Y	竞价信息 2.2bid对象

2.2 Bid 对象

字段	类型	必须	说明
id	string	Y	ssp生成的bid id，用于追踪或打log
impid	string	Y	bid request中对应的Imp对象id
price	float	Y	出价，单位：分
dealid	string	N	PDB、PD模式必选
crid	string	Y	创意id，需素材审核的广告位该字段不为空
nurl	string	N	竞价成功通知url，需要支持宏替换，见章节3.2
lurl	string	N	竞价失败通知url，需要支持宏替换，见章节3.2
adm	object	N	广告物料，Native对象，非素材审核的广告位该字段不为空，见章节2.4
imp_trackers	string[]	N	曝光上报地址，需要支持宏替换，见章节3.2
click_trackers	string[]	N	点击上报地址，需要支持宏替换，见章节3.2
down_start_trackers	string[]	N	下载开始上报地址，需要支持宏替换，见章节3.2
down_comp_trackers	string[]	N	下载完成上报地址，需要支持宏替换，见章节3.2
install_start_trackers	string[]	N	安装开始上报地址，需要支持宏替换，见章节3.2
install_comp_trackers	string[]	N	安装成功上报地址，需要支持宏替换，见章节3.2
video_trackers	object[]	N	(已弃用)视频监测链接数组，需要支持宏替换，见章节3.2
dp_trackers	string[]	N	dp唤起成功监测链接，需要支持宏替换，见章节3.2
video_start_trackers	string[]	N	视频播放开始事件上报地址，需要支持宏替换，见章节3.2
video_complete_trackers	string[]	N	视频播放完成事件上报地址，需要支持宏替换，见章节3.2
video_close_trackers	string[]	N	视频播放中途关闭事件上报地址，需要支持宏替换，见章节3.2
video_first_quartile_trackers	string[]	N	视频播放进度25%事件上报地址，需要支持宏替换，见章节3.2
video_mid_point_trackers	string[]	N	视频播放进度50%事件上报地址，需要支持宏替换，见章节3.2
video_third_quartile_trackers	string[]	N	视频播放进度75%事件上报地址，需要支持宏替换，见章节3.2
ext	object	N	扩展字段，见章节2.11

2.3 Video Tracker 对象

字段	类型	必须	说明
event	int	Y	曝光上报时间点，单位秒
url	string	Y	监测地址

2.4 Adm 对象

字段	类型	必须	说明
title	string	N	标题
desc	string	N	描述
img	object[]	N	图片
video	object	N	视频
land	string	N	落地页
interact	int	N	交互类型（1：webview；2：下载；3：微信小程序唤起；4：deeplink唤起）
ctype	int	N	创意类型(1: JPG，2. PNG， 3：GIF， 4：JPEG， 5：SWF， 6：MP4， 7：FLV， 8：文字链， 9：信息流， 10：视频信息流，11：激励视频 )
formid	int	N	广告展现形式Id
dplink	string	N	deeplink。dplink 包括schemelink或者universalLink地址;当返回dplink时，interact需要返回4，同时落地⻚页land字段返回h5点击地址，作为deeplink唤起失败的打底地址;
app	object	N	app下载类应用可能包含的推广信息
ext	object	N	对物料的附加信息，章节2.10

2.5 Image 对象

字段	类型	必须	说明
url	string	Y	图片url
w	int	Y	宽
h	int	Y	高
md5	string	N	素材MD5
mime	string	Y	素材格式。主要有image/jpg,image/gif,image/png

2.6 Video 对象

字段	类型	必须	说明
url	string	Y	原生视频信息流视频地址
w	int	Y	宽
h	int	Y	高
duration	int	N	时长，单位：秒
filesize	int	N	视频大小, 单位：KB
md5	string	N	素材MD5
mime	string	Y	素材格式。主要有video/mp4,video/flv,video/webm

2.7 App 对象

字段	类型	必须	说明
name	string	N	app下载类包含的推广信息
icon	string	N	app下载类包含的icon信息
package_name	stirng	N	app下载类或者deeplink包含的包名信息
wechat_ext	object	N	微信小程序相关信息
app_id	string	N	app下载类型包含的app id，仅ios下提供
app_version	string	N	app下载类应用版本
package_size	int	N	app下载类包体大小, 单位：KB
privacy	string	N	app下载类隐私协议URL
permission	string	N	app下载类应用权限URL
permission_desc	[]PermissionDesc	N	app下载类应用权限描述，详⻅2.8章节
app_desc	string	N	app下载类应用功能描述文案
app_desc_url	string	N	app下载类应用功能描述URL
develop	string	N	app下载类应用开发者
app_beian	string	N	app备案号
app_age	string	N	app适用年龄 18表示18+

2.8 PermissionDesc对象

段	类型	必须	说明
permission_lab	stirng	N	权限名称
permission_desc	string	N	权限用途说明

2.9 WechatExt 对象

字段	类型	必须	说明
program_id	stirng	N	小程序id号
program_path	string	N	小程序页面路径

2.10 Ext 对象

字段	类型	必须	说明
icon	string	N	物料的icon
logo	string	N	广告主logo
advertiser_name	string	N	广告主名称
sub_title	string	N	广告副标题
btn	string	N	按钮文字

2.11 bid.Ext 对象

字段	类型	必须	说明
huawei_cat	string	N	华为的广告主行业分类
language	string	N	创意的语言。比如zh,en
advertiser	string	N	广告主的名称。也就是广告来源

2.12 错误码

错误码（code）	错误描述（msg）
0	请求成功
400	解析请求失败
401	请求参数错误
402	无效的设备
403	请求媒体ID无效
404	无效的媒体广告位ID
405	ip黑名单
406	设备ID黑名单
407	请求中imp信息为空
408	请求中device信息为空
409	请求IP无效
500	系统内部错误
501	响应媒体超时
502	响应媒体数据错误

3. 监测上报和宏替换说明

3.1 上报说明

媒体对竞价成功的SSP，发送获胜通知（nurl），协议为HTTP GET；
媒体对竞价失败的SSP，发送竟败通知（lurl），协议为HTTP GET；
在广告被曝光时并行上报多组展现监测(imp_trackers)
在广告被点击时，并行上报多组点击监测（clk_trackers），同时进行跳转
对于有下载监测需求的广告，需要回传下载进度
对于有deeplink唤起监测需求的广告，需要回传deeplink唤起数

3.2 宏替换说明

需要支持以下宏替换：

Macro	Descrption
__PRICE__	竞拍价(次高价结算)，rtb结算下需要替换该宏，单位为分
__DOWN_X__	鼠标或手指按下时相对于素材的X坐标，clk_tracking/dplink/land需要替换
__DOWN_Y__	鼠标或手指按下时相对于素材的Y坐标，clk_tracking/dplink/land需要替换
__UP_X__	鼠标或手指弹起时相对于素材的X坐标，clk_tracking/dplink/land需要替换
__UP_Y__	鼠标或手指弹起时相对于素材的Y坐标，clk_tracking/dplink/land需要替换
__WIDTH__	广告所占屏幕的宽度
__HEIGHT__	广告所占屏幕的高度
__HW_SLD__	华为SLD宏

3.2.1 价格宏替换说明

价格宏替换可以选择明文替换或者加密替换。

价格为CPM价格，单位为分。

1.使用明文替换

价格宏替换使用明文替换。

2.加密替换

加密算法如下：

https://developers.google.com/authorized-buyers/rtb/response-guide/decrypt-price?hl=zh-cn

注意其中base64使用web safe base64，且是nopadding模式

在完成对接后，请联系系统运营获取系统分配的密钥

测试用例

ekey = "6087d837248d32698334bf4cc0eb67b1"; ikey = "SznRK5aU44UyUb3aY0jdokLiNxi93qFY";

1B2M2Y8AsgTpgAmY7PhCfvqWMP8e_kZGMbnTUg -> 12 1B2M2Y8AsgTpgAmY7PhCfvqWMP8e_kN8Qqdc4A -> 1334

4. 请求和响应示例

4.1 请求示例

{
  "id": "u4qmILh1JN9ajbRqXer4yTzNz9jl1Mzl",
  "imp": [
    {
      "id": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz",
      "slotid": "1018",
      "w": 414,
      "h": 896,
      "bidfloor": 39,
      "bidtype": 0,
      "formids": [1, 2, 3, 4],
      "ctype": [1, 2, 3, 6, 9],
      "adtype": 7
    }
  ],
  "app": {
    "id": "13304029",
    "name": "test",
    "ver": "1.0.1",
    "sdk_version": "1.1.0.1",
    "bundle": "com.test.demo"
  },
  "device": {
    "idfa": "4356CF32-DDA4-483E-8F9C-5970F6946C5E",
    "idfamd5": "848db21db0b5a60833632670906e219c",
    "mac": "2cfdabd034a9",
    "imei": "869952030827861",
    "os": 1,
    "osv": "14.6",
    "make": "Apple",
    "model": "iPhone12,1",
    "ip": "223.72.87.18",
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "carrier": 2,
    "connection_type": 1,
    "sw": 414,
    "sh": 896,
    "ori": 2,
    "boot_mark": "1714256771.567281"
  }
}

4.2 响应示例

{
  "seatbid": [
    {
      "bid": [
        {
          "imp_trackers": [
            "http://l.test.monitor.com/imp?price=__PRICE__",
            "http://www.imp1.com/0",
            "http://www.imp2.com/1"
          ],
          "nurl": "http://l.test.monitor.com/wnotice?price=__PRICE__",
          "lurl": "http://l.test.monitor.com/lnotice?price=__PRICE__",
          "crid": "1234",
          "click_trackers": [
            "http://l.test.monitor.com/click?a=1&b=2",
            "http://www.click1.com/click0",
            "http://www.click2.com/click1"
          ],
          "adm": {
            "formid": 3,
            "img": [
              {
                "h": 640,
                "w": 360,
                "url": "http://www.img.jpg"
              }
            ],
            "ctype": 1,
            "interact": 1,
            "land": "http://www.baidu.com"
          },
          "id": "1323132131",
          "price": 500,
          "impid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz"
        }
      ],
      "seat": ""
    }
  ],
  "bidid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz",
  "id": "u4qmILh1JN9ajbRqXer4yTzNz9jl1Mzl",
  "code": 0
}

4.2.2 视频广告

{
  "seatbid": [
    {
      "bid": [
        {
          "imp_trackers": ["http://l.test.monitor.com/imp?price=__PRICE__"],
          "nurl": "http://l.test.monitor.com/wnotice?price=__PRICE__",
          "lurl": "http://l.test.monitor.com/lnotice?price=__PRICE__",
          "crid": "12235",
          "click_trackers": ["http://l.test.monitor.com/click?a=2&b=3"],
          "adm": {
            "formid": 4,
            "video": {
              "url": "http://www.video.mp4",
              "h": 360,
              "w": 640
            },
            "ctype": 6,
            "interact": 1,
            "land": "http://www.baidu.com"
          },
          "id": "13231313",
          "price": 1500,
          "impid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz"
        }
      ],
      "seat": ""
    }
  ],
  "bidid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz",
  "id": "u4qmILh1JN9ajbRqXer4yTzNz9jl1Mzl",
  "code": 0
}

4.2.3 信息流广告

{
    "seatbid": [
        {
            "bid": [
                {
                    "imp_trackers": [
                        "http://l.test.monitor.com/win?price=__PRICE__"
                    ],
                    "nurl": "http://l.test.monitor.com/wnotice?price=__PRICE__",
                    "lurl": "http://l.test.monitor.com/lnotice?price=__PRICE__",
                    "crid": "13231233",
                    "click_trackers": [
                        "http://l.test.monitor.com/click?a=1&b=2"
                    ],
                    "adm": {
                        "img": [
                            {
                                "h": 360,
                                "w": 690,
                                "url": "https://www.jpg"
                            }
                        ],
                        "desc": "测试描述",
                        "title": "测试标题",
                        "formid": 1,
                        "ctype": 9,
                        "interact": 1,
                        "land": "http://www.baidu.com"
                    },
                    "id": "3582132313
                    "price": 200,
                    "impid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz"
                }
            ],
            "seat": ""
        }
    ],
    "bidid": "sbqXo8iOVz3CptLdTIbEuaQJd1FErubz",
    "id": "u4qmILh1JN9ajbRqXer4yTzNz9jl1Mzl",
  	"code": 0
}

5. 联调说明

媒体方可以直接访问测试环境竞价地址获取广告。

联调地址、mid和广告位线下提供

mid 和线上请求地址，正式投放由ssp运营提供

6. 补充说明

一、针对rta效果投放的请求，字段可以缩减；

二、转化数据回传（媒体可以不接入）：

1）支持动态回调。

response.click_tracker为系统的点击监测，点击监测上**支持__CBURL__可以供媒体动态替换成媒体侧的cpa回调地址，我方会在有转化时通过 callback url 回传给媒体（服务端回调）。**针对动态回调，将会在媒体传入的 callback_url 地址后拼接event_type。

event_type：
激活：1；
注册：2；
授信：3；
付费：4；
次留：5；
唤起应用：6；
下载：7；

例如：媒体callback_url 为 http://xxxx.com?param1=a，激活回调为 http://xxxx.com?param1=a&event_type=1

2）支持静态回调。

媒体线下将cpa回调地址callback给到我方，回调地址需要支持我方的宏替换规则。具体见文档-监测说明。我方会在有转化时，对callback url 进行宏替换后，回传给媒体（服务端回调）

以下为请求的示例：

{
  "id": "070c9ee9-3ef3-4577-95ce-75d6af626f82",
  "imp": [
    {
      "id": "1", //rta的token
      "tagid": "1" //填成跟id一样，系统投放定向需求
    },
    {
      "id": "2", //rta的token,跟id填一样
      "tagid": "2" //填成跟id一样，系统投放定向需求
    }
  ],
  "app": {
    "id": "1603040292218.app.ln",
    "name": "test",
    "ver": "9.7.0.88",
    "sdk_version": "1.1.0.1",
    "bundle": "com.lestore.ad.demo"
  },
  "device": {
    "ua": "com.lenovo.leos.appstore/9.7.0.88(Lenovo L38012; OS Android8.0.0)",
    "ip": "111.205.43.250",
    "mac": "2cfdabd034a9",
    "imei": "869952030827861",
    "carrier": 0,
    "make": "lenovo",
    "model": "Lenovo L38012",
    "os": 2,
    "osv": "8.0",
    "devicetype": 1,
    "connection_type": 4,
    "den": 0,
    "ori": 1,
    "sw": 720,
    "sh": 1142
  }
}

响应示例，其中__CBURL__可以供媒体动态替换成媒体侧的cpa回调地址，我方会在有转化时回调该地址：

{
    "seatbid":[
        {
            "bid":[
                {
                    "click_trackers":[
                        "http://l.test.monitor.com/click"
                    ],
                    "impid":"1"//对应imp.id，即rta的token
                },
                {
                    "click_trackers":[
                        "http://l.test.monitor.com/click?cb=__CBURL__"
                    ],
                    "impid":"2"//对应imp.id，即rta的token
                }
            ]
        }
    ],
    "bidid":"1603040292218_243582",
    "id":"070c9ee9-3ef3-4577-95ce-75d6af626f82"
}

接入须知​

修订历史​

整体流程​

广告竞价​

1. 广告请求Bid Request说明​

1.1 Imp 对象​

1.2 Size 对象​

1.3 App 对象​

1.4 Device 对象​

1.5 Geo 对象​

1.6 Site 对象​

1.7 User 对象​

1.8 PMP 对象​

1.9 Ext 对象​

附录​

1. 广告展现形式id（formid)​

2. 广告响应Bid Response说明​

2.1 SeatBid 对象​

2.2 Bid 对象​

2.3 Video Tracker 对象​

2.4 Adm 对象​

2.5 Image 对象​

2.6 Video 对象​

2.7 App 对象​

2.8 PermissionDesc对象​

2.9 WechatExt 对象​

2.10 Ext 对象​

2.11 bid.Ext 对象​

2.12 错误码​

3. 监测上报和宏替换说明​

3.1 上报说明​

3.2 宏替换说明​

3.2.1 价格宏替换说明​

测试用例​

4. 请求和响应示例​

4.1 请求示例​

4.1.1 Banner / 开屏 / 信息流​

4.2 响应示例​

4.2.1 Banner / 开屏 等图片​

4.2.2 视频广告​

4.2.3 信息流广告​

5. 联调说明​

6. 补充说明​