Skip to content

按钮模式:放在指定位置的购买按钮 ​

在您页面的指定位置(比如价格下面、加入购物车按钮旁边)显示一个 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>

类名必须是 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>

还能传哪些字段,见 API 文档 - 商品信息字段。

按钮的样式 ​

按钮的样式由 SDK 统一提供,带鼠标悬停和点击效果,和 RAKUFUN 的品牌风格一致。按钮文字固定为英文「Ship internationally via RAKUFUN」,暂不支持修改。

常见问题 ​

按钮不显示? ​

按顺序检查:

  1. 是不是在日本测试?日本 IP 下默认不显示。测试时可以临时调用 rakufun.enableDebug() 让它显示,测试完记得删掉
  2. 容器的类名是不是 rakufun-sdk-embed-button,有没有拼错
  3. 有没有调用 rakufun.setUIMode('button')
  4. 打开浏览器控制台,看 SDK 有没有加载成功、有没有报错

想在用户点击后、打开 RAKUFUN 之前先弹个确认框? ​

用 setUICartHandler。函数返回 true 才会继续购买,返回其他值都会取消:

javascript
rakufun.setUICartHandler(async (product) => {
  return confirm(`确认购买 ${product.title}?`);
});

其他接入方式 ​


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

基于 MIT 许可证发布