ボタンモード:指定位置に表示する購入ボタン
商品詳細の下や価格の横など、ページ内の指定した位置に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>1
2
3
4
5
6
7
2
3
4
5
6
7
クラス名は必ず 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>1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
指定できるその他のフィールドは、APIリファレンス - 商品情報フィールドをご覧ください。
ボタンの表示仕様
ボタンのスタイルはSDK側で自動的に管理され、ホバー時のエフェクトやクリック時のフィードバックに対応した、RAKUFUNのブランドイメージに沿ったデザインです。ボタンの文言は英語の「Ship internationally via RAKUFUN」で固定されており、変更はできません。
よくある質問
ボタンが表示されない
以下の順に確認してください。
- 日本国内でテストしていませんか?日本国内のIPアドレスでは初期設定で表示されません。テスト時は
rakufun.enableDebug()で一時的に表示できます。テスト後は削除してください - コンテナのクラス名が
rakufun-sdk-embed-buttonになっているか(入力ミスがないか)確認してください rakufun.setUIMode('button')が呼び出されているか確認してください- ブラウザのコンソールを開き、SDKが正しく読み込まれているか、エラーが出ていないかを確認してください
クリック後、RAKUFUNを開く前に確認ダイアログを表示したい
setUICartHandler を使用します。関数が true を返した場合のみ購入処理を続行し、それ以外はキャンセルされます。
javascript
rakufun.setUICartHandler(async (product) => {
return confirm(`「${product.title}」を購入しますか?`);
});1
2
3
2
3
その他の導入方法
ご不明な点がございましたら、service@rakufun.com までお問い合わせください。