腾讯珊瑚接入流程和开发指引

接入流程+开发工作量+开发接口


积分任务说明

<hr /> <h4>一、 珊瑚公有任务类型tasktype,对应的广告(公有任务的内容是广告)</h4> <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>125</td> <td>开屏广告</td> <td>是</td> <td>开屏广告</td> <td>点击广告。要有跳转落地页/下载的能力</td> </tr> <tr> <td>130</td> <td>banner广告</td> <td>是</td> <td>banner广告</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> <p>珊瑚的签到任务逻辑:(连续签到第3天,连续签到第6天,可以得到每日签到的积分值+连续签到的奖励积分)</p> <ol> <li>1/2/4/5/6天,提交102每日签到任务;</li> <li>连续第3天签到:请求102每日签到+106连续签到第3天,并同时提交;</li> <li>连续第3天签到:请求102每日签到+107连续签到第7天,并同时提交;</li> <li>如果在SDK使用连续签到,自行判断签到第几天,给用户对应签到任务,并提交对应签到任务。</li> <li>如果是h5模板中使用签到模块,珊瑚后台按要求配置签到任务即可,无需另外做 签到任务逻辑+UI。</li> </ol> <hr /> <h4>二、 珊瑚公有任务类型tasktype,任务完成判断参考</h4> <ul> <li> <p><strong>1、提交任务前的任务完成判断</strong>提交任务前,客户端要做任务完成的判断,一旦提交腾讯后台就会认为完成了任务。 任务完成标准 1)视频任务:视频播放完; 2)APP下载任务:下载APP,安装成功,并拉起激活联网; 3)签到任务:点击签到,签到成功弹出卡券; 4)自定义任务类型:接入方自己定义任务完成标准</p> </li> <li><strong>2、可以开发自己的自建任务类型:</strong>比如一些结合产品功能的任务类型,用积分奖励激励用户积极使用产品功能</li> </ul> <h4>三、SDK请求任务,返回任务列表字段说明</h4> <table> <thead> <tr> <th>类型</th> <th>字段</th> <th>说明</th> <th>来自哪里</th> </tr> </thead> <tbody> <tr> <td>public String</td> <td>app</td> <td>APP包名</td> <td></td> </tr> <tr> <td>public int</td> <td>task_type</td> <td>任务类型(很有用)</td> <td>任务分配所属类型</td> </tr> <tr> <td>public int</td> <td>coin_num</td> <td>积分数量</td> <td>任务分配:每次可获积分数量</td> </tr> <tr> <td>public int</td> <td>coin_num_login</td> <td>未登录状态,查询在任务完成并且登录后可获得的积分; 登录状态,完成任务获得的积分</td> <td></td> </tr> <tr> <td>public String</td> <td>extra</td> <td>额外信息</td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>icon_1</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>icon_2</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>icon_3</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public int</td> <td>order_assign_timestamp</td> <td>订单创建时间</td> <td>会返回历史订单,如果不要历史订单,结合status值(3/4/7),自行过滤</td> </tr> <tr> <td>public byte[]</td> <td>order_data</td> <td>客户端回传</td> <td></td> </tr> <tr> <td>public int</td> <td>order_expire_timestamp</td> <td>订单过期时间</td> <td></td> </tr> <tr> <td>public String</td> <td>order_id</td> <td>订单号</td> <td></td> </tr> <tr> <td>public int</td> <td>order_submit_timestamp</td> <td>订单完成时间</td> <td></td> </tr> <tr> <td>public int</td> <td>task_status</td> <td>任务状态: 1为未完成,2为已完成但未提交,3为完成且已提交,4为过期</td> <td></td> </tr> <tr> <td>public String</td> <td>text_1</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>text_2</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>text_3</td> <td></td> <td>任务样式</td> </tr> <tr> <td>public int</td> <td>type_id</td> <td>展示样式类型ID</td> <td>任务样式</td> </tr> <tr> <td>public String</td> <td>url</td> <td>URL</td> <td>任务样式</td> </tr> </tbody> </table> <ul> <li>公有任务,任务样式相关值都是null,客户端展示信息,需要使用广告中的信息。</li> </ul> <h4>四、task_status含义解释</h4> <table> <thead> <tr> <th>order_status</th> <th>状态含义</th> <th>接入方处理</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>初始任务,未完成</td> <td>接入方判断任务完成了,可提交以获得积分</td> </tr> <tr> <td>2</td> <td>已完成,未提交任务</td> <td>可直接提交,获得积分</td> </tr> <tr> <td>3</td> <td>已完成,且已提交获得积分任务</td> <td>已完成订单,无需再处理,不能提交</td> </tr> <tr> <td>4</td> <td>过期任务,提交后不获得积分</td> <td>过期的任务,无需完成,无需提交。可过滤掉</td> </tr> <tr> <td>5</td> <td>补做-初始任务,未完成</td> <td>接入方判断任务完成了,可提交以获得积分</td> </tr> <tr> <td>6</td> <td>补做-完成任务,未提交</td> <td>可直接提交,获得积分</td> </tr> <tr> <td>7</td> <td>补做-完成任务,且已提交获得积分</td> <td>已完成订单,无需再处理,不能提交</td> </tr> <tr> <td>8</td> <td>初始在GUID,合并到ACCOUNT的任务 - 已合并</td> <td>常规用户体系不会遇到</td> </tr> <tr> <td>9</td> <td>初始在GUID,合并到ACCOUNT的任务 - 合并的完成任务</td> <td>常规用户体系不会遇到</td> </tr> <tr> <td>10</td> <td>初始在GUID,合并到ACCOUNT的任务 - 合并的补做任务</td> <td>常规用户体系不会遇到</td> </tr> </tbody> </table> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/3a34ed932558786bd90f88148053ffd6?showdoc=.jpg" alt="" /></p> <hr /> <h4>五、积分任务UI参考</h4> <p><strong>积分任务列表UI参考</strong>(仅供参考,非强制要求)</p> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/c4e1d7c13dbd98c85d1d7f0117c37bf5?showdoc=.jpg" alt="" /></p> <hr />

页面列表

ITEM_HTML