デフォルトモード:画面下部の購入パネル
最も簡単な導入方法です。SDKを読み込むと画面下部にRAKUFUNの購入パネルが表示され、あとは表示中の商品の情報をSDKに設定するだけで利用できます。既存のページレイアウトを変更する必要はありません。
適した利用シーン: 最短で導入したい場合や、どのモードを使うかまだ決まっていない場合。ページ内の特定の位置に購入導線を置きたい場合は、ボタンモードまたはバナーモードをご覧ください。
ライブデモ
🎨 默认模式实时演示
查看底部滑动面板的效果
導入手順
手順1:SDKを読み込む
商品ページのHTMLに以下の1行を追加します。通常は </body> の直前に記述します。
html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>ページの読み込みが完了すると、画面下部に購入パネルが自動で表示されます(日本国内のIPアドレスでは初期設定で非表示。下記「よくある質問」を参照)。
手順2:商品情報を設定する
上記の1行の直後で、表示中のページがどの商品かをSDKに設定します。ユーザーがパネルの購入ボタンをクリックすると、新しいタブでRAKUFUNの商品ページが開き、この情報が引き渡されます。
html
<script>
rakufun.setUIProductData({
url: window.location.href, // 商品ページのURL
title: 'iPhone 15 Pro Max', // 商品名
price: '189800', // 商品価格(数字のみ。¥ やカンマは含めない)
images: ['https://example.com/iphone.jpg'], // 商品画像(完全なURLで指定)
description: '最新のフラッグシップモデル(256GB)' // 商品説明(任意)
});
</script>setUIProductData は、必ずSDKを読み込む行より後に記述してください。前に記述すると rakufun is not defined というエラーになります。指定できるその他のフィールドは、APIリファレンス - 商品情報フィールドをご覧ください。
よくある質問
画面下部パネルが表示されない
以下の順に確認してください。
- 日本国内でテストしていませんか?日本国内のIPアドレスでは初期設定で表示されません。テスト時は
rakufun.enableDebug()で一時的に表示できます。テスト後は削除してください - ブラウザのコンソールを開き、SDKが正しく読み込まれているか、エラーが出ていないかを確認してください
- ページ内で
rakufun.disableAutoUI()を呼び出していませんか?呼び出すと、パネルは自動表示されません rakufun.setUIMode('button')またはsetUIMode('banner')を呼び出していませんか?これらのモードに切り替えると、画面下部パネルは表示されなくなります
パネルの購入ボタンをクリックすると「未设置商品数据」と表示される
rakufun.setUIProductData() がまだ呼び出されていません。上記の手順2のとおりに追加してください。
その他の導入方法
ご不明な点がございましたら、service@rakufun.com までお問い合わせください。