按钮模式:放在指定位置的购买按钮
在您页面的指定位置(比如价格下面、加入购物车按钮旁边)显示一个 RAKUFUN 购买按钮。用户点击后,会在新标签页打开 RAKUFUN 商品页完成购买。
什么时候用: 想让购买入口出现在商品信息旁边,而不是页面底部。按钮的样式和文字由 SDK 决定;如果想用自己设计的按钮,请看 自定义模式。
实时演示
🎨 按钮模式实时演示
查看购买按钮如何渲染到容器中
按钮容器
SDK 会在此容器中渲染购买按钮
接入步骤
第一步:在想放按钮的位置加一个空的 div
html
<div class="product-info">
<h1>Sony WH-1000XM5 无线耳机</h1>
<p class="price">¥54,800</p>
<!-- 购买按钮会显示在这里 -->
<div class="rakufun-sdk-embed-button"></div>
</div>1
2
3
4
5
6
7
2
3
4
5
6
7
类名必须是 rakufun-sdk-embed-button。同一个页面可以放多个,每个位置都会显示一个按钮。
第二步:引入 SDK,切换到按钮模式,并设置商品信息
把下面这段放在页面里,一般放在 </body> 前面:
html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
// 切换到按钮模式(不写这行,显示的会是底部面板)
rakufun.setUIMode('button');
// 告诉 SDK 当前是什么商品
rakufun.setUIProductData({
url: window.location.href, // 当前商品页的地址
title: 'Sony WH-1000XM5 无线耳机', // 商品名称
price: '54800', // 价格,只写数字,不要带 ¥ 或逗号
images: ['https://example.com/headphones.jpg'], // 商品图片,写完整地址
description: '业界领先的降噪技术' // 商品描述(可选)
});
</script>1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
还能传哪些字段,见 API 文档 - 商品信息字段。
按钮的样式
按钮的样式由 SDK 统一提供,带鼠标悬停和点击效果,和 RAKUFUN 的品牌风格一致。按钮文字固定为英文「Ship internationally via RAKUFUN」,暂不支持修改。
常见问题
按钮不显示?
按顺序检查:
- 是不是在日本测试?日本 IP 下默认不显示。测试时可以临时调用
rakufun.enableDebug()让它显示,测试完记得删掉 - 容器的类名是不是
rakufun-sdk-embed-button,有没有拼错 - 有没有调用
rakufun.setUIMode('button') - 打开浏览器控制台,看 SDK 有没有加载成功、有没有报错
想在用户点击后、打开 RAKUFUN 之前先弹个确认框?
用 setUICartHandler。函数返回 true 才会继续购买,返回其他值都会取消:
javascript
rakufun.setUICartHandler(async (product) => {
return confirm(`确认购买 ${product.title}?`);
});1
2
3
2
3
其他接入方式
有疑问?联系我们:service@rakufun.com