Skip to content

ボタンモード:指定位置に表示する購入ボタン ​

商品詳細の下や価格の横など、ページ内の指定した位置にRAKUFUNの購入ボタンを表示します。ユーザーがボタンをクリックすると、新しいタブでRAKUFUNの商品ページが開き、購入手続きを進められます。

適した利用シーン: 購入導線を画面下部ではなく、商品情報の近くに置きたい場合。ボタンのスタイルと文言はSDK側で決まります。独自にデザインしたボタンを使いたい場合は、カスタムモードをご覧ください。

ライブデモ ​

🎨 按钮模式实时演示

查看购买按钮如何渲染到容器中

按钮容器

SDK 会在此容器中渲染购买按钮

導入手順 ​

手順1:ボタンを表示したい位置に空の div を追加する ​

html
<div class="product-info">
  <h1>Sony WH-1000XM5 ワイヤレスヘッドホン</h1>
  <p class="price">¥54,800</p>

  <!-- この位置に購入ボタンが表示されます -->
  <div class="rakufun-sdk-embed-button"></div>
</div>

クラス名は必ず rakufun-sdk-embed-button にしてください。同じページに複数配置することもでき、それぞれの位置にボタンが表示されます。

手順2:SDKを読み込み、ボタンモードに切り替えて、商品情報を設定する ​

以下のコードをページに追加します。通常は </body> の直前に記述します。

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  // ボタンモードに切り替える(この行がない場合は画面下部パネルが表示されます)
  rakufun.setUIMode('button');

  // 表示中の商品の情報を設定する
  rakufun.setUIProductData({
    url: window.location.href,                       // 商品ページのURL
    title: 'Sony WH-1000XM5 ワイヤレスヘッドホン',     // 商品名
    price: '54800',                                  // 商品価格(数字のみ。¥ やカンマは含めない)
    images: ['https://example.com/headphones.jpg'],  // 商品画像(完全なURLで指定)
    description: '業界最高水準のノイズキャンセリング性能'  // 商品説明(任意)
  });
</script>

指定できるその他のフィールドは、APIリファレンス - 商品情報フィールドをご覧ください。

ボタンの表示仕様 ​

ボタンのスタイルはSDK側で自動的に管理され、ホバー時のエフェクトやクリック時のフィードバックに対応した、RAKUFUNのブランドイメージに沿ったデザインです。ボタンの文言は英語の「Ship internationally via RAKUFUN」で固定されており、変更はできません。

よくある質問 ​

ボタンが表示されない ​

以下の順に確認してください。

  1. 日本国内でテストしていませんか?日本国内のIPアドレスでは初期設定で表示されません。テスト時は rakufun.enableDebug() で一時的に表示できます。テスト後は削除してください
  2. コンテナのクラス名が rakufun-sdk-embed-button になっているか(入力ミスがないか)確認してください
  3. rakufun.setUIMode('button') が呼び出されているか確認してください
  4. ブラウザのコンソールを開き、SDKが正しく読み込まれているか、エラーが出ていないかを確認してください

クリック後、RAKUFUNを開く前に確認ダイアログを表示したい ​

setUICartHandler を使用します。関数が true を返した場合のみ購入処理を続行し、それ以外はキャンセルされます。

javascript
rakufun.setUICartHandler(async (product) => {
  return confirm(`「${product.title}」を購入しますか?`);
});

その他の導入方法 ​


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

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