3. WEB 集成

shareinstall 提供完整的 javascript api,方便 Web 开发者实现完全自主的设计 集成步骤:

1、推广页中引用 jshareinstall.min.js 文件

特别提示:请直接使用此链接,不要将此链接下载到您项目中,否则,在更新数据接口或 API 的时候可能会导致链接失效。

<script type="text/javascript" src="https://www.shareinstall.com.cn/js/page/jshareinstall.min.js"></script>

2、在 HTML 页面中增加一个或者多个打开 app 的元素标签

一般开发者会使用 CSS 样式重置这个链接的外观,使其看起来像一个按钮,建议使用“打开 APP”、“在 APP 中购买”、“在 APP 中阅读”等对用户有实际引导意义的文案,请尽量避免使用“下载 APP”,在以往的用户使用习惯中我们发现使用“下载 APP”的链接对比使用“打开 APP”的链接的点击率会低。

<a href="javascript:void(0);" id="downloadButton"></a>

3、在 H5 页面中动态传参

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

4、参数说明

<script type="text/javascript">
    // shareinstall初始化,初始化时将与shareinstall服务器交互,应尽可能早的调用
    /* web页面向app传递的json数据(json string/js Object),应用被拉起或是首次安装时,通过相应的android/ios api可以获取此数据 */
    var data = ShareInstall.parseUrlParams(); // shareinstall.js中提供的工具函数,解析url中的所有查询参数
    new ShareInstall({
        appKey: "shareinstall为当前应用分配的appkey",
        // 可选项,微信中打开自定义遮罩层
        // shadow: function(){
        //  return "<div id='shareinstall_shadow' style='position:fixed;left:0;top:0;background:rgba(0,255,0,0.5);filter:alpha(opacity=50);width:100%;height:100%;z-index:10000;'></div>"
        // },
        /* 可选参数,是否优先考虑拉起app,以牺牲下载体验为代价 */
        // preferWakeup: true,
        /* 可选参数,唤醒操作的执行时长,超时后将放弃唤醒并执行下载,默认1500,单位是毫秒 */
        // timeout: 1500,
        onready: function() {
            // shareinstall已成功回调
            var m = this, button = document.getElementById("downloadButton");
            button.style.visibility = "visible";

            /* 用户点击某个按钮时(假定按钮id为downloadButton),安装app */
            button.onclick = function() {
                m.wakeupOrInstall();
            }
        }
    }, data);
</script>
Copyright © dsx2016.com 2019 all right reserved,powered by Gitbook该文章修订时间: 2020-06-30 17:06:11

results matching ""

    No results matching ""