クイックスタート
ここでは、最も簡単なデフォルトモード(画面下部に購入パネルを表示)を例に、導入の手順を説明します。通常は数分で導入を完了できます。
手順1:SDKを読み込む
商品ページのHTMLに以下の1行を追加します。通常は </body> の直前に記述します。
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>読み込むと、ページの読み込み完了時に画面下部にRAKUFUNの購入パネルが自動で表示されます。
手順2:商品情報を設定する
上記の1行の直後で、表示中のページがどの商品かをSDKに設定します。ユーザーがパネルの購入ボタンをクリックすると、SDKが新しいタブでRAKUFUNの商品ページを開き、この情報を引き渡します。
<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項目は指定を推奨します。それ以外の項目は、情報がある場合に指定してください。
<!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が自動生成するため指定は不要です。
導入できたか確認する
- 商品ページを開き、画面下部にRAKUFUNの購入パネルが表示されることを確認します
- パネルの購入ボタンをクリックし、新しいタブでRAKUFUNの商品ページが開き、設定した商品情報が表示されることを確認します
日本国内のIPアドレスでは、初期設定でパネルは表示されません。日本国内でテストする場合は、手順2のコードの前に rakufun.enableDebug(); を一時的に追加すると、パネルが表示され、画面右上にDEBUG表示が出ます。テスト後は必ずこの行を削除してください。
それでもパネルが表示されない場合は、デフォルトモード - よくある質問をご覧ください。
次のステップ
ここまでで導入したのは、デフォルトモード(画面下部パネル)です。必要に応じて、以下をご覧ください。
- 表示方法を変えたい場合:価格の下に購入ボタンを置きたい、バナーを表示したい、独自にデザインしたボタンを使いたいといった場合は、UIモードをご覧ください。4つの導入方法の比較と選び方を説明しています
- 先にユーザーの購入の流れを確認したい場合:サンプルに、実際にクリックして試せるデモがあります
- メソッドやフィールドの詳細を知りたい場合:APIリファレンスをご覧ください
ご不明な点がございましたら、service@rakufun.com までお問い合わせください。