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

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


H5游戏接入【暂无资源,停用】

<h4>一、H5游戏展示</h4> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/ea76aea50ec58c665402acd669e18a41?showdoc=.jpg" alt="" /></p> <h4>二、对接工作</h4> <p>H5小游戏只支持安卓广告,iOS未支持。 <strong>1. 珊瑚后台,配置小游戏,然后开发拼接游戏链接</strong> 1)配置小游戏,详见<strong>配置手册--小游戏配置</strong> 2)游戏链接(腾讯运营提供)+尾缀(account_id&amp;device_id&amp;login_key),<strong>尾缀需按真实用户传参</strong>; 示例:<a href="https://gmall.m.qq.com/games/coralGame?game_id=65&appid=7999&account_id=17612036560&device_id=864288043174461&login_key=62676e7202204c43bc424246f39e9848">https://gmall.m.qq.com/games/coralGame?game_id=65&appid=7999&account_id=17612036560&device_id=864288043174461&login_key=62676e7202204c43bc424246f39e9848</a> 3)game_id:配置好小游戏后,在珊瑚后台查看(菜单:商城运营--爆款活动--活动管理--游戏任务) 4)游戏列表链接(腾讯运营提供)+尾缀(account_id&amp;device_id&amp;login_key),<strong>尾缀需按真实用户传参</strong>; 示例:<a href="http://gmall.m.qq.com/page/game/list?appid=7999&account_id=17612036560&device_id=864288043174461&login_key=62676e7202204c43bc424246f39e9848">http://gmall.m.qq.com/page/game/list?appid=7999&account_id=17612036560&device_id=864288043174461&login_key=62676e7202204c43bc424246f39e9848</a></p> <p>测试环境域名是https://testgmall.m.qq.com 正式环境域名是https://gmall.m.qq.com</p> <p><strong>要接入的游戏体验与确定:</strong>把上面<strong>示例</strong>的链接<strong>game_id=65</strong>换成列列表中的,可以体验对应游戏。</p> <table> <thead> <tr> <th>体验 game_id</th> <th>游戏名称</th> <th>广告配置选择</th> <th>用户获得积分逻辑</th> </tr> </thead> <tbody> <tr> <td>79</td> <td>一笔画完</td> <td>CP1</td> <td>每通过5关(重复关卡也计次数),获得1次流量主积分</td> </tr> <tr> <td>81</td> <td>天天猜成语</td> <td>CP1</td> <td>根据游戏成绩,每解锁一次官爵,获得1次流量主积分</td> </tr> <tr> <td>83</td> <td>球球往前冲</td> <td>CP1</td> <td>每奔跑2分钟,获得1次流量主积分</td> </tr> <tr> <td>86</td> <td>沙滩球球</td> <td>CP1</td> <td>每解锁一次皮肤,获得1次流量主积分</td> </tr> <tr> <td>89</td> <td>挖掘大师</td> <td>CP1</td> <td>每开启一次宝箱,获得1次流量主积分</td> </tr> <tr> <td>65</td> <td>奔跑吧龙哥</td> <td>CP2</td> <td>单局收集弹珠10颗,获得1次流量主积分</td> </tr> <tr> <td>92</td> <td>萌宠消除</td> <td>CP2</td> <td>同时消2行、3行有几率得到1次流量主积分(单局内只加分1次)</td> </tr> <tr> <td>93</td> <td>逃出尼罗河</td> <td>CP3</td> <td>单局逃亡15秒,获得1次流量主积分</td> </tr> <tr> <td>94</td> <td>娃娃机大战</td> <td>CP3</td> <td>抓取宝石,有几率得到1次流量主积分</td> </tr> <tr> <td>95</td> <td>寻宝大师</td> <td>CP3</td> <td>探索机遇房间,有几率得到1次流量主积分</td> </tr> </tbody> </table> <p>注:流量主,指接入方。 <strong>[CP1、CP2的游戏加积分接口暂未调通,建议先接入CP3的三款游戏]</strong></p> <p><strong>2. 客户端完成下载、上报方法</strong> 1)H5游戏带有视频形式的广告,客户端需写实现下载、上报的方法,让h5调用; 2)下载上报的方法,具体查看文档:H5-下载相关接口格式 下载上报接口; 注:先在测试环境测,然后正式环境测试,测试通过即可上线。</p> <p><strong>3. 接入方提供服务接口</strong>给腾讯 1)自有积分体系:任务回调接口、salt 2)无自有积分体系(积分托管):登录校验接口</p> <p><strong>4. 测试功能和数据</strong> 1)广告上报:广告上报正常(3~11状态上报正常) 2)下载能力:能实现应用下载 3)加积分成功:能收到任务回调,能加积分成功。(自有积分体系的,走任务回调,接入方服务端加积分;积分托管的,走登录校验,腾讯服务端加积分)【本环节,只需在正式环境测试】</p> <p><strong>5. 确认上线配置</strong> 1)游戏中可奖励用户积分,积分名称、用户单日最高领取积分数、单次奖励积分数可配置;</p> <h4>三、客户端下载上报方法</h4> <ul> <li> <p><strong>检查安装接口</strong> <code>let isInstall = window.android.CheckInstall("包名") //isInstall Boolean类型</code></p> </li> <li> <p><strong>下载apk并上报统计接口</strong> <code>window.android. InstallAPP("下载链接", "包名", "POSID", CONTEXT);</code></p> </li> <li><strong>注意:</strong> <ol> <li>下载接口的四个参数都是H5端调用是必须传入的,其中POSID表示统计点ID,CONTEXT是统计校验位。</li> <li>客户端拿到该四个参数后,用前两个参数执行下载和保存apk文件。并无论H5页面是否仍处于打开状态,都需要监听这个下载操作。</li> <li>当APP已经下载完,安装,激活需要分别调用Http协议的下载接口,带上posId和context完成上报。</li> <li>json格式传输数据,CONTEXT字段是int[ ] 类型</li> <li>上报接口的文档参照 <strong>下载上报接口</strong></li> </ol></li> </ul> <h4>五、下载上报接口</h4> <p><strong>请求URL:</strong> </p> <ul> <li><code>/extfe/reportGdt</code></li> </ul> <p>测试环境域名是https://testgmall.m.qq.com 正式环境域名是https://gmall.m.qq.com</p> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">positionId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>下载广告位id(H5传给客户端)</td> </tr> <tr> <td style="text-align: left;">context</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int[]</td> <td>校验位 (H5传给客户端)</td> </tr> <tr> <td style="text-align: left;">imei</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>设备码</td> </tr> <tr> <td style="text-align: left;">guid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>设备码</td> </tr> <tr> <td style="text-align: left;">phase</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>上报状态id- 转化: 5,下载: 6,安装: 7, 激活: 8</td> </tr> <tr> <td style="text-align: left;">account_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>账号id</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>0</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">ret</td> <td style="text-align: left;">int</td> <td>0成功,-1失败</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML