默认模式:页面底部的购买面板
最简单的接入方式:引入 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 文档 - 商品信息字段。
常见问题
底部面板不显示?
按顺序检查:
- 是不是在日本测试?日本 IP 下默认不显示。测试时可以临时调用
rakufun.enableDebug()让它显示,测试完记得删掉 - 打开浏览器控制台,看 SDK 有没有加载成功、有没有报错
- 页面里是不是调用了
rakufun.disableAutoUI()?调用后面板不会自动显示 - 是不是调用了
rakufun.setUIMode('button')或setUIMode('banner')?切换到这两种模式后,底部面板就不显示了
点击面板里的购买按钮,提示「未设置商品数据」?
还没有调用 rakufun.setUIProductData(),按上面第二步加上即可。
其他接入方式
有疑问?联系我们:service@rakufun.com