开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
运营攻略
小程序基础配置
订单中心
小程序服务
小程序商品
商品创建及管理
商品进公域推广
商品数据及对账
蚂蚁门店管理
小程序客服设置
引流获客
用户留存
用户召回
小程序数据分析
蚂蚁特色能力
激励政策
小程序经营分(租赁)
服务竞争力指数
体验提升
产品动态
商家案例
公告专区
收藏
我的文档
设置
1、用户路径展示

2、插件集成说明
2.1)订阅“本地生活商品插件”
开放后台订购
登入进入对应小程序详情页,点击对应小程序,进入【插件服务】菜单:


点击订购其他插件后跳转到订购插件页面,搜索【本地生活商品插件】并完成订阅。


服务市场订购
通过后台,进入【服务市场】-【开发者资源】;

搜索并选择【本地生活商品插件】;

进行【本地生活商品插件】订购。

2.2)集成“本地生活商品插件”
支持“静态加载”、“懒加载模式加载”和“动态加载”三种模式集成,更多内容可参考支付宝插件接入文档
静态加载模式下仅支持一个小程序最多关联 10 个插件;当小程序少于10个静态插件时,推荐使用懒加载模式加载;
动态加载无插件个数限制。
2.2.1)普通静态加载
兼容规则
插件的运行要求小程序基础库为 1.22.4 及以上版本,支付宝客户端 10.1.85 及以上的版本。若不满足请将以下代码放到小程序app.js文件中;
// app.js
if (!my.caniuse('plugin') && !my.iside) {
  my.ap && my.ap.updatealipayclient && my.ap.updatealipayclient(); // 如果动态加载不可用则打开支付宝客户端升级界面
}
app({
  onlaunch() {},
  onshow() {},
});
app.json配置
{
  "plugins": {
    "grouppurchaseoucherplugin": {
      "version": "*", // 目前只支持设置 * ,自动选择版本
      "provider": "插件id"
    },
  }
}
页面配置
通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)
my.relaunch({
  url: `plugin://grouppurchaseoucherplugin/index?outitemid=${outitemid}`
  // outitemid为外部商品id
});
2.2.2)懒加载模式加载
兼容规则
使用懒加载模式的小程序项目支持 ide 3.0.0 及以上版本编译构建。懒加载模式插件的运行小程序支持基础库 2.7.18 及以上版本,如不符合建议请
appjson配置
// 使用静态懒加载
{
  "plugins": {
    "grouppurchaseoucherplugin": {
      "lazy": true, // 开启懒加载模式
      "version": "*", // 目前只支持设置 * ,自动选择版本
      "provider": "2021003190661263"
    }
  },
  // 配置懒加载插件预加载
  "preloadrule": {
    "pages/index/index": {  // 这里路径为需要加载插件的本地小程序页面路径
      "network": "all",
      "plugins": ["grouppurchaseoucherplugin"]
    }
  }
}
页面配置
通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)
my.relaunch({
  url: `plugin://grouppurchaseoucherplugin/index?outitemid=${outitemid}`
  // outitemid为外部商品id
});
2.2.3)动态加载
appjson配置
{
  "usedynamicplugins": true
}
页面配置
通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)
page({
  data: {
  },
  onload() {
  },
  navtopluginpage() {
    // 跳转到插件页面,index为插件plugin.json中对外暴露的页面
    my.relaunch({
      url: `dynamic-plugin://插件id/index?outitemid=${outitemid}`
  // outitemid为外部商品id
    });
  },
});
2.3) 公域到小程序插件地址
outitemid:外部商品id
orderid:订单号id
encodeuricomponent为jsapi,链接中page后的内容需要url编码
链接暂不支持拼接商家埋点
规则:
alipays://platformapi/startapp?appid=宿主a&page=${encodeuricomponent(plugin-private://插件a/页面?outitemid=${outitemid})}
商品详情页:
alipays://platformapi/startapp?appid=宿主小程序appid&page=${encodeuricomponent(plugin-private://插件id/pages/index/index?outitemid=${outitemid})}
订单详情页:
alipays://platformapi/startapp?appid=宿主小程序appid&page=${encodeuricomponent(plugin-private://插件id/pages/orderdetail/orderdetail?orderid=${orderid})}
2.4)开发环境联调说明(非必须流程)
1)第一步:需提供appid给支付宝插件技术小二,进行添加开发环境配置
2)第二步:在支付宝开放平台小程序插件服务的插件联调中确认授权,实现在开发环境进行联调
2.5)首次进入插件处理登入逻辑
若宿主小程序在首次进入插件的时候需要强验证登入逻辑,可以在在宿主小程序的onlaunch钩子里提供方法
const plugin = requireplugin('myplugin')
const login = () => {
  // ...处理登入验证逻辑 验证后才可转到插件
}
plugin.setappnavigater(() => {
  login()
})
若要支持从支付宝公域到插件也支持登入逻辑则在宿主小程序onshow钩子里也需要提供方法。
app({
  onlaunch() {
    // 第一次打开
    // options.query == {number:1}
    // console.log(options);
    // console.info('app onlaunch');
    // 处理登入逻辑
  },
  onshow() {
    // 从后台被 scheme 重新打开
    // options.query == {number:1}
    // console.log(options);
    // 处理登入逻辑
  },
});
2.6)“去小程序使用”链接规则

链接是在创建本地生活商品时写入,需根据以下url规则配置:
url格式
alipays://platformapi/startapp?appid=[appid]&page=[page]&query=[query]
跳非宿主/跳宿主
非宿主跳转:支持最小传appid,page、query可不传,默认跳凯发k8官方网娱乐官方首页;
跳宿主:支持最小传appid和page, query可不传,跳指定页面;
query的获取
getlaunchoptionssync
参考文档
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图