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

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


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>

页面列表

ITEM_HTML