MW Logo

魔窗mLink 小程序SDK集成文档



1. 导入SDK

特别提示: 下载小程序SDK放入utils 文件夹

特别提示: 把 https://s.mlinks.cc 和 https://stats.mlinks.cc 加入微信公众平台安全域名

import mwSdk from '../../utils/mw-sdk.min.js'

2. 在WHTML页面中准备一个或多个用于打开APP的button元素

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

<button open-type="launchApp" app-parameter="{{parameter}}" binderror="launchAppError">打开APP</button>

3. 魔窗后台配置好mLink必要参数并且生成一条短链

请在后台配置mLink服务获取短链接, 短链看上去是这样的: https://a.mlinks.cc/ABCD, 其中ABCD为短链KEY;

4. 初始化SDK

data: {
parameter: '',
},
/* --------------- */
onReady: function onReady() {
    this.data.sdk = new mwSdk({
      wx,
      mlink: 'https://ajvmil.mlinks.cc/Abmb', // 短链地址
      params:{
        a:"zdy",  // 动态参数 
      },
      callback: ({link}) => {
        this.setData({
          parameter: link,
        })
      }
    })
  },

5. params 选项

options 选项

params:{
    a:"zdy",  // 动态参数 
},
  1. options

    类型: Object
    选填
    描述: 传给APP的参数, 这些参数必须是您在魔窗后台的mLink服务配置中设置好的参数占位符, 否则会被过滤掉; 如果APP已安装, 那么唤起应用时从打开APP的URI Scheme或Universal Link中就能获得参数, 如果是第一次安装, 这些参数可以通过魔窗SDK的API从我们的服务器取回; 关于SDK如何实现mLink请参考:

     

     

    示例:
    您在后台的mLink服务配置中填的URI Scheme:    myapp://path/acticle?articleId= :id
    options.params:    { id: ' 123456' }
    最终的URI Scheme是这样的:    myapp://path/acticle?articleId= 123456