自定义模式:使用您自己的按钮
不用 SDK 自带的面板、按钮或横幅,而是用您网站上自己的「购买」按钮。用户点击按钮时,您调用 rakufun.quickBuy() 把商品信息交给 SDK,SDK 会在新标签页打开 RAKUFUN 的商品页,用户在那里完成购买。
什么时候用: 希望购买按钮的样式、文字、位置完全按自己的设计来,或者要把购买入口放进自己的弹窗、表单里。如果只想快速接入,用 默认模式 更省事。
接入步骤
第一步:引入 SDK,并关掉自带的面板
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
rakufun.disableAutoUI();
</script>SDK 引入后,默认会在页面底部显示自己的购买面板。disableAutoUI() 就是用来关掉它的,紧跟在引入 SDK 的那一行后面写即可。不写的话,页面上会同时出现您的按钮和 SDK 的面板。
第二步:放一个您自己的按钮
<button id="my-buy-button">立即购买</button>按钮的样式、文字、位置都由您决定。
第三步:点击按钮时调用 quickBuy
document.getElementById('my-buy-button').addEventListener('click', async () => {
const result = await rakufun.quickBuy({
url: window.location.href, // 当前商品页的地址
title: 'Bose QuietComfort 耳机', // 商品名称
price: '26800', // 价格,只写数字,不要带 ¥ 或逗号
images: ['https://example.com/product.jpg'] // 商品图片,写完整地址
});
if (!result.success) {
console.error('购买失败:', result.message);
alert('购买失败,请重试');
}
});quickBuy 一定要在用户点击时调用。它会打开一个新标签页,不是由点击触发的话,浏览器可能会拦截。
完整示例
把三步合在一起,可以直接复制到页面里试:
<!DOCTYPE html>
<html>
<head>
<title>自定义购买按钮</title>
</head>
<body>
<h1>Bose QuietComfort 耳机</h1>
<img src="https://example.com/product.jpg" alt="商品图片">
<p class="price">¥26,800</p>
<!-- 您自己的按钮 -->
<button id="my-buy-button">🛒 立即购买</button>
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
rakufun.disableAutoUI(); // 不显示 SDK 自带的底部面板
document.getElementById('my-buy-button').addEventListener('click', async () => {
const result = await rakufun.quickBuy({
url: window.location.href,
title: 'Bose QuietComfort 耳机',
price: '26800',
images: ['https://example.com/product.jpg'],
description: '顶级降噪耳机'
});
if (!result.success) {
console.error('购买失败:', result.message);
alert('购买失败,请重试');
}
});
</script>
</body>
</html>quickBuy 的返回结果
quickBuy 不会抛出异常,不需要写 try/catch,看返回的 result.success 就可以:
| 情况 | 返回的 result | 说明 |
|---|---|---|
| 成功 | { success: true, url, message, data } | RAKUFUN 商品页已在新标签页打开,当前页面不会跳走 |
| 失败 | { success: false, message, error } | message 是失败原因,可以打印出来排查 |
可以传哪些商品信息
上面的例子只传了几个字段。信息传得越完整,用户在 RAKUFUN 商品页看到的内容就越全。全部字段如下:
await rakufun.quickBuy({
// 建议传入
url: window.location.href, // 当前商品页的地址
title: "Nintendo Switch OLED", // 商品名称
price: "37980", // 价格,只写数字
images: [ // 商品图片,可以传多张
"https://example.com/switch-1.jpg",
"https://example.com/switch-2.jpg"
],
// 可选
description: "7 英寸 OLED 显示屏,64GB 存储空间", // 商品描述,超过 2000 字符会被截断
brand: "Nintendo", // 品牌
condition: "全新", // 商品状态,如 全新 / 二手 / 展示品
minQuantity: "1", // 最低起购数量,不传默认 1
maxStock: "100", // 最大库存数量,不传默认 99
shippingInfo: "免运费", // 运费信息
deliveryTime: "3-5 个工作日", // 预计配送时间
precautions: "支持一年保修", // 注意事项
productParameters: "尺寸: 102mm × 242mm × 13.9mm, 重量: 约 320g" // 规格参数
});每个字段的详细说明见 API 文档 - 商品信息字段。
在 React、Vue 等框架中使用
用法一样:引入 SDK 后调用一次 rakufun.disableAutoUI(),然后在按钮的点击事件里调用 window.rakufun.quickBuy()。以 React 为例:
function BuyButton({ product }) {
const handleBuy = async () => {
const result = await window.rakufun.quickBuy({
url: window.location.href,
title: product.title,
price: product.price,
images: product.images
});
if (!result.success) {
alert('购买失败,请重试');
}
};
return <button onClick={handleBuy}>立即购买</button>;
}常见问题
页面上除了我的按钮,还出现了 SDK 的底部面板?
没有调用 rakufun.disableAutoUI(),或者调用得太晚了。把它写在引入 SDK 那一行的紧后面。
点击按钮后没有打开新页面?
- 打开浏览器控制台,看有没有打印「购买失败」和失败原因
- 看浏览器地址栏是否提示拦截了弹出窗口。quickBuy 要在用户点击时调用,不要放在页面加载或定时器里
- 控制台如果提示
rakufun is not defined,说明 SDK 还没引入,检查<script>的地址和位置
调用 quickBuy 后,当前页面会跳走吗?
不会。RAKUFUN 商品页在新标签页打开,用户还停留在您的网站上。
日本的访客也会看到我的按钮吗?
会。其他三种模式在日本 IP 下默认不显示,是 SDK 替您隐藏了它自己的界面;自定义模式的按钮是您自己的,SDK 不会去隐藏它。如果只想让海外访客看到,请联系我们。
其他接入方式
有疑问?联系我们:service@rakufun.com