Table of Contents
3
ショップ設定
#
4
商品管理
#
5
ランキングスナップショット
#
スナップショット内容 #
システムは毎日自動で楽天ランキングページを取得し、スナップショットを生成します：
| フィールド | 説明 |
|---|---|
| ランキング順位 | カテゴリ/タグ内での商品の順位 |
| カテゴリ | ランキングが属する楽天カテゴリ |
| タグ | ランキングが属するタグ |
| 日付 | ランキングデータの取得日 |
| ランキング画像 | HTMLレンダリングで生成されたランキング表示画像 |
画像生成の仕組み #
ランキング画像の生成フロー：
| ステップ | 処理 |
|---|---|
| ステップ1 | ランキングHTMLテンプレートを取得し、現在のランキングタイトルとTOP商品情報を挿入 |
| ステップ2 | wkhtmltoimageでHTMLをPNG画像にレンダリング |
| ステップ3 | ランキング画像を商品背景画像の指定位置に合成 |
| ステップ4 | テンプレート設定のサイズに合わせて最終画像をリサイズ |
6
画像テンプレート
#
テンプレート設定 #
| パラメータ | 説明 | デフォルト値 |
|---|---|---|
| 背景画像 | 商品表示用背景画像、ランキング情報をこの画像に合成 | – |
| 水平位置 (X) | 背景画像上のランキング画像の水平オフセット（ピクセル） | 0 |
| 垂直位置 (Y) | 背景画像上のランキング画像の垂直オフセット（ピクセル） | 0 |
| 画像幅 | 合成後画像の幅（ピクセル） | 1024 |
| 画像高さ | 合成後画像の高さ（ピクセル） | 237 |
テンプレート階層 #
- ショップレベルテンプレート：ショップに設定されたデフォルトテンプレート、ショップ内の全商品に適用
- 商品レベルテンプレート：商品に個別設定されたテンプレート、ショップテンプレートより優先
💡 テンプレート設定ページではリアルタイムプレビュー機能があり、背景画像上のランキング画像の配置を直感的に確認できます。
7
自動化フロー
#
3ステップ自動化 #
システムは毎日自動で以下の3ステップを実行します（デフォルト毎日22:03実行）：
| フェーズ | 処理内容 | 説明 |
|---|---|---|
| フェーズ1 | ランキング取得 | 楽天ランキングページをスクレイピングし、各カテゴリ/タグのスナップショットを記録 |
| フェーズ2 | 画像合成 | ランキングデータを画像化し、商品背景画像に合成 |
| フェーズ3 | アップロード | 楽天APIで画像をアップロードし、商品説明を更新（PC・モバイル両対応） |
💡 3フェーズは順番にチェーン実行されます：フェーズ1完了後に自動でフェーズ2、フェーズ2完了後に自動でフェーズ3が実行されます。
アップロードステータス #
| ステータス | 説明 |
|---|---|
| init | 画像生成済み、アップロード待ち |
| done | 画像の楽天アップロード成功 |
| fail | アップロード失敗、エラー詳細を確認してください |
8
よくある質問
#
Q: 画像が自動生成されない場合は？ #
確認事項：1) 定期タスクが正常に実行されているか；2) 商品が「合成停止」にマークされていないか；3) その商品のカテゴリに最新のランキングデータがあるか。
Q: 楽天へのアップロードが失敗した場合は？ #
ショップのAPIキー（serviceSecretとlicenseKey）が有効か確認してください。楽天Cabinetフォルダが満杯の場合、システムは自動的に新しいフォルダを作成してリトライします。
Q: 商品ごとに異なる背景画像を使うには？ #
商品詳細ページで商品レベルの画像テンプレートを設定してください。商品レベルのテンプレートがショップのデフォルトテンプレートを上書きします。
Q: ランキング画像の位置がずれている場合は？ #
画像テンプレート設定で水平位置(X)と垂直位置(Y)パラメータを調整してください。リアルタイムプレビューで調整結果を確認できます。