【必看】任务与广告关联及广告上报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>