科大讯飞移动广告平台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 接入说明
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
屏幕密度
关像素，即 DIP 或 CSS pixel)
orientation 横竖屏
Y
0 – 竖屏
1– 横屏
vendor
设备生产商
Y
Apple
model
设备型号
Y
iPhone4% 2C1
lan
目前使用的语言-国家
zh-CN
brk
iOS 设备是否越狱。1-- Recommed
0
是, 0--否/未知(默认)
geo
类型
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
string array
含义
count of ADs
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 广告请求上行 ......................................................................................................................... 2 2.1.1 广告位信息 ..................................................................................................................... 2 2.1.2 设备系统信息 ................................................................................................................. 2 2.1.3 应用信息 ......................................................................................................................... 5
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
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
3--91 Market
app 在上述应用商 店内的编号
app 在上述应用商 店内的分类编号
app 在上述应用商 店内的标签(英文 或中文 UTF8-urlencode 编码) 多个标签使 用半角逗号分隔
2.1.4 版本相关信息
参数名
述
X-protocol-ver 广告请求协议版本
号
X-encryption 请求参数加密方式
2.1.1 广告位信息
参数名 adunitid
述 讯飞广告平台注册广告位 ID
必填 Y
说明 无
2.1.2 设备系统信息
Android 系统 供 id 的先后顺序：imei/mac/androidId/aaid
iOS 系统 供 id 的先后顺序：idfa/openudid
媒体可以按 id 的先后顺序选择至少 供一个 id 号。
2.3 备注 ......................................................................................................................................... 8
1
移动广告平台 Server to Server 接入说明
科大讯飞移动广告平台
Server to Server接入说明
Ver 1.1.5
科大讯飞股份有限公司 2015.11
移动广告平台 Server to Server 接入说明
1 使用条款...................................................................................................................................2 2 概述...........................................................................................................................................2
1 使用条款
科大讯飞股份有限公司（以下简称“讯飞”）所有文档，接收者有保密义务。 未经讯飞书面许可，任何人或任何机构不得向第三方披露、泄露有关本文件的任 何内容或细节。讯飞拥有修改、调整、增补本文件的权利。
2 概述
SSP 采用 HTTP 通信协议与讯飞广告平台交互。 请求 URL：/ad/request 请求方法：POST 请求 Header：
Y
网络运营商
Y
9774D56 D682E54 9C 35471005 3595659
中国移动： 移动、 mobile 中国联通： 联通、 unicom 中国电信： 电信、 telecom 中国铁通：
3
移动广告平台 Server to Server 接入说明
net
联 网 类 型 (0— 未 知 ， Y
必填 Y
Y
说明 当前版本号：2.0
iflyEncryption：讯飞 如该参数缺
加密算法，none 表 失，则默认为
示不加密
none
2.2 广告请求下行
2.2.1 公共信息
标签
rc
类型
int
info_en
string
info_cn
string
matype
string
含义
result code
取值范围
参数名
述
X-protocol-ver 广告请求协议版本
号
X-encryption 请求参数加密方式
必填 Y
Y
说明 当前版本号：2.0
iflyEncryption：讯飞 如该参数缺
加密算法，none 表 失，则默认为
示不加密
none
2.1 广告请求上行 请求参数采用 JSON 数据格式，数据采用 UTF-8 编码。
述
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 接入说明
2.2 广告请求下行 ......................................................................................................................... 6 2.2.1 公共信息 ......................................................................................................................... 6 2.2.2 普通广告信息 ................................................................................................................. 6 2.2.3 原生广告信息 ................................................................................................................. 7 2.2.4 音视频广告信息 ............................................................................................................. 7