GMG 互动广告API接入文档
目录
[if !supportLists]1. [endif]API接口说明
[if !supportLists]1.1. [endif]获取广告位信息（请求量）
[if !supportLists]1.1.1. [endif]请求地址
请求格式：http://test-api.gamagou.cn/req_std/{广告位ID}
示例：http://test-api.gamagou.cn/req_std/39668ef8af4b4a57b1648e1269421a27
[if !supportLists]1.1.2. [endif]请求方式
POST方式请求
[if !supportLists]1.1.3. [endif]请求参数（入参）
参数内嵌参数数据类型必填描述
allow JSONN广告位允许投放规则。 如果没有要求可以为空。
（此字段经过AES加密，并经过16进制编码）
tradeString[]N所属行业：
详见附件《行业分类》
adTypeStringN广告类型：
interaction:"互动", nonInteraction:"非互动"
urlsString[]N允许投放的连接：
["www.baidu.com","www.sina.com.cn"]
deny JSONN广告位禁投规则。 如果没有要求可以为空。
（此字段经过AES加密，并经过16进制编码）
tradeString[]N所属行业：
详见附件《行业分类》
adTypeStringN广告类型：
interaction:"互动", nonInteraction:"非互动"
urlsString[]N允许投放的连接：
["www.baidu.com","www.sina.com.cn"]
info JSONN广告位其它信息，如果没有可以为空。
（此字段经过AES加密，并经过16进制编码）
osStringN操作系统：
windows、macos、linux、ios、android
operatorStringN运营商：
dx:电信、yd:移动、lt:联通、wt:网通
networkStringN网络类型：
wifi、2G、3G、4G、line:有线宽带
browserStringN浏览器：
ie,chrome,firefox,safari,opera,edge,wechat,qq,360,uc,sougou,maxthon
devicetypeStringN设备类型：
PC、 Phone、PAD
uaStringNUser Agent
ipStringNIp地址
macStringN设备网卡MAC
imeiStringN移动设备ID（IOS）
idfaStringN移动设备ID（Android）
cookieStringN用户Cookie
makerStringN设备制造商
modelStringN设备型号
osvStringN设备操作系统版本号
screen_wStringN设备屏幕宽度
screen_hStringN设备屏幕高度
latdoubleNGPS纬度值
londoubleNGPS经度值
countryStringN设备当前所在国家
provStringN设备当前所在省份
cityStringN设备当前所在城市
commercialStringN设备当前所在商圈
[if !supportLists]1.1.4. [endif]返回参数
参数内嵌参数数据类型必填描述
statusCode IntY返回的状态码;
详情参见附件：《状态码》
message StringN返回的提示信息
data JSONN返回数据
adnumStringM返回的广告位数量
creativeImgJSONC素材对象
creativeUrl：素材的地址
width:素材的宽度
height素材的高度
impressionUrlsStringC展现上报的URL地址
landingPageStringC落地页的URL地址
clickUrlsStringC点击率上报的URL地址
[if !supportLists]1.1.5. [endif]示例
[if !supportLists]1.2. [endif]展现量上报
[if !supportLists]1.2.1. [endif]请求地址
请求格式：http://test-api.gamagou.cn/ms/{reqId }
示例：http://test-api.gamagou.cn/ms/b482d2245a684e66898cda6571af8d06
[if !supportLists]1.2.2. [endif]请求方式
POST方式请求
[if !supportLists]1.2.3. [endif]请求参数（入参）
reqId:广告位请求的ID
[if !supportLists]1.2.4. [endif]返回参数
[if !supportLists]1.3. [endif]点击率上报
[if !supportLists]1.3.1. [endif]请求地址
请求格式：http://test-api.gamagou.cn/mc /{reqId}
示例：http://test-api.gamagou.cn/mc/b482d2245a684e66898cda6571af8d06
[if !supportLists]1.3.2. [endif]请求方式
POST方式请求
[if !supportLists]1.3.3. [endif]请求参数（入参）
reqId:广告位请求的ID
[if !supportLists]1.3.4. [endif]返回参数
无需返回值
[if !supportLists]1.4. [endif]直接连接接入
[if !supportLists]1.4.1. [endif]使用说明：
对于不方便开发的媒体端，系统提供直接接入的方式，可以在投放计划中获取直接投放链接，只要将投放链接放在媒体端的广告位即可。
直接投放链接，也可以直接咨询工作人员获取。
直接连接分为长链和短链两种，使用长链的时候，主要复制完整的URL
[if !supportLists]1.4.2. [endif]长链请求地址
请求格式：http://test-api.gamagou.cn/simple/{url}
[if !supportLists]1.4.3. [endif]短链请求地址
请求格式：http://test-api.gamagou.cn/simple/{url}
示例：http://test-api.gamagou.cn/short/71ac471d5fdc7de6821152e7e86f5f3d
网友评论