Skip to content

横幅模式:放在指定位置的横幅 ​

在您页面的指定位置(比如页面顶部、正文上方)显示一条 RAKUFUN 横幅。用户点击横幅任意位置,会在新标签页打开 RAKUFUN 商品页完成购买。

什么时候用: 想要一个比按钮更显眼的入口。

横幅的内容是固定的:RAKUFUN 图标、「RAKUFUN」「日本代购服务」文字和「立即购买」按钮(文字目前固定为中文)。横幅上不显示商品的图片、标题和价格。

实时演示 ​

🎨 横幅模式实时演示

查看横向横幅如何渲染到容器中

横幅容器

SDK 会在此容器中渲染横向横幅

接入步骤 ​

第一步:在想放横幅的位置加一个空的 div ​

html
<body>
    <!-- 横幅会显示在这里 -->
    <div class="rakufun-sdk-embed-banner"></div>

    <div class="main-content">
        <h1>商品详情</h1>
        <!-- 您的页面内容 -->
    </div>
</body>

类名必须是 rakufun-sdk-embed-banner。同一个页面可以放多个,每个位置都会显示一条横幅。

第二步:引入 SDK,切换到横幅模式,并设置商品信息 ​

把下面这段放在页面里,一般放在 </body> 前面:

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  // 切换到横幅模式(不写这行,显示的会是底部面板)
  rakufun.setUIMode('banner');

  // 告诉 SDK 当前是什么商品(横幅上不显示,但用户点击后会带到 RAKUFUN 商品页)
  rakufun.setUIProductData({
    url: window.location.href,                 // 当前商品页的地址
    title: 'PlayStation 5 数字版',              // 商品名称
    price: '49980',                            // 价格,只写数字,不要带 ¥ 或逗号
    images: ['https://example.com/ps5.jpg'],   // 商品图片,写完整地址
    description: '次世代游戏主机,超快加载速度'   // 商品描述(可选)
  });
</script>

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

横幅的尺寸 ​

横幅的高度由内容决定:电脑上约 74px;屏幕宽度不超过 768px(手机等)时,内容会改成上下排列,高度约 121px。放置时请给它留出相应的空间。

常见问题 ​

横幅不显示? ​

按顺序检查:

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

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

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

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

其他接入方式 ​


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

基于 MIT 许可证发布