Skip to content

クイックスタート ​

ここでは、最も簡単なデフォルトモード(画面下部に購入パネルを表示)を例に、導入の手順を説明します。通常は数分で導入を完了できます。

手順1:SDKを読み込む ​

商品ページのHTMLに以下の1行を追加します。通常は </body> の直前に記述します。

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>

読み込むと、ページの読み込み完了時に画面下部にRAKUFUNの購入パネルが自動で表示されます。

手順2:商品情報を設定する ​

上記の1行の直後で、表示中のページがどの商品かをSDKに設定します。ユーザーがパネルの購入ボタンをクリックすると、SDKが新しいタブでRAKUFUNの商品ページを開き、この情報を引き渡します。

html
<script>
  rakufun.setUIProductData({
    url: window.location.href,                  // 商品ページのURL
    title: "iPhone 15 Pro Max",                 // 商品名
    price: "189800",                            // 商品価格(数字のみ。¥ やカンマは含めない)
    images: ["https://example.com/iphone.jpg"]  // 商品画像(完全なURLで指定)
  });
</script>

このコードは、必ずSDKを読み込む行より後に記述してください。前に記述すると rakufun is not defined というエラーになります。

完全な設定例 ​

2つの手順をまとめ、商品情報13項目をすべて指定した例です。先頭の4項目は指定を推奨します。それ以外の項目は、情報がある場合に指定してください。

html
<!DOCTYPE html>
<html>
<head>
    <title>ECサイト</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,                         // 商品ページのURL
            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日",                             // お届け目安
            precautions: "メーカー1年保証付き",                   // 商品に関する注意事項
            productParameters: "ディスプレイ:7インチOLED、ストレージ:64GB"  // 商品の仕様情報
        });
    </script>
</body>
</html>

各フィールドの型・省略時の値・その他の例は、APIリファレンス - 商品情報フィールドをご覧ください。このほかに timestamp フィールドがありますが、SDKが自動生成するため指定は不要です。

導入できたか確認する ​

  1. 商品ページを開き、画面下部にRAKUFUNの購入パネルが表示されることを確認します
  2. パネルの購入ボタンをクリックし、新しいタブでRAKUFUNの商品ページが開き、設定した商品情報が表示されることを確認します

日本国内のIPアドレスでは、初期設定でパネルは表示されません。日本国内でテストする場合は、手順2のコードの前に rakufun.enableDebug(); を一時的に追加すると、パネルが表示され、画面右上にDEBUG表示が出ます。テスト後は必ずこの行を削除してください。

それでもパネルが表示されない場合は、デフォルトモード - よくある質問をご覧ください。

次のステップ ​

ここまでで導入したのは、デフォルトモード(画面下部パネル)です。必要に応じて、以下をご覧ください。

  • 表示方法を変えたい場合:価格の下に購入ボタンを置きたい、バナーを表示したい、独自にデザインしたボタンを使いたいといった場合は、UIモードをご覧ください。4つの導入方法の比較と選び方を説明しています
  • 先にユーザーの購入の流れを確認したい場合:サンプルに、実際にクリックして試せるデモがあります
  • メソッドやフィールドの詳細を知りたい場合:APIリファレンスをご覧ください

ご不明な点がございましたら、service@rakufun.com までお問い合わせください。

MITライセンスに基づいて公開