カスタムモード:独自のボタンを使用
SDK標準のパネル・ボタン・バナーを使用せず、サイト上の独自の「購入」ボタンを使用するモードです。ユーザーがボタンをクリックしたときに rakufun.quickBuy() を呼び出して商品情報をSDKに渡すと、SDKが新しいタブでRAKUFUNの商品ページを開き、ユーザーはそこで購入手続きを進めます。
適した利用シーン: 購入ボタンのスタイル・文言・位置を自由に設計したい場合や、独自のモーダルやフォームの中に購入導線を組み込みたい場合。短期間で導入したい場合は、デフォルトモードのほうが簡単です。
導入手順
手順1:SDKを読み込み、標準のパネルを無効にする
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
rakufun.disableAutoUI();
</script>SDKを読み込むと、初期設定では画面下部にSDK標準の購入パネルが表示されます。disableAutoUI() はこのパネルを無効にするメソッドで、SDKを読み込む行の直後に記述します。記述しない場合、独自のボタンとSDKのパネルが両方表示されます。
手順2:独自のボタンを設置する
<button id="my-buy-button">今すぐ購入</button>ボタンのスタイル・文言・位置は自由に決められます。
手順3:ボタンのクリック時に quickBuy を呼び出す
document.getElementById('my-buy-button').addEventListener('click', async () => {
const result = await rakufun.quickBuy({
url: window.location.href, // 商品ページのURL
title: 'Bose QuietComfort ヘッドホン', // 商品名
price: '26800', // 商品価格(数字のみ。¥ やカンマは含めない)
images: ['https://example.com/product.jpg'] // 商品画像(完全なURLで指定)
});
if (!result.success) {
console.error('購入処理に失敗しました:', result.message);
alert('購入処理に失敗しました。もう一度お試しください。');
}
});quickBuy は、必ずユーザーがボタンをクリックした処理の中で呼び出してください。新しいタブを開くため、クリック以外のタイミングで呼び出すとブラウザにブロックされる場合があります。
完全な設定例
3つの手順をまとめた例です。そのままページにコピーして試せます。
<!DOCTYPE html>
<html>
<head>
<title>カスタム購入ボタン</title>
</head>
<body>
<h1>Bose QuietComfort ヘッドホン</h1>
<img src="https://example.com/product.jpg" alt="商品画像">
<p class="price">¥26,800</p>
<!-- 独自のボタン -->
<button id="my-buy-button">🛒 今すぐ購入</button>
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
rakufun.disableAutoUI(); // SDK標準の画面下部パネルを表示しない
document.getElementById('my-buy-button').addEventListener('click', async () => {
const result = await rakufun.quickBuy({
url: window.location.href,
title: 'Bose QuietComfort ヘッドホン',
price: '26800',
images: ['https://example.com/product.jpg'],
description: '高性能ノイズキャンセリングヘッドホン'
});
if (!result.success) {
console.error('購入処理に失敗しました:', result.message);
alert('購入処理に失敗しました。もう一度お試しください。');
}
});
</script>
</body>
</html>quickBuy の戻り値
quickBuy は例外をスローしないため、try/catch は不要です。戻り値の result.success で成否を判定してください。
| 結果 | 戻り値(result) | 説明 |
|---|---|---|
| 成功 | { success: true, url, message, data } | 新しいタブでRAKUFUNの商品ページが開いています。現在のページは遷移しません |
| 失敗 | { success: false, message, error } | message に失敗理由が入ります。原因の調査に利用できます |
指定できる商品情報
上記の例では一部の項目のみを指定しています。商品情報を多く指定するほど、RAKUFUNの商品ページに表示される内容が充実します。すべてのフィールドは以下のとおりです。
await rakufun.quickBuy({
// 指定を推奨するフィールド
url: window.location.href, // 商品ページのURL
title: "Nintendo Switch OLED", // 商品名
price: "37980", // 商品価格(数字のみ)
images: [ // 商品画像の配列(複数指定可)
"https://example.com/switch-1.jpg",
"https://example.com/switch-2.jpg"
],
// 任意フィールド
description: "7インチOLEDディスプレイ、64GBストレージ", // 商品説明(2000文字を超える部分は切り捨て)
brand: "Nintendo", // ブランド名
condition: "新品", // 商品の状態(新品/中古/展示品など)
minQuantity: "1", // 購入可能な最小数量(省略時は1)
maxStock: "100", // 最大在庫数(省略時は99)
shippingInfo: "送料無料", // 送料に関する情報
deliveryTime: "3~5営業日", // お届け目安
precautions: "1年間の保証付き", // 商品に関する注意事項
productParameters: "サイズ:102mm × 242mm × 13.9mm、重量:約320g" // 商品の仕様情報
});各フィールドの詳細は、APIリファレンス - 商品情報フィールドをご覧ください。
React、Vueなどのフレームワークで使う
使い方は同じです。SDKを読み込んだ後に rakufun.disableAutoUI() を1回呼び出し、ボタンのクリック処理の中で window.rakufun.quickBuy() を呼び出します。Reactでの実装例:
function BuyButton({ product }) {
const handleBuy = async () => {
const result = await window.rakufun.quickBuy({
url: window.location.href,
title: product.title,
price: product.price,
images: product.images
});
if (!result.success) {
alert('購入処理に失敗しました。もう一度お試しください。');
}
};
return <button onClick={handleBuy}>今すぐ購入</button>;
}よくある質問
独自のボタンのほかに、SDKの画面下部パネルも表示される
rakufun.disableAutoUI() を呼び出していないか、呼び出すタイミングが遅すぎます。SDKを読み込む行の直後に記述してください。
ボタンをクリックしても新しいページが開かない
- ブラウザのコンソールを開き、「購入処理に失敗しました」と失敗理由が出力されていないか確認してください
- ブラウザのアドレスバーに、ポップアップがブロックされた旨の表示が出ていないか確認してください。quickBuy はユーザーのクリック時に呼び出し、ページの読み込み時やタイマーの中では呼び出さないでください
- コンソールに
rakufun is not definedと表示される場合は、SDKが読み込まれていません。<script>のURLと記述位置を確認してください
quickBuy を呼び出すと、現在のページは遷移しますか?
いいえ。RAKUFUNの商品ページは新しいタブで開き、ユーザーは現在のサイトに留まります。
日本国内からアクセスしたユーザーにも、独自のボタンは表示されますか?
はい、表示されます。ほかの3つのモードで日本国内のIPアドレスに表示されないのは、SDKが自身のUIを非表示にしているためです。カスタムモードのボタンはお客様のサイトのボタンなので、SDKが非表示にすることはありません。海外のユーザーにのみ表示したい場合は、お問い合わせください。
その他の導入方法
ご不明な点がございましたら、service@rakufun.com までお問い合わせください。