バナーモード:指定位置に表示するバナー
ページ上部やコンテンツエリアの上など、ページ内の指定した位置にRAKUFUNのバナーを表示します。ユーザーがバナーのどこをクリックしても、新しいタブでRAKUFUNの商品ページが開き、購入手続きを進められます。
適した利用シーン: ボタンよりも目に留まりやすい購入導線を置きたい場合。
バナーの表示内容は固定です。RAKUFUNのアイコン、「RAKUFUN」「日本代购服务」の文言、「立即购买」ボタンが表示されます(文言は現在中国語のみ)。商品画像・商品名・価格は表示されません。
ライブデモ
🎨 横幅模式实时演示
查看横向横幅如何渲染到容器中
横幅容器
SDK 会在此容器中渲染横向横幅
導入手順
手順1:バナーを表示したい位置に空の div を追加する
html
<body>
<!-- この位置にバナーが表示されます -->
<div class="rakufun-sdk-embed-banner"></div>
<div class="main-content">
<h1>商品詳細</h1>
<!-- ページのコンテンツ -->
</div>
</body>1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
クラス名は必ず rakufun-sdk-embed-banner にしてください。同じページに複数配置することもでき、それぞれの位置にバナーが表示されます。
手順2:SDKを読み込み、バナーモードに切り替えて、商品情報を設定する
以下のコードをページに追加します。通常は </body> の直前に記述します。
html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
// バナーモードに切り替える(この行がない場合は画面下部パネルが表示されます)
rakufun.setUIMode('banner');
// 表示中の商品の情報を設定する(バナーには表示されませんが、クリック時にRAKUFUNの商品ページへ引き渡されます)
rakufun.setUIProductData({
url: window.location.href, // 商品ページのURL
title: 'PlayStation 5 デジタル・エディション', // 商品名
price: '49980', // 商品価格(数字のみ。¥ やカンマは含めない)
images: ['https://example.com/ps5.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リファレンス - 商品情報フィールドをご覧ください。
バナーのサイズ
バナーの高さは内容によって決まります。PCでは約74pxで、画面幅が768px以下(スマートフォンなど)の場合は縦並びになり約121pxです。設置する際は、この高さ分のスペースを確保してください。
よくある質問
バナーが表示されない
以下の順に確認してください。
- 日本国内でテストしていませんか?日本国内のIPアドレスでは初期設定で表示されません。テスト時は
rakufun.enableDebug()で一時的に表示できます。テスト後は削除してください - コンテナのクラス名が
rakufun-sdk-embed-bannerになっているか(入力ミスがないか)確認してください rakufun.setUIMode('banner')が呼び出されているか確認してください- ブラウザのコンソールを開き、SDKが正しく読み込まれているか、エラーが出ていないかを確認してください
クリック後、RAKUFUNを開く前に確認ダイアログを表示したい
setUICartHandler を使用します。関数が true を返した場合のみ購入処理を続行し、それ以外はキャンセルされます。
javascript
rakufun.setUICartHandler(async (product) => {
return confirm(`「${product.title}」を購入しますか?`);
});1
2
3
2
3
その他の導入方法
ご不明な点がございましたら、service@rakufun.com までお問い合わせください。