2026-04 Storefront 関連商品と購入共起レコメンドの名称方針

• 作成日: 2026-04-13
• 更新日: 2026-06-04
• 目的: Storefront の商品詳細における 手動関連商品 と 購入共起レコメンド の名称・役割・非表示方針を明確化する。

要件

• 商品詳細ページの 「関連商品」 は、Vendure 商品ページで編集者が明示指定する手動キュレーション商品だけを対象とすること。
• 商品詳細ページの 「この商品を買った人はこちらの商品も購入しています」 は、購入履歴から集計した購入共起レコメンドだけを対象とすること。
• 上記 2 セクションをドキュメント・コード・テスト名で混同しないこと。購入共起レコメンドを「関連商品」と呼ばないこと。
• ホームの固定掲載枠 「おすすめ商品」 とは、名称・役割の両方で区別すること。
• 商品詳細の手動関連商品表示件数は 最大 8 件 とすること。
• 商品詳細の購入共起レコメンド表示件数は 最大 6 件 とすること。
• 手動関連商品が存在しない場合、商品詳細ページでは 「関連商品」 セクションを表示しないこと。
• 購入共起レコメンドが存在しない場合、商品詳細ページでは 「この商品を買った人はこちらの商品も購入しています」 セクションを表示しないこと。

境界

• 本要件は 商品詳細ページの手動関連商品と購入共起レコメンド を対象とする。
• コレクション一致、facet 一致、ブランド一致などを使った類似商品フォールバックは、本要件に含めない。
• ホームや記事本文で使う Vendure 管理の固定商品リストには影響しない。

受け入れ観点

• 商品詳細ページで手動関連商品がある場合、見出しが 「関連商品」 で表示されること。
• 商品詳細ページで購入共起レコメンドがある場合、見出しが 「この商品を買った人はこちらの商品も購入しています」 で表示されること。
• 商品詳細ページでは手動関連商品が最大 8 件、購入共起レコメンドが最大 6 件まで表示されること。
• 手動関連商品がない場合、商品詳細ページで 「関連商品」 セクションが表示されないこと。
• 購入共起レコメンドがない場合、商品詳細ページで 「この商品を買った人はこちらの商品も購入しています」 セクションが表示されないこと。
• ホームでは固定掲載枠として 「おすすめ商品」 が維持され、商品詳細の各セクションと混同されないこと。

補足

• 旧ドキュメントでは購入履歴にもとづく候補を「関連商品」と呼んでいたが、現在は 購入共起レコメンド として扱う。
• 関連商品 は手動キュレーション、購入共起レコメンド は購入履歴集計、おすすめ商品 は固定掲載枠として区別する。
• 将来的に別種の類似商品導線を導入する場合は、本要件とは別の追加要件として扱う。