Skip to content

默认模式:页面底部的购买面板 ​

最简单的接入方式:引入 SDK,页面底部就会出现一个 RAKUFUN 购买面板;再告诉 SDK 当前是什么商品,就可以用了。不需要改动您的页面布局。

什么时候用: 想最快接入,或者暂时不确定用哪种模式时。如果想把购买入口放在页面里的某个位置,请看 按钮模式 或 横幅模式。

实时演示 ​

🎨 默认模式实时演示

查看底部滑动面板的效果

接入步骤 ​

第一步:引入 SDK ​

在商品页的 HTML 里加入这一行,一般放在 </body> 前面:

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>

页面加载完成后,底部会自动出现购买面板(日本 IP 下默认不显示,见下方常见问题)。

第二步:设置商品信息 ​

紧接着上面那一行,告诉 SDK 当前页面是什么商品。用户点击面板里的购买按钮时,会在新标签页打开 RAKUFUN 商品页,并带上这些信息。

html
<script>
  rakufun.setUIProductData({
    url: window.location.href,                  // 当前商品页的地址
    title: 'iPhone 15 Pro Max',                 // 商品名称
    price: '189800',                            // 价格,只写数字,不要带 ¥ 或逗号
    images: ['https://example.com/iphone.jpg'], // 商品图片,写完整地址
    description: '最新旗舰机型,256GB'            // 商品描述(可选)
  });
</script>

setUIProductData 一定要写在引入 SDK 那一行的后面,否则会提示 rakufun is not defined。还能传哪些字段,见 API 文档 - 商品信息字段。

常见问题 ​

底部面板不显示? ​

按顺序检查:

  1. 是不是在日本测试?日本 IP 下默认不显示。测试时可以临时调用 rakufun.enableDebug() 让它显示,测试完记得删掉
  2. 打开浏览器控制台,看 SDK 有没有加载成功、有没有报错
  3. 页面里是不是调用了 rakufun.disableAutoUI()?调用后面板不会自动显示
  4. 是不是调用了 rakufun.setUIMode('button') 或 setUIMode('banner')?切换到这两种模式后,底部面板就不显示了

点击面板里的购买按钮,提示「未设置商品数据」? ​

还没有调用 rakufun.setUIProductData(),按上面第二步加上即可。

其他接入方式 ​


有疑问?联系我们:service@rakufun.com

基于 MIT 许可证发布