横幅模式:放在指定位置的横幅
在您页面的指定位置(比如页面顶部、正文上方)显示一条 RAKUFUN 横幅。用户点击横幅任意位置,会在新标签页打开 RAKUFUN 商品页完成购买。
什么时候用: 想要一个比按钮更显眼的入口。
横幅的内容是固定的:RAKUFUN 图标、「RAKUFUN」「日本代购服务」文字和「立即购买」按钮(文字目前固定为中文)。横幅上不显示商品的图片、标题和价格。
实时演示
🎨 横幅模式实时演示
查看横向横幅如何渲染到容器中
横幅容器
SDK 会在此容器中渲染横向横幅
接入步骤
第一步:在想放横幅的位置加一个空的 div
html
<body>
<!-- 横幅会显示在这里 -->
<div class="rakufun-sdk-embed-banner"></div>
<div class="main-content">
<h1>商品详情</h1>
<!-- 您的页面内容 -->
</div>
</body>1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
类名必须是 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>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 文档 - 商品信息字段。
横幅的尺寸
横幅的高度由内容决定:电脑上约 74px;屏幕宽度不超过 768px(手机等)时,内容会改成上下排列,高度约 121px。放置时请给它留出相应的空间。
常见问题
横幅不显示?
按顺序检查:
- 是不是在日本测试?日本 IP 下默认不显示。测试时可以临时调用
rakufun.enableDebug()让它显示,测试完记得删掉 - 容器的类名是不是
rakufun-sdk-embed-banner,有没有拼错 - 有没有调用
rakufun.setUIMode('banner') - 打开浏览器控制台,看 SDK 有没有加载成功、有没有报错
想在用户点击后、打开 RAKUFUN 之前先弹个确认框?
用 setUICartHandler。函数返回 true 才会继续购买,返回其他值都会取消:
javascript
rakufun.setUICartHandler(async (product) => {
return confirm(`确认购买 ${product.title}?`);
});1
2
3
2
3
其他接入方式
有疑问?联系我们:service@rakufun.com