概述:

本文档服务于对接方需要从兔展H5作品内唤起手机App的业务场景,本方案使用微信开放标签中的wx-open-launch-app进行唤起App,详见微信开放标签文档

提前条件:

  1. 获取兔展H5作品地址(在工作台作品预览窗口取到作品访问地址),替换域名为renderer.rabbitpre.com,完整地址形如:https://renderer.rabbitpre.com/m2/xxxx。
  2. 使用前需将「 JS 接口安全域名绑定的服务号」绑定在「移动应用的微信开放平台账号」下,并确保服务号与此开放平台账号同主体且均已认证。
    请前往 微信开放平台-管理中心-公众号详情-接口信息 设置域名与所需跳转的移动应用,并放置校验文件(可能需要寻求兔展运维支持)。
    需添加的业务域名如下:
    1. renderer.rabbitpre.com
    2. wechat.rabbitpre.com
    3. bws.rabbitpre.com

注:

绑定域名和移动应用

  1. 绑定域名的要求:
  • 域名须为当前服务号的 JS 安全域名
  • 域名只能同时绑定一个移动应用,因此须确保域名未被其他移动应用绑定
  1. 绑定移动应用的要求
  • 只能绑定同一微信开放平台账号下审核通过的移动应用
  1. 绑定次数
  • 每月可修改绑定3次

我需要准备什么?

  1. 本授权功能需接入方企业先在兔展营销云开通 “数据集成” 模块,并获得 “自建应用” 的使用权限。

  2. 自建应用内申请开通 编辑器 → H5跳转APP,后续联系管理员审核通过。应用配置界面如下:

    添加后,点击“编辑”进入对应设置页:
  3. 配置对应APP名称,APPID,唤起APP失败时IOS和安卓系统的跳转地址。
    额外信息:提供给APP进行使用的数据,若需要添加当前作品的地址,则数据格式为  {{当前作品地址}}。

  4. 编辑器制作作品时,添加带触发功能的组件(按钮、图片、形状、文字等),在设置面板触发选项卡下进行配置,具体配置如下:

  5. 若APP中需要作品中的动态参数,可以打开对应的开关。

  6. 作品保存后,当用户点击配置了跳转APP的按钮时,即可发起唤起APP。

跳转按钮唤起APP的流程

extinfo数据:

接入方可以使用微信开放平台提供的方法获取跳转携带的extinfo。 App获取开放标签<wx-open-launch-app>中的extinfo数据

// 兔展H5唤起APP所抛出的extinfo     
const extinfo = {
  // 动态参数,需在编辑器中开启
  [key]: {},
  // 额外信息 在自建应用中自定义的数据
  additionalMessage: "{{当前作品地址}},额外信息",
  // 当前作品地址
  address: "https://renderer.rabbitpre.com/m2/xxxx",
}




















  • 无标签