【必看】任务与广告关联及广告上报1.0-6010
<h4>一、广告和任务拉取</h4>
<ul>
<li>
<p>3个步骤:拉取任务——拉取广告——任务与广告关联(照着SDK的demo做)</p>
</li>
<li>
<p><strong>广告拉取,用请求多个广告的接口,不要贪心请求广告太多太频繁</strong>,不然曝光率低(曝光/接收),降低收益预期</p>
</li>
<li>
<p>关联逻辑:拉取到的任务,有task_type(任务类型),拉取到的广告有mTaskType(广告对应的任务类型),任务和广告就是通过这个ID关联。</p>
</li>
<li><strong>公有任务类型,对应的广告</strong>(都是有广告的任务,需要按要求完成任务,才有广告收入)</li>
</ul>
<table>
<thead>
<tr>
<th>task_type</th>
<th>任务类型</th>
<th>是否公有</th>
<th>对应广告类型</th>
<th>广告完成要求</th>
</tr>
</thead>
<tbody>
<tr>
<td>103</td>
<td>下载任务</td>
<td>是</td>
<td>APP下载广告</td>
<td>APP下载,安装,拉起激活</td>
</tr>
<tr>
<td>104</td>
<td>视频任务</td>
<td>是</td>
<td>视频广告</td>
<td>观看视频。要有跳转落地页/下载的能力</td>
</tr>
<tr>
<td>102</td>
<td>签到任务</td>
<td>是</td>
<td>卡券广告</td>
<td>点击广告。要有跳转落地页/下载的能力</td>
</tr>
<tr>
<td>106</td>
<td>连续签到第3天</td>
<td>是</td>
<td>无</td>
<td>无</td>
</tr>
<tr>
<td>107</td>
<td>连续签到第7天</td>
<td>是</td>
<td>无</td>
<td>无</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>完成广告要求,才有收入,所以任务的完成判断,要根据广告完成要求去做(否则,给了用户积分,产品没有得到广告收入)。</p>
</li>
<li><strong>任务完成标准:</strong>
1)视频任务:视频播放完,即可提交任务;(注意,视频广告有跳转URL,播放界面要放置跳转按钮;有下载URL,要放置下载按钮)
2)APP下载任务:下载APP,安装成功,并拉起激活联网,才能提交任务;(任务一定要强制用户打开APP,才算完成)
3)签到任务:点击签到任务,即以提交任务;(签到成功后,需要弹出卡券广告,要放出按钮,跳转落地页/或跳转下载)
4)自定义任务类型:接入方自己定义任务完成标准</li>
</ul>
<h4>SDK连续签到的逻辑</h4>
<pre><code> 1)tasktype=102是每日签到,tasktype=106连续签到第3天,tasktype=107是连续签到第7天;
2)客户端存储用户签到天数;
3)任务请求:连续签到第3天时,给用户请求并展示tasktype=106的任务,请求但不要展示102任务;连续签到第7天时,给用户请求并展示tasktype=107的任务,不要展示102任务;签到第1/2/4/5/6天时,请求并展示tasktype=102。
4)提交任务:签到第1/2/4/5/6天,提交102任务orderID,连续签到第3天提交102和106任务orderID,连续签到第7天提交102和107任务orderID。
5)积分增加逻辑:第1/2/4/5/6天,获得102任务配置的积分值;连续签到第3天,获得102+106配置的积分值;连续签到第7天,获得102+107配置的积分值;
6)102每日签到任务是有卡券广告的,签到成功时,曝光卡券,点击卡券跳转h5落地页/应用下载。</code></pre>
<h4>二、广告上报,很重要。</h4>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/2e8c83d7ccee83494b4c5b94a124dac5?showdoc=.jpg" alt="" /></p>
<p>以上以Android命名为例,iOS各上报阶段接口详见SDK包中的接口文档。</p>
<ul>
<li>
<p><strong>视频广告,广告上报时机</strong>
视频曝光:视频播放时上报广告曝光;(看视频播放有收益)
视频点击:点击跳转落地页/点击跳转下载(跳转URL/下载URL);【如果有落地页/下载,必须给出落地页/下载跳转通道】
开始下载:点击下载URL后,开始下载应用;
下载成功:应用下载完成;
安装成功:应用安装完成;
激活:拉起应用,激活联网。</p>
</li>
<li>
<p><strong>APP下载广告,广告上报时机</strong>
广告曝光:APP广告信息展示时;
广告点击:点击下载URL;
开始下载:点击下载URL后,开始下载应用;
下载成功:应用下载完成;
安装成功:应用安装完成;
激活:拉起应用,激活联网。(安装、拉起激活有收益)</p>
</li>
<li><strong>签到卡券广告,广告上报时机</strong>
广告曝光:卡券广告信息展示时;
广告点击:点击跳转落地页(有跳转URL)、或者点击跳转下载(无落地页,有下载地址时),
开始下载:点击下载URL后,开始下载应用;
下载成功:应用下载完成;
安装成功:应用安装完成;
激活:拉起应用,激活联网。
<strong>注:</strong>不论SDK的签到任务、还是h5的签到任务,都可能拉到h5广告,也可能拉到带下载广告,所以需要有下载能力和上报。h5接签到,客户端实现下载上报的方法,供h5调用。(具体见h5签到模块)</li>
</ul>
<h4>三、广告上报测试</h4>
<pre><code>测试环境测试:在接口功能都自测好后,需要联系腾讯同学测试商业化上报。
正式环境测试:在接口功能都自测好后,需要联系腾讯同学测试商业化上报。
上线前测试:在拿到正式配置文件后,确认接口调用功能等正常,需要联系腾讯同学测试商业化上报。
上报联合测试方法:接入方集中做各个任务类型任务,然后提供操作的imei、操作的guid、操作时间范围,操作次数,等信息给腾讯同学,腾讯同学查询上报数据。
注:上报可以先自测:做任务后,看日志TMSDK中上报的数据,与操作是否一致。</code></pre>
<p><strong>广告上报测试,接入方测试记录方式</strong>
guid在TMSDK这个tag的log里搜索
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/fc5fe9604478accc7e1ffb140789f04b?showdoc=.jpg" alt="" /></p>
<h4>四、广告上报接口</h4>
<ul>
<li>请按要求,在正确时机调用广告上报接口,实现广告上报。每个环节都要上报,事关广告收益!</li>
</ul>
<h5>Android广告上报接口</h5>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/a8650154dc7081d2e6258d42991ea321?showdoc=.jpg" alt="" /></p>
<h5>iOS广告上报接口</h5>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/a705e5591e7b58557e925ccb8cc7c545?showdoc=.jpg" alt="" /></p>
<h4>五、任务列表返回字段信息、广告返回字段信息。</h4>
<ul>
<li><strong>见本文档,下一节《任务广告UI参考》</strong></li>
</ul>