= APP广告处理必看（2016.06.01）
[[BR]]

== 广告需求的几个要素
[[BR]]

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

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

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

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

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

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

>第三方广告请求方式（API、SDK、？） [[BR]]

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

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

[[BR]]

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

[[BR]]

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

[[BR]]


== APP的情况（以下讨论不包含软配，即编辑在后台录入的推广位）
[[BR]]
>数据接口：[[BR]]
mrobot接口（如http://mrobot.pcbaby.com.cn/s/qzbd/ad/ad.xsp?v=312&platform=ios&devid=1ac5adf2b452442df061e49d2ba4844ed6ea2959&idfa=MkM3ODlGN0UtQURCNi00MzM4LUIyRDQtNDQ4MkU4M0NGQTI3）
[[BR]]
[[BR]]
>app请求广告接口时机：后台切换进入APP或删除进程后再次打开APP。[[BR]]
[[BR]]
>广告数据更新后，app显示最新数据的时机（及时性）：
1、启动图：在后台切换进入APP或删除进程后再次打开APP，在此之后第二次启动APP就要显示最新的启动图广告数据。[[BR]]
2、其他广告：在后台切换进入APP或删除进程后再次打开APP，就可以看到最新的广告数据[[BR]]
[[BR]]
>返回数据（一般情况）
||= 字段名 =||= 含义 =||= 类型 =||= 默认值 =||= 备注 =||
||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  广告显示时长||
[[BR]]
>'''基本规则：'''[[BR]]
iOS APP inreview状态，不请求广告数据接口，以免因为不可控的广告内容被拒。[[BR]]
广告不在业务接口中返回，在mrobot的ad接口中统一返回，以免受业务接口缓存时间影响。[[BR]]
广告数据接口请求等级为High，缓存机制为nocache；广告计数接口请求等级为Normal，缓存机制为nocache[[BR]]
[[BR]]
[[BR]]
>全部广告位新增获取设备ID[[BR]]
【背景】有一些广告商的计数链点会要求传设备ID的信息，但是传参的字段名称是不统一的。[[BR]]
【实现】（分为以下四步）[[BR]]
1、客户端将设备ID的信息传给广告接口[[BR]]
2、如果广告商的计数链点需要传设备ID信息，则在广告系统中按要求填写（填写规则中是有广告商要求的字段名称的）[[BR]]
3、mrobot则将设备ID信息拼在最终的链点中返回给客户端[[BR]]
4、客户端请求链点[[BR]]
【备注】设备ID信息，iOS两个：idfa、devid；安卓四个：deviceModel，devid，imei，mac[[BR]]
接口文档（广告和首页两个接口）：http://192.168.10.131:8080/workspace/myWorkspace.do?projectId=20#119 [[BR]]

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

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

[[BR]]
点击cc-uri、cc3d-uri[[BR]]
||= 广告类型 =||= 点击计数触发时机 =||= 备注 =||
||所有支持点击的类型||点击广告进入到详情页面时触发||特例：汽车网焦点图下方广告v4.11.1||

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

[[BR]]
[[BR]]
== 关于测试
[[BR]]
>[[http://rdtrac.pc.com.cn/iphone/attachment/wiki/ad-count/%E5%B9%BF%E5%91%8A%E6%B5%8B%E8%AF%95%E7%82%B920160526.xls | QA测试用例参考]]
[[BR]]

== mrobot的情况
[[BR]]
>广告系统接口： [[BR]]
新版：http://ivy.pconline.com.cn/show?adid=391573&id=test.adtest.sytl.&media=js [[BR]]
旧版：http://ivy.pconline.com.cn/adpuba/show?adid=391573&id=test.adtest.sytl.&media=js [[BR]]
[[BR]]
>说明：[[BR]]
数据结构与上面的 【返回数据】表格一致，某些字段的特殊说明如下：

'''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[[BR]]

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

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

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

详细请看连接：[[http://rdtrac.pc.com.cn/iphone/attachment/wiki/ad-count/APP%E6%A8%A1%E6%9D%BF.doc | 客户端广告模板说明文档]]
[[BR]]

== 广告系统的情况
[[BR]]
>详细请看连接：[[http://rdtrac.pc.com.cn/iphone/attachment/wiki/ad-count/APP%E6%A8%A1%E6%9D%BF.doc | 客户端广告模板说明文档]]
（来自广告制作卢连凤，目前没有公共地址存放该文档，需定时与广告支持中心要最新文档）
[[BR]]

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