swan.showFavoriteGuide

引导组件有统一的策略,若用户未执行过关注操作,则3天内不再出现引导组件;若用户执行过关注操作,则引导组件对该用户将不再出现。最低支持版本 3.20.4 。工具和真机中的实现有区别,详见API 实现差异添加到我的小程序引导 swan.showFavoriteGuide - 图1

解释:支持在小程序内调起关注小程序引导组件,引导用户关注小程序。引导组件设计文档详见:关注小程序引导

方法参数

Object object

object参数说明 :

属性名类型必填默认值说明
typeStringbar引导组件类型,有效值: bar,tip。
contentStringbar: 关注小程序; tip: 关注小程序,下次使用更便捷。引导组件文字,不支持开发者自定义。
successFunction接口调用成功的回调
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

触发时机开发者可自定义

以下为建议触发场景1. 支付后场景2. 购买会员、升级会员、知识付费等场景3. 运营活动等场景4. 景区导览、线下活动等线下扫码场景

示例

在开发者工具中预览效果

扫码体验

添加到我的小程序引导 swan.showFavoriteGuide - 图2请使用百度APP扫码

目前关注小程序引导组件支持以下两种类型,开发者可根据自身业务进行选择:

浮层引导(type=bar)

  1. 一直展现:用户点击关闭,浮层引导消失;点击关注按钮可直接关注小程序。
  1. swan.showFavoriteGuide({
  2. type: 'bar',
  3. content:'关注小程序'
  4. })

气泡引导(type=tip)

  1. 引导组件 5s 后自动消失,组件箭头指向小程序菜单。
  1. swan.showFavoriteGuide({
  2. type: 'tip',
  3. content: '关注小程序,下次使用更便捷。'
  4. })

用户通过引导关注组件“关注小程序”后,可以在百度APP-我的“我的小程序”中看到它。

Bug & Tip

Bug:浮层引导(type=bar)时,用户点击左侧关闭也会触发此API的success回调。