【2.1-6021】SDK接口文档-Android
<h4>一、2.1-6021 珊瑚SDK调用时序图</h4>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/8bdf72fbf31577e9e4ba98f0fea5bb15?showdoc=.jpg" alt="" /></p>
<h5>广告与任务的耦合:</h5>
<ol>
<li><strong>任务关联广告</strong>:
<pre><code class="language-xml">1)先拉取未完成任务(状态是1的orderID);
2)再去拉取广告(对应类型广告);
3)任务与广告关联起来;
4)判断任务完成之后,一定要提交任务。</code></pre></li>
<li>任务是任务、广告是广告,关联的意义在于,把广告作为任务的内容。</li>
<li>
<p>卡券、下载、视频广告,需与任务关联使用;(ios下载不用关联任务,因为没有下载和安装回调)</p>
</li>
<li>banner/开屏/信息流/全屏视频/视频内容、等,与积分场景关联度不高的,可以不与任务绑定;</li>
<li>要积极开发健康的广告转化场景,在保证健康转化的情况下,提升广告转化率;</li>
</ol>
<hr />
<h4>二、珊瑚积分SDK-2.1更新概要</h4>
<h4>1、SDK开发文档,见SDK包里的Word文档</h4>
<h4>2、6种business拉取方式发生变化,其中前两种是新增business</h4>
<pre><code class="language-xml">COIN_VIDEO_FEEDS ----新增类型
COIN_VIDEO_FULLSCREEN ----新增类型
COIN_SPLASH_EXIT
COIN_BANNER_EXIT
COIN_FEED_EXIT
COIN_VIDEO_EXIT</code></pre>
<h4>3、积分模块,没有变化;积分与广告关联逻辑,没有变化</h4>
<h4>4、依赖关系</h4>
<pre><code class="language-xml">1 广点通联盟SDK (如果有对接广点通SDK,不要用两个)
2 ep前途sdk 2.0+
3 android.support.v4:广点通sdk要求
4.tmsdk.jar
5 快手广告SDK
6 com.android.support:appcompat-v7:28.0.0 快手SDK 要求
7 com.android.support:recyclerview-v7:28.0.0 快手SDK 要求
8.commonbase-1.0.2
9.adapt-1.3.3</code></pre>
<p>gradle配置</p>
<pre><code class="language-java">android {
defaultConfig {
ndk {//快手sdk 要求
abiFilters "armeabi-v7a"
}
}
allprojects {
repositories {
flatDir { dirs 'libs' }
}
}
</code></pre>
<hr />
<h4>三、2.0-6020版本SDK配置文件</h4>
<ol>
<li>测试环境测试时,可以用SDK包中原有的test配置文件40805.dat。</li>
<li>测试环境测试时,如果初始化报包名校验错误,可以下载通用包名test配置文件替换。
3.<a href="https://config.3g.qq.com/qqsecure_config_update/cloudtestnew/2020/07/02/40805.dat_20200702192600">https://config.3g.qq.com/qqsecure_config_update/cloudtestnew/2020/07/02/40805.dat_20200702192600</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>
<p><strong>1、标黑为2.1新增资源
2、实际上线,同类广告来源是竞价混合随机的。比如,测试dat下载广告103和134不同来源,正式dat中103兼容两者。
3、测试为了确保所有来源广告正常,分开来源参数测。比如测试dat中测试,下载要测试130/134,激励视频要测试104/131/132</strong></p>
</li>
</ol>
<p>1)卡券任务与广告
business: COIN_CARD_GIVE
taskType: 102(每日签到)
sceneID: 0000</p>
<p>2)下载任务与广告
business: COIN_DOWNLOAD_APP_AD
taskType: 103(下载任务)
sceneID: 0000
3)下载任务与广告2—-广点通
business: COIN_DOWNLOAD_APP_AD
taskType: 134(下载场景2)一般仅测试dat用
sceneID: 0001</p>
<p>4)视频任务与广告
business: COIN_VIDEO_EXIT
taskType: 104(视频任务)
sceneID: 0000
5)视频任务与广告2—-广点通
business: COIN_VIDEO_EXIT
taskType: 131(视频场景2)一般仅测试dat用
sceneID: 0001
<strong>6)视频任务与广告3——新增快手来源</strong>
business: COIN_VIDEO_EXIT
taskType: 132(视频场景3)
sceneID: 0002</p>
<p>7)开屏广告
business: COIN_SPLASH_EXIT
taskType: 125(开屏广告)
sceneID:0000</p>
<p><strong>8)信息流</strong>
business: COIN_FEED_EXIT
taskType: 128(信息流广告)
sceneID: 0000</p>
<p>9)banner广告
business: COIN_BANNER_EXIT
taskType: 130(banner广告)
sceneID: 0000</p>
<p><strong>10)全屏视频</strong>
business: COIN_VIDEO_FULLSCREEN
taskType: 137(全屏视频)
sceneID: 0000</p>
<p><strong>11)内容联盟广告</strong>
business: COIN_VIDEO_FEEDS
taskType: 138(内容联盟广告)
sceneID: 0000</p>
<hr />
<h4>五、广告上报</h4>
<h5>1. 广告的曝光、点击,视频的播放等,SDK中已经写好,接入方不需要另外实现。</h5>
<h5>2. 下载上报,接入方在下载器中实现如下方法:</h5>
<pre><code class="language-xml">DownloadReportProxy.reportStartDownload //开始下载
//reportDownloadFinish 下载完成
//reporttinstalled 安装成功
//reportrtActive 激活软件</code></pre>
<p>注:这个上报方式,上报同时会做下载的数据管理,用于后续下载留存调用数据</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>132视频广告</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>
<td></td>
</tr>
<tr>
<td>点击</td>
<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>
<tr>
<td>下载成功</td>
<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>
<tr>
<td>激活</td>
<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>
<td></td>
</tr>
</tbody>
</table>
<hr />