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&device_id&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&device_id&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>