### 一、快应用说明：

- 快应用广告位类型：开屏、激励视频、插屏、信息流（大图、左文右图、右文左图、上图下文、上文下图）

- 所有广告位支持图片和视频类型，并且视频类型支持预加载功能，还有摇一摇功能。

- 广告不填充，广告组件不做展示。广告展示，需要显示广告来源。

- 广告组件展示后数据上报：曝光监测（多个），用户点击广告上报：点击监测（多个），如果是调起类型广告，判断目标包名是否已安装，如果已安装，快应用通过deeplinkUrl进行app调起，并上报：调起监测（多个），如果未安装，通过landingPageUrl打开落地页。如果下载类弄广告，除了正常上报曝光、点击监测，还有下载成功后上报：下载监测。

- 竞价成功或失败提供API供开发者调用，对应广告返回2个字段：竞价成功nurl，竞价失败lurl。

  



### 二、交互事件和策略说明：



|功能|配置|说明|
|--|:--|---|
|摇一摇|"interEvent": {<br/>	"shakeEvent": {<br/>		"v": 1,<br/>		"ang": 20.0,<br/>		"sr": 1.5<br/>        "tx": ""<br/>	}<br/>}|v: 0:否,1:是 默认开启<br/>ang: 摇动触发角度 默认0，ang=0则不需要判断摇动角度 <br/>sr: 摇动触发加速度 默认1.5<br/>tx: 默认文案：摇动或点击了解更多|
|全屏可点|"interEvent": {<br/>	"fullScreenClk": {<br/>		"v": 0,<br/>	}<br/>}|v: 0:否,100:是100%开启 信息流和插屏默认开启，开屏和激励视频默认关闭|
|区域点击|"interEvent": {<br/>	"regionScreenClk": {<br/>		"v": 0,<br/>        "tx": ""<br/>	}<br/>}|v: 0:否,1:是 默认关闭<br/>tx: 默认文案：点击跳转至第三方应用或详情页|
|滑动点击|"interEvent": {<br/>	"scrollEvent": {<br/>		"v": 0,<br/>        "tx": ""	}<br/>}|v: 0:否,1:是 默认关闭<br/>tx: 默认文案：向上滑动跳转至\n第三方应用或详情页|
|策略_跳过/关闭按钮|"strategy": {<br/>	"pass": {<br/>			"v": 0<br/>	}<br/>}|作用：概率性的触发广告点击，提升点击率<br/>适用范围：所有广告位类型<br/>v:  // 触发概率 0~100 100：100%触发，0：不触发，默认0；<br/>默认不开启|
|策略_曝光回调|"strategy": {<br/>	"expBack":{<br/>			"v": 0<br/>	}<br/>}|作用：控制曝光回调给媒体的概率<br/>适用范围：所有广告位类型<br/>v:  // 回调的概率 0~100 100：100%回调，0:不回调，默认100；<br/>默认回调|
|策略_点击回调|"strategy": {<br/>	"callBack": {<br/>			"v": 0<br/>	}<br/>}|作用：控制点击事件回调给媒体的概率<br/>适用范围：所有广告位类型<br/>v:  // 回调的概率 0~100 100：100%回调，0:不回调，默认100；<br/>默认回调|
|策略_自动点击| "strategy": {<br/>	"aoClk": {<br/>            "co": 1<br/>            "ct": 2000<br/>			"cr": 0<br/>	}<br/>} | 作用：自动打开广告，提升点击率<br/>适用范围：所有广告位类型<br/>"co": 1 // 开关: 1：开，0：关<br/>"ct": 2000  // 点击等待时长单位毫秒<br/>"cr": 0 // 概率0~100 点击回调概率：0：不回调，100：100%回调。<br/>默认不回调 |
|策略_自动调起| "strategy": {<br/>	"nDpUp": {<br/>            "eo": 1<br/>            "co": 1<br/>            "et": 2000<br/>			"ct": 2000<br/>	}<br/>} | 作用：自动调起策略，当有广告返回，但价格不达标filter=1，<br/>或者被告知竞价失败<br/>自动调起广告：不展示广告，但是上报曝光监测<br/>适用范围：所有广告位类型<br/>"eo": 1 // 是否曝光：expose open==eo，1：开，0：关 <br/>"co": 1 // 是否点击：click open==co， 1：开，0：关<br/>"et": 2000  // 填充到曝光等待时长：expose time==et， 单位毫秒<br/>"ct": 2000  // 曝光到点击等待时长：click time==ct， 单位毫秒<br/>默认不开启 |
|策略_补量| 参数同上<br/>"strategy": {<br/>	"nDpUp": {<br/>            "eo": 1<br/>            "co": 1<br/>            "et": 2000<br/>			"ct": 2000<br/>	}<br/>} | 作用：当广告没填充或价格达标filter=1，并且没有配置自动调起<br/>策略，可请求补量广告<br/>适用范围：所有广告位类型<br/>"eo": 1 // 是否曝光：expose open==eo，1：开，0：关 <br/>"co": 1 // 是否点击：click open==co， 1：开，0：关<br/>"et": 2000  // 填充到曝光等待时长：expose time==et， 单位毫秒<br/>"ct": 2000  // 曝光到点击等待时长：click time==ct， 单位毫秒<br/>默认不开启 |



### 三、关于回调（onAdLoaded、onAdShown、onAdFailedToLoad、onAdClosed、onAdClicked等回调）

如果触发了以下策略：

摇一摇灵敏度：所有回调都正常回调

自动点击策略：cr参数没命中则不回调onAdClicked，其它都正常回调。

点击回调策略： v参数没命中则不回调onAdClicked，其它都正常回调。如果上面cr已经判断不回调则不执行这一步

调起策略：所有回调都不回调

补量策略：所有回调都不回调



### 四、自动调起策略的触发条件有两种：

1、接口响应参数filter=1则执行调起策略，所有回调不回调

2、媒体告知竞价失败，通过外部是否调用sendLossNotice方法判断，如果调用则执行调起策略，所有回调不回调

​     sendLossNotice和sendWinNotice 两个Api对应广告接口返回的nurl和lurl字段。



### 五、补量策略的触发条件有两种：

1、接口响应参数配了boostId， 并且errcode==204，则请求boostId广告，执行补量策略后，所有回调不回调

2、接口响应参数配了boostId，并且filter==1，并且不触发调起策略，则请求boostId广告，执行补量策略后，所有回调不回调



### 六、关于上报（曝光上报、点击上报、deeplink成功上报）

以上所有策略触发后涉及上报的链接后面都得拼上opt参数

```
opt: 0:默认值可不传 1:自动调起(曝光) 2:曝光回调 5:安装成功 6:下载成功(下载) 7:摇一摇自动点击(点击)  8:点击回调(点击) 9:自动点击(点击) 10:补量(曝光)
```

自动点击策略触发后需要根据cr判断是否回调点击给媒体，如果回调opt=0 不回调opt=9。

自动点击策略、点击回调策略、摇一摇灵策略都是曝光之后的策略，只涉及到点击上报和deeplink成功上报。

自动调起和补量策略涉及到曝光、点击上报和deeplink成功上报。



### 七、以下两个为补充策略：

1、302上报策略：当曝光和点击上报的链接包含 "?rv=1" 这个参数，则不上报这个链接，直接浏览器打开。

2、复制口令策略：如果响应参数wordText不为空，不管填没填充，都执行复制口令策略：如果wordText包含http://或https://，去请求口令内容复制到剪切版上，口令接口返回示例：{"code":0,"message":"OK","data":"口令内容"}。如果wordText不是http或https地址，测直接复制wordText字段内容到剪切版上面。