【2.0-6020】SDK接口文档-Android
<h4>一、2.0-6010 珊瑚SDK调用时序图</h4>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/8bdf72fbf31577e9e4ba98f0fea5bb15?showdoc=.jpg" alt="" /></p>
<h5>注意:</h5>
<ol>
<li>
<p><strong>任务关联广告</strong>:
1)先拉取未完成任务(状态是1的orderID);
2)再去拉取广告(对应类型广告);
3)任务与广告关联起来;
4)判断任务完成之后,一定要提交任务。</p>
</li>
<li>任务是任务、广告是广告,关联的意义在于,把广告作为任务的内容。</li>
<li>
<p>卡券、下载、视频广告,需与任务关联使用;</p>
</li>
<li>banner、开屏等,与积分场景关联度不高的,可以不与任务绑定;</li>
</ol>
<hr />
<h4>二、依赖关系</h4>
<h5>1.导入libs全部jar和aar</h5>
<h5>2.组件说明</h5>
<p>1 广点通联盟s'd'k
2 ep前途sdk 2.0+
3 ep adapt组件
4 ep combase组件
5 android.support.v4:广点通sdk要求
6.tmsdk.jar</p>
<h4>三、2.0-6020版本SDK配置文件</h4>
<ol>
<li>测试环境测试时,可以用SDK包中原有的test配置文件40805.dat。</li>
<li>测试环境测试时,如果初始化报包名校验错误,可以下载通用包名test配置文件替换。</li>
<li><a href="https://config.3g.qq.com/qqsecure_config_update/cloudtestnew/2020/04/14/40805.dat_20200414113514">https://config.3g.qq.com/qqsecure_config_update/cloudtestnew/2020/04/14/40805.dat_20200414113514</a> (文件名保存为40805.dat)。</li>
<li>切换正式环境联调时,找腾讯对接人,拿正式参数的40805.dat文件。</li>
<li><strong>重要说明1: </strong>2.0版本的SDK,不能用1.0的dat文件。</li>
<li>
<h2><strong>重要说明2: </strong>只有正式参数的40805.dat,才能用于发布。</h2>
<h4>四、测试拉取广告、任务参数</h4>
<h5>实际上线,同类广告来源是竞价混合随机的。比如,测试dat下载广告103和134不同来源,正式dat中103兼容两者。</h5>
<h5>1.按以下参数拉取任务与广告</h5>
<p>1)卡券任务与广告
business: COIN_CARD_GIVE
taskType: 102(签到任务)
sceneID: 0000
2)下载任务与广告
business: COIN_DOWNLOAD_APP_AD
taskType: 103(下载任务)
sceneID: 0000
3)视频任务与广告
business: COIN_VIDEO_EXIT
taskType: 104(视频任务)
sceneID: 0000
4)视频任务与广告2—-广点通,仅测试
business: COIN_VIDEO_EXIT
taskType: 131(视频场景2)---正式配置时,通常不用这个
sceneID: 0001
5)下载任务与广告2—-广点通,仅测试
business: COIN_DOWNLOAD_APP_AD
taskType: 134(下载场景2)---正式配置时,通常不用这个
sceneID: 0001
6)开屏广告
business: COIN_SPLASH_EXIT
taskType: 125(开屏广告)
sceneID:0000
7)banner广告
business: COIN_BANNER_EXIT
taskType: 130(banner广告)
sceneID: 0000</p>
</li>
</ol>
<p><strong>重要说明:coin_productId是7999的40805.dat文件,只能用于测试,不能用于发布!!!</strong></p>
<h5>2.如果接入方,需要对接其它任务广告类型,对接中另行给出参数</h5>
<hr />
<h4>五、广告上报</h4>
<h5>1. 广告的曝光、点击,视频的播放等,SDK中已经写好,接入方不需要另外实现。</h5>
<h5>2. 下载上报,接入方在下载器中实现如下方法:</h5>
<p>DownloadReportProxy.reportStartDownload //开始下载
//reportDownloadFinish 下载完成
//reporttinstalled 安装成功
//reportrtActive 激活软件
注:这个上报方式,上报同时会做下载的数据管理,用于后续下载留存调用数据</p>
<h5>3.广告上报数据查询:接入方集中测试广告,并提供如下信息,给腾讯对接者查询数据</h5>
<p>对接好之后,<strong>接入方</strong>集中测试广告;并<strong>提供如下信息给腾讯同学</strong></p>
<p>测试时间:X日-X点X分~X点X分
测试imei:
测试guid:</p>
<table>
<thead>
<tr>
<th></th>
<th>102卡券广告</th>
<th>104视频广告</th>
<th>103下载广告</th>
<th>131视频广告</th>
<th>134下载广告</th>
<th>125开屏</th>
<th>130banner</th>
</tr>
</thead>
<tbody>
<tr>
<td>曝光</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>点击</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>开始下载</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>下载成功</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>安装</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>激活</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>视频播放</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<hr />