科大讯飞移动广告平台Server to Server接入说明

70200 – success 70204 – no fill
result info in English
result info in Chinese
material type html/meta
2.2.2 普通广告信息
标签
类型
含义
取值范围
6
adtype html impr_url
click_url
iOS IDFA mac 地址
Y for iOS>=6 IDFA
Y(ios 6 以上取 MAC 不到)
AAID(Advertising Id) Recommended Advertising Id for Android
Windows Phone 用 Y for WP 户终端的 DUID
DUID
屏幕密度
不是下载）
string string string
url of video or audio file
duration of 单位毫秒 video or audio
landing url
音频广告为空
string array
exposure of start
必填 Y
Y
说明 当前版本号：2.0
iflyEncryption：讯飞 如该参数缺
加密算法，none 表 失，则默认为
示不加密
none
2.2 广告请求下行
2.2.1 公共信息
标签
rc
类型
int
info_en
string
info_cn
string
matype
string
含义
result code
取值范围
移动广告平台 Server to Server 接入说明
string
type of AD
redirect
string
html content
string array
exposure of impression
string array
exposure of click
2.2.3 原生广告信息
标签
batch_cnt
2.1 广告请求上行 ......................................................................................................................... 2 2.1.1 广告位信息 ..................................................................................................................... 2 2.1.2 设备系统信息 ................................................................................................................. 2 2.1.3 应用信息 ......................................................................................................................... 5
2.2 广告请求下行 ......................................................................................................................... 6 2.2.1 公共信息 ......................................................................................................................... 6 2.2.2 普通广告信息 ................................................................................................................. 6 2.2.3 原生广告信息 ................................................................................................................. 7 2.2.4 音视频广告信息 ............................................................................................................. 7
类型
int
batch_ma adtype
object array
string
title
string
sub_title
string
image
string
icon
string
landing_url
string
impr_url
string array
click_url
strቤተ መጻሕፍቲ ባይዱng array
含义
count of ADs
pixel)
dvh
设备屏幕的高度，以像 Y
素为单位。(指密度无
铁通、 tietong 5
1.2.3.4
Mozilla%2 F5.0(Linu x%3BAnd roid4.0.4 %3BGT-I9 220%20B uild%2FI MM76D) 13742259 75 320
50
320
480
4
移动广告平台 Server to Server 接入说明
地理位置(经度, 纬度) Y
23.45833 5,-50.273 971,50
ssid
Wifi SSID
isboot
是否开屏
1，表示开屏；0 0 表示非开屏
batch_cnt 请求批量下发广告的 Y for native AD 1~30 之间（含） 1
数量
的整数值
2.1.3 应用信息
参数名
appid
Y
4 - wap
Android
iOS
iOS
WP
Others(注意大小
写)
4.1
openudid OpenUDID
Y
OpenUDID
adid
Android ID
Y for Android Android ID
imei
IMEI
Y for Android
idfa mac aaid duid density operator
1 使用条款
科大讯飞股份有限公司（以下简称“讯飞”）所有文档，接收者有保密义务。 未经讯飞书面许可，任何人或任何机构不得向第三方披露、泄露有关本文件的任 何内容或细节。讯飞拥有修改、调整、增补本文件的权利。
2 概述
SSP 采用 HTTP 通信协议与讯飞广告平台交互。 请求 URL：http://ws.voiceads.cn/ad/request 请求方法：POST 请求 Header：
2.3 备注 ......................................................................................................................................... 8
1
移动广告平台 Server to Server 接入说明
类型
string
含义
type of AD
取值范围
redirect/download/nu（ll null 只针 对音频广告，表示既不是跳转也
7
url duration landing_url start_url
over_url
click_url
移动广告平台 Server to Server 接入说明
科大讯飞移动广告平台
Server to Server接入说明
Ver 1.1.5
科大讯飞股份有限公司 2015.11
移动广告平台 Server to Server 接入说明
1 使用条款...................................................................................................................................2 2 概述...........................................................................................................................................2
3--91 Market
app 在上述应用商 店内的编号
app 在上述应用商 店内的分类编号
app 在上述应用商 店内的标签(英文 或中文 UTF8-urlencode 编码) 多个标签使 用半角逗号分隔
2.1.4 版本相关信息
参数名
述
X-protocol-ver 广告请求协议版本
号
X-encryption 请求参数加密方式
Y
网络运营商
Y
9774D56 D682E54 9C 35471005 3595659
中国移动： 移动、 mobile 中国联通： 联通、 unicom 中国电信： 电信、 telecom 中国铁通：
3
移动广告平台 Server to Server 接入说明
net
联 网 类 型 (0— 未 知 ， Y
参数名
述
X-protocol-ver 广告请求协议版本
号
X-encryption 请求参数加密方式
必填 Y
Y
说明 当前版本号：2.0
iflyEncryption：讯飞 如该参数缺
加密算法，none 表 失，则默认为
示不加密
none
2.1 广告请求上行 请求参数采用 JSON 数据格式，数据采用 UTF-8 编码。
发送请求时的本地 Y
TS
UNIX 时间戳(秒数, 10
进制)
adw
广告位的宽度，以像素 Y
为单位。(指密度无关
像素，即 DIP 或 CSS
pixel)
adh
广告位的高度，以像素 Y
为单位。( 指密度无关
像素，即 DIP 或 CSS
pixel)
dvw
设备屏幕的宽度，以像 Y
素为单位。(指密度无
关像素，即 DIP 或 CSS
1—Ethernet，2—wifi，
3—蜂窝网络，未知代，
4—，2G，5—蜂窝网
络，3G，6—蜂窝网络，
4G)
ip
客户端 ip
server-2-server IP 对接方式：Y
client-2-server 对接方式：可选
ua
User-Agent( 字 符 串 , Y
UA
需 escape 转义)
ts
关像素，即 DIP 或 CSS pixel)
orientation 横竖屏
Y
0 – 竖屏
1– 横屏
vendor
设备生产商
Y
Apple
model
设备型号
Y
iPhone4% 2C1
lan
目前使用的语言-国家
zh-CN
brk
iOS 设备是否越狱。1-- Recommed
0
是, 0--否/未知(默认)
geo
参数名
述
必填
对应 MMA 字段 样例
devicetype 设备类型
Recommended -1 未知
0
0 - phone
1 - pad
2 - pc
3 - tv
2
移动广告平台 Server to Server 接入说明
os
客户端操作系统的类 Y
型(具体传系统值,如样
例:Android)
osv
操作系统版本号
AD array
取值范围
type of AD
redirect/download
title of AD
subtitle of AD
image url
icon url
landing url
exposure of impression
exposure of click
2.2.4 音视频广告信息
标签
adtype
2.1.1 广告位信息
参数名 adunitid
述 讯飞广告平台注册广告位 ID
必填 Y
说明 无
2.1.2 设备系统信息
Android 系统 供 id 的先后顺序：imei/mac/androidId/aaid
iOS 系统 供 id 的先后顺序：idfa/openudid
媒体可以按 id 的先后顺序选择至少 供一个 id 号。
述
appid
必填
Y
appname
App Name
Y
pkgname
APP 应用的包名 Y 称
mkt
应用商店的编号 recommed
1--iOS AppStore 2--Google Play
对应 MMA 字段 样例
5
mkt_sn mkt_cat mkt_tag
移动广告平台 Server to Server 接入说明