Skip to content

快速开始 ​

本页用最简单的默认模式(页面底部显示购买面板)带您完成接入,一般几分钟就能接好。

第一步:引入 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 自动生成,不需要传。

检查是否接好了 ​

  1. 打开您的商品页,页面底部应该出现 RAKUFUN 购买面板
  2. 点击面板里的购买按钮,应该会在新标签页打开 RAKUFUN 商品页,并显示您传入的商品信息

日本 IP 下面板默认不显示。如果您在日本测试,可以在第二步的代码前面临时加一行 rakufun.enableDebug();,面板就会显示出来,页面右上角会有 DEBUG 标记。测试完记得删掉这行。

面板还是不出来,请看 默认模式 - 常见问题。

接下来 ​

现在接好的是默认模式(底部面板)。接下来可以按需要看:

  • 想换一种展示方式:比如把购买按钮放在价格下面、放一条横幅,或者用自己设计的按钮,看 UI 模式,里面有四种方式的对比和选择建议
  • 想先体验用户的购买流程:看 示例,有可以直接点击的在线演示
  • 想查某个方法或字段的详细说明:看 API 文档

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

基于 MIT 许可证发布