Web集成

Xinstall 提供完整的 javascript 和 浮层banner样式集成两种方式供 Web 开发者实现完全自主的设计。两种对接方式都实现平台所有效果,前者灵活度更大,后者对接更方便。

1.JavaScript集成

这种方式可以集成到任何落地页面,直接复制以下代码到应用下载的落地页面代码中即可。

注意:文档可能更新不及时,最新代码请登陆Xinstall控制台,在左侧Web集成详情页查看

<!-- 以下为xinstall集成代码,建议在html文档中尽量靠前放置,加快初始化过程 -->
<!-- 强烈建议直接引用下面的cdn加速链接,可以得到最及时的更新,我们将持续跟踪各种主流浏览器的变化,提供最好的服务;不推荐将此js文件下载到自己的服务器-->
<script type="text/javascript" charset="UTF-8" src="//cdn.xinstall.com/xinstall.js"></script>
<script type="text/javascript">
  //xinstall初始化,xinstall初始化时将与xinstall服务器交互,应尽可能早的调用
  /*Web页面向app传递的json数据(json string/js Object),应用被拉起或是首次安装时,通过相应的iOS api可以获取此数据*/
  var data = XInstall.parseUrlParams(); //xinstall.js中提供的工具函数,解析url中的所有查询参数
  new XInstall({
    /*appKey必选参数,xinstall平台为每个应用分配的appKey*/
    appKey : "8l4hkz1",
    /*可选项,微信中打开自定义遮罩层*/
    //mask:function(){
    //  return "<div style='background:rgba(0,0,0,.5);position:fixed;left:0;top:0;filter:alpha(opacity=50);width:100%;height:100%;z-index:9999;'><div style='text-align:right; margin-top:1%; margin-right:5%;'><img style='width:70%; margin:0 auto;' src='https://cdn.xinstall.com/image/no_safari.png'/></div></div>"
    //},
    /*可选项,按钮携带特殊参数安装,idName(按钮的id值),params(当前按钮点击携带的传入值,传入类型强制为Array[Object])*/
    //buttonId: [
    //   { idName: 'downOne', params: {dataA: 'downOne', da: '1'} },
    //   { idName: 'downTwo', params: {dataB: 'downTwo', d: 'abc', c: 'cba'} },
    //   { idName: 'downThree' }
    // ],
    /*xinstall初始化完成的回调函数,可选*/
    onready : function() {
      var m = this,
          button = document.getElementById("downloadButton");
      button.style.visibility = "visible";
      /*用户点击某个按钮时(假定按钮id为downloadButton),安装app*/
      /*
        重要--如果button的ID(假定按钮id为downloadButton)已经在上面可选项buttonId内绑定了按钮携带特殊参数安装功能,
        则downloadButton这个ID的按钮就不需要在onready下面再次绑定点击事件
      */
      button.onclick = function() {
        m.wakeupOrInstall();
      }
    }
  }, data);
</script>

2.浮层banner样式集成

无需配置javascript,高速完成集成。将下面的标签复制到自己的Web分享页中即可完成对接

<script type=" text/javascript" charset="UTF-8" src="https://xinstall.top/xinstall/banner.js?xid=hnyeq4zcd2"> </script>

浮层表现形式在在Xinstall控制台的 Web集成-Banner浮层中进行配置。这种集成方式多在其他流量主投放推广时候使用。

3. 在H5页面中传参

参数传递入口在H5页面中,Xinstall提供两种方式进行参数传递

3.1 网址后拼接参数

在集成页面的地址后面以 key=value 的形式进行拼接参数进行传参。如果参数过长,建议使用在 url 后面传 id,在集成页面内通过 id 值来获取参数,并把参数加入初始化 xnstall 的 data 对象中,可以 URL 更加优雅简洁。

获取方式:App端SDK在获取时,通过key为UO获取

例子

原地址:https://app.xinstall.com/app/8l4hkz1?channelCode=zhihu

传递参数:key1=value1&key2=value2

传递参数的地址:https://app.xinstall.com/app/8l4hkz1?channelCode=zhihu&key1=value1&key2=value2

那么App将在key为UO中获得参数key1=value1&key2=value2

3.2 通过按钮点击事件传递参数

当单个落地页中有多个下载按钮事件,并且需要不同按钮的传递参数不同时候,3.1的传参方式将不能满足需求与。Xinstall所以也提供通过按钮点击事件传递参数的方法来解决该问题,具体见1.JavaScript集成的代码块

 /*可选项,按钮携带特殊参数安装,idName(按钮的id值),params(当前按钮点击携带的传入值,传入类型强制为Array[Object])*/
    //buttonId: [
    //   { idName: 'downOne', params: {dataA: 'downOne', da: '1'} },
    //   { idName: 'downTwo', params: {dataB: 'downTwo', d: 'abc', c: 'cba'} },
    //   { idName: 'downThree' }
    // ],

获取方式:App端SDK在获取时,通过key为CO获取

注意:如果button的ID(假定按钮id为downloadButton)已经在上面可选项buttonId内绑定了按钮携带特殊参数安装功能,则downloadButton这个ID的按钮就不需要在onready下面再次绑定点击事件。

results matching ""

    No results matching ""