AdView媒介API接口V23.pdf

AdView 媒介API 接口协议2.3 AdView 移动广告交易平台 媒介API 接口协议2.3 Copyright © 2009–2015AdView. All Rights Reserved AdView 1 / 11 AdView 媒介API 接口协议2.3 目 录 1. 概述4 2. 接入流程4 3. 接口说明4 3.1 广告请求4 3.1.1 定义和说明4 3.1.2 token 的生成6 3.1.3 请求示例6 3.2 广告响应6 3.2.1 定义和说明6 3.2.2 响应示例8 3.3 曝光和点击上报 10 3.3.1 曝光上报 10 3.3.2 点击上报 10 附录1 ：广告样式示例 10 附录2 ：术诧说明 11 Copyright © 2009–2015AdView. All Rights Reserved AdView 2 / 11 AdView 媒介API 接口协议2.3 文档更新记录 版本 修改时间 修改内容 修改人 1.0.0 2013.11 创建文档 产品部 1.0.3 2013.12 广告请求新增字段 产品部、技术部 1.0.8 2013.12 广告返回关于颜色字段扩展 产品部 2.0 2013.12 修改广告请求at 字段 产品部 2.1 2015.06 增加概述、接入须知、开发准备工作等内容 技术部 2.2 2015.09 增加媒体设置CPM 底价 技术部 2.3 2015.10 增加原生广告形式，修改文字描述 ，去除adl 字段 ，增加mc 字段等 ， 技术部 增加ip 字段说明。 Copyright © 2009–2015AdView. All Rights Reserved AdView 3 / 11 AdView 媒介API 接口协议2.3 1.概述 本文档面向以API 方式接入AdView 移劢广告交易平台的开发者。媒体戒媒体服务端通过本接口所述，以HTTP GET 的方式向AdView 发 起获取广告请求。 2.接入流程 1 ．合作方通过HTTP GET 发送广告请求到AdView 服务端； 2 ．AdView 返回广告数据； 3 ．合作方调用监控地址。 3. 接口说明 3.1 广告请求 1. 请求方式：HTTP GET 2. 请求地址：/agent/openRequest.do 3. 请求头设置：请确保请求头带有Accept-Encoding ，包含gzip。如果AdView 以gzip 格式返回，需要合作方进行解压缩处理。 4. 文档中红色字体代表重要字段不关键性描述，合作方开发文档时需要重点关注。 3.1.1 定义和说明 请求参数： 字段 类型 是否必需 说明 取值或描述 n int 必需 请求广告的数量，返回小于等于n 条广告