APP广告处理必看（2016.06.01）

广告需求的几个要素

广告显示的内容/素材（图片、文字、gif、视频、？对应的尺寸？）

广告目的页的展现形式（网页、视频、？使用外部浏览器打开、使用公用webview打开？需不需要支持app内部页面跳转（要提供推送的协议文档）？）

广告是否需要计数（vc/vc3d展示计数、cc/cc3d点击计数、等）

广告更新机制/显示时长（一直显示、显示一次后刷新消失、点击后消失、？）

广告对线上旧版有没有要求（只在最新版本上、兼容旧版）

广告更新的方式/平台（公司的广告系统、第三方广告平台如有道、？）

第三方广告请求方式（API、SDK、？）

第三方广告平台合作的时长？结束后该广告是否仍继续销售？是的话如何更新 ？

第三方广告也要申请广告标识和计数链点的

需求中还要标明：

广告是硬广还是软广；终端页如有分页广告在第几页；广告图片如果跟设备尺寸不符，要等比例缩放还是拉伸填充，特别注意安卓。

广告刊例：产品要及时将广告刊例发给客户端同事、mrobot同事、测试同事。

APP的情况（以下讨论不包含软配，即编辑在后台录入的推广位）

数据接口：

mrobot接口（如 http://mrobot.pcbaby.com.cn/s/qzbd/ad/ad.xsp?v=312&platform=ios&devid=1ac5adf2b452442df061e49d2ba4844ed6ea2959&idfa=MkM3ODlGN0UtQURCNi00MzM4LUIyRDQtNDQ4MkU4M0NGQTI3）

app请求广告接口时机：后台切换进入APP或删除进程后再次打开APP。

广告数据更新后，app显示最新数据的时机（及时性）：

1、启动图：在后台切换进入APP或删除进程后再次打开APP，在此之后第二次启动APP就要显示最新的启动图广告数据。
2、其他广告：在后台切换进入APP或删除进程后再次打开APP，就可以看到最新的广告数据

返回数据（一般情况）

字段名	含义	类型	默认值	备注
vc-uri	广告曝光计数	string	""	如果该字段非空且以http开头，客户端需触发请求
cc-uri	广告点击计数	string	""	如果该字段非空且以http开头，客户端需触发请求
to-uri	广告目标链点	string	""	有些广告此字段已包含点击计数，则cc-uri应该为空，不冲突；此字段有可能返回客户端内页跳转协议
vc3d-uri	第三方广告曝光计数	string	""	如果该字段非空且以http开头，客户端需触发请求
cc3d-uri	第三方广告点击计数	string	""	如果该字段非空且以http开头，客户端需触发请求
image	广告素材	string		广告素材有可能是text或者其他，此处只是举例
seq	广告位置	string		信息流广告在列表中的位置，此处只是举例
rule	广告的时间规则	字典，包含三个字段：delay，interval，age		delay 多少秒后开始显示广告，interval 同一终端页间隔小于多少秒不显示广告，age 广告显示时长

基本规则：

iOS APP inreview状态，不请求广告数据接口，以免因为不可控的广告内容被拒。
广告不在业务接口中返回，在mrobot的ad接口中统一返回，以免受业务接口缓存时间影响。
广告数据接口请求等级为High，缓存机制为nocache；广告计数接口请求等级为Normal，缓存机制为nocache

全部广告位新增获取设备ID

【背景】有一些广告商的计数链点会要求传设备ID的信息，但是传参的字段名称是不统一的。
【实现】（分为以下四步）
1、客户端将设备ID的信息传给mrobot广告接口
2、如果广告商的计数链点需要传设备ID信息，则在广告系统中按要求填写（填写规则中是有广告商要求的字段名称的）
3、mrobot则将设备ID信息拼在最终的链点中返回给客户端
4、客户端请求链点
【备注】设备ID信息，iOS两个：idfa、devid（这里指openUDID）；安卓四个：deviceModel，devid，imei，mac
接口文档（广告和首页两个接口）： http://192.168.10.131:8080/workspace/myWorkspace.do?projectId=20#119

*新的广告位，要加上以下三点：
1、广告第三方计数要加设备信息（iOS两个：idfa、devid；android四个：deviceModel，devid，imei，mac）
实现：APP端将几个字段传给mrobot，mrobot根据广告系统的配置将对应的设备信息拼到计数链点中
2、各APP推送能够到达的页面，广告位也都要支持到(跳转协议详见各APP项目文档)
3、广告如果是使用公用webview打开的，需带登录信息

计数规则：

曝光vc-uri、vc3d-uri

广告类型	曝光计数触发时机	从其他页面返回	备注
信息流广告	列表滚动至广告出现在屏幕内时触发	不计数	不需要等图片出来
启动图/全屏广告	展示广告图片时触发	不计数	图片要出来才触发
页面内广告	进入页面时触发，不论是否已看到	不计数
通栏广告	加载通栏时触发	不计数
焦点图广告	水平滚动至广告时触发	水平滚动至广告时计数	焦点图不在屏幕内时不计数

点击cc-uri、cc3d-uri

广告类型	点击计数触发时机	备注
所有支持点击的类型	点击广告进入到详情页面时触发	特例：汽车网焦点图下方广告v4.11.1

以上计数规则适用于一般广告，如有第三方广告提出特殊要求，按具体需求执行

关于测试

  QA测试用例参考

mrobot的情况

广告系统接口：

新版： http://ivy.pconline.com.cn/show?adid=391573&id=test.adtest.sytl.&media=js
旧版： http://ivy.pconline.com.cn/adpuba/show?adid=391573&id=test.adtest.sytl.&media=js

说明：

数据结构与上面的 【返回数据】表格一致，某些字段的特殊说明如下：

to-uri:这个字段广告系统里面是没有的，是mrobot根据具体项目的具体广告位置，再获取广告系统的ct-uri或cc-uri的值作为to-uri的值来展现，现在这个字段值有以下两种情况：

1. 当项目里面的具体广告位置是有需要做内部跳转（app协议跳转）的时候，to-uri就会赋值拿ct-uri的值，这时候由于是协议跳转，所以广告计数不能统计，所以一般情况下都会有cc-uri也一并返回在广告接口，客户端可以用之以广告计数；
2. 当没有具体需求是内部跳转时，to-uri为cc-uri,这时候ct-uri为"none",cc-uri就不会出现在广告接口，因为作用和值都与to-uri重复；

广告素材结构： ads --> JSONArray ad --> JSONObject

广告素材： img（图片）、text（文字）

计数链点：
cc-arr-uri 品友点击计数链点（数组）
vc-arr-uri 品友曝光计数链点（数组）

展现形式：
showV 控制启动图广告是否显示
isExtend 控制广告是否显示推广标签
bigImg 首页列表广告大图模式

详细请看连接：  客户端广告模板说明文档

广告系统的情况

详细请看连接：  客户端广告模板说明文档

（来自广告制作卢连凤，目前没有公共地址存放该文档，需定时与广告支持中心要最新文档）

tips

根据新广告法，广告必须有“推广”字样，可关闭（或者移开屏幕范围）；具体情况看需求。