快速开始
本页用最简单的默认模式(页面底部显示购买面板)带您完成接入,一般几分钟就能接好。
第一步:引入 SDK
在商品页的 HTML 里加入这一行,一般放在 </body> 前面:
html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>引入后,页面加载完成时,底部会自动出现 RAKUFUN 购买面板。
第二步:设置商品信息
紧接着上面那一行,告诉 SDK 当前页面是什么商品。用户点击面板里的购买按钮时,SDK 会在新标签页打开 RAKUFUN 商品页,并把这些信息带过去。
html
<script>
rakufun.setUIProductData({
url: window.location.href, // 当前商品页的地址
title: "iPhone 15 Pro Max", // 商品名称
price: "189800", // 价格,只写数字,不要带 ¥ 或逗号
images: ["https://example.com/iphone.jpg"] // 商品图片,写完整地址
});
</script>这段一定要写在引入 SDK 那一行的后面,否则会提示 rakufun is not defined。
完整示例
两步合在一起,并传入全部 13 个商品字段。前 4 个建议都传,其余的有就填:
html
<!DOCTYPE html>
<html>
<head>
<title>我的电商网站</title>
</head>
<body>
<div class="product">
<h1>Nintendo Switch OLED</h1>
<p class="price">¥37,980</p>
</div>
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
rakufun.setUIProductData({
// 建议传入
url: window.location.href, // 当前商品页的地址
title: "Nintendo Switch OLED", // 商品名称
price: "37980", // 价格,只写数字,不要带 ¥ 或逗号
images: ["https://example.com/switch-oled.jpg"], // 商品图片,可以传多张
// 可选字段
description: "最新款 7 英寸 OLED 显示屏 Switch", // 商品描述,超过 2000 字符会被截断
brand: "Nintendo", // 品牌
condition: "New", // 商品状态,如 全新 / 二手 / 展示品
minQuantity: "1", // 最低起购数量,不传默认 1
maxStock: "30", // 最大库存数量,不传默认 99
shippingInfo: "0", // 运费信息
deliveryTime: "1-3 days", // 预计配送时间
precautions: "含 1 年原厂保修", // 注意事项
productParameters: "Display: 7-inch OLED, Storage: 64GB" // 规格参数
});
</script>
</body>
</html>每个字段的类型、默认值和更多例子见 API 文档 - 商品信息字段。另外还有一个 timestamp 字段,由 SDK 自动生成,不需要传。
检查是否接好了
- 打开您的商品页,页面底部应该出现 RAKUFUN 购买面板
- 点击面板里的购买按钮,应该会在新标签页打开 RAKUFUN 商品页,并显示您传入的商品信息
日本 IP 下面板默认不显示。如果您在日本测试,可以在第二步的代码前面临时加一行 rakufun.enableDebug();,面板就会显示出来,页面右上角会有 DEBUG 标记。测试完记得删掉这行。
面板还是不出来,请看 默认模式 - 常见问题。
接下来
现在接好的是默认模式(底部面板)。接下来可以按需要看:
- 想换一种展示方式:比如把购买按钮放在价格下面、放一条横幅,或者用自己设计的按钮,看 UI 模式,里面有四种方式的对比和选择建议
- 想先体验用户的购买流程:看 示例,有可以直接点击的在线演示
- 想查某个方法或字段的详细说明:看 API 文档
有疑问?联系我们:service@rakufun.com