h5活动(互动广告)
<h4>请求活动接口(get请求)</h4>
<p><code>/page/actpage</code></p>
<p>测试环境域名是https://testgmall.m.qq.com 正式环境域名是https://gmall.m.qq.com</p>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>是否必须</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>product_id</td>
<td>int</td>
<td>是</td>
<td>珊瑚产品id,在珊瑚后台获取</td>
</tr>
<tr>
<td>act_conf_id</td>
<td>int</td>
<td>是</td>
<td>活动id,在珊瑚后台获取</td>
</tr>
<tr>
<td>account_id</td>
<td>string</td>
<td>是</td>
<td>用户账户ID</td>
</tr>
<tr>
<td>login_key</td>
<td>string</td>
<td>是</td>
<td>用户登录票据,用于校验用户的登录状态合法性</td>
</tr>
<tr>
<td>device_id</td>
<td>string</td>
<td>是</td>
<td>用户设备id,可以用imei,或者其他标记设备的参数</td>
</tr>
<tr>
<td>nickname</td>
<td>string</td>
<td>否</td>
<td>用户昵称,传encode,活动中有用户排行榜时需带上此参数</td>
</tr>
<tr>
<td>avatar</td>
<td>string</td>
<td>否</td>
<td>用户头像,传encode,活动中有用户排行榜时需带上此参数</td>
</tr>
</tbody>
</table>
<h4>一、对接工作</h4>
<p><strong>1. 后台长创建配置</strong>
活动入口:商城运营—爆款活动—创建活动—活动入口—创建
活动配置:珊瑚后台配置手册---互动广告
用户端显示,方法1:商城装修中,活动模块里配置,保存可以在h5商城首页显示
用户端显示,方法2:请求活动接口</p>
<p><strong>2. 客户端完成下载、上报方法</strong>
1)活动,需要校验用户登录状态,所以需要<strong>【登陆态回调】接口</strong>。
2)活动,需要积分参与活动,所以<strong>自有积分体系</strong>的需要提供【查积分】、【扣积分】、【返还积分】接口。
3)活动<strong>如果选择了广告兜底</strong>,出的是卡券形式的广告,客户端需写实现下载、上报的方法,让h5调用;
4)下载上报的方法,具体查看文档:H5-下载相关接口格式 下载上报接口;</p>
<p><strong>3. 测试功能和数据</strong>
1)功能正常:查积分、扣积分、活动发奖、活动记录、活动运行都正常。
2)下载能力(选择广告兜底时):能实现跳转h5、能实现应用下载。
3)广告上报(选择广告兜底时):广告上报正常(3~8状态上报正常)。
注:选择广告兜底时,广告上报测试通过才可上线。</p>
<p><strong>4. 确认上线配置</strong>
1)互动广告,正式环境接入方自主配置。</p>
<h4>二、H5-下载相关接口格式</h4>
<ul>
<li>
<p>检查安装接口</p>
<pre><code>let isInstall = window.android.CheckInstall("包名") //isInstall Boolean类型</code></pre>
</li>
<li>下载apk并上报统计接口
<pre><code>window.android. InstallAPP("下载链接", "包名", "POSID", CONTEXT);</code></pre></li>
</ul>
<h6>注意:</h6>
<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>
<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>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>
<h4>四、互动广告模板展示</h4>
<p><img src="http://mmgr.gtimg.com/gjsmall/v_tyuhhuang/shanhu/14.png" alt="" /></p>
<p><img src="http://mmgr.gtimg.com/gjsmall/v_tyuhhuang/shanhu/15.png" alt="" /></p>