Skip to content

バナーモード:指定位置に表示するバナー ​

ページ上部やコンテンツエリアの上など、ページ内の指定した位置にRAKUFUNのバナーを表示します。ユーザーがバナーのどこをクリックしても、新しいタブでRAKUFUNの商品ページが開き、購入手続きを進められます。

適した利用シーン: ボタンよりも目に留まりやすい購入導線を置きたい場合。

バナーの表示内容は固定です。RAKUFUNのアイコン、「RAKUFUN」「日本代购服务」の文言、「立即购买」ボタンが表示されます(文言は現在中国語のみ)。商品画像・商品名・価格は表示されません。

ライブデモ ​

🎨 横幅模式实时演示

查看横向横幅如何渲染到容器中

横幅容器

SDK 会在此容器中渲染横向横幅

導入手順 ​

手順1:バナーを表示したい位置に空の div を追加する ​

html
<body>
    <!-- この位置にバナーが表示されます -->
    <div class="rakufun-sdk-embed-banner"></div>

    <div class="main-content">
        <h1>商品詳細</h1>
        <!-- ページのコンテンツ -->
    </div>
</body>

クラス名は必ず 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>

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

バナーのサイズ ​

バナーの高さは内容によって決まります。PCでは約74pxで、画面幅が768px以下(スマートフォンなど)の場合は縦並びになり約121pxです。設置する際は、この高さ分のスペースを確保してください。

よくある質問 ​

バナーが表示されない ​

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

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

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

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

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

その他の導入方法 ​


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

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