CollectionSortOrder に 「MOST_RELEVANT(関連度順)」が追加
原題: Added MOST_RELEVANT value for `CollectionSortOrder`
- Admin API
- GraphQL
- Collections
- CollectionSortOrder
- 並び順
- Merchandising
- 2026-07
- 新機能
図解 : CollectionSortOrder に MOST_RELEVANT(関連度順)が追加 Admin GraphQL API / 2026-07 CollectionSortOrder に 「 MOST_RELEVANT (関連度順)」が追加 コレクション内の商品並び順を指定する GraphQL Admin API の列挙型に、新しい値が 1 つ増えた。API バージョン 2026-07 以上で利用できる。 このページの構成 そもそも何が変わったのか(30秒で理解) CollectionSortOrder とは / 位置づけ図解 並び順の選択肢の中での MOST_RELEVANT 利用条件(API バージョン) 使い方イメージ(GraphQL) 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わったのか GraphQL Admin API の CollectionSortOrder (コレクション内の商品の並び順を表す列挙型)に、 MOST_RELEVANT(関連度順) という値が 1 つ追加された。 対象は API バージョン 2026-07 以上 。記事本文で述べられているのはこの 1 点のみ。 これまで コレクションの並び順は、ベストセラー順・価格順・名前順・手動などの値から選んでいた(関連度順という選択肢は無し)。 これから(2026-07+) sortOrder: MOST_RELEVANT を指定できるようになり、API から「関連度順」を設定値として扱えるようになった。 これは 新しい列挙値の追加 であり、既存の並び順の挙動を変えるものではない。並び順の各オプションの詳細は Shopify ヘルプセンター(記事末尾の source 参照)に案内されている。 2 CollectionSortOrder とは / 位置づけ図解 コレクション(商品の集まり)には「中の商品をどう並べるか」を表す sortOrder フィールドがあり、その型が CollectionSortOrder という列挙型。今回はその選べる値に MOST_RELEVANT が加わった、という位置関係。 図中の MOST_RELEVANT 以外の値は一般的な並び順オプションの例示。 「関連度(relevance)」を何のシグナルでどう算出するかは、本記事には記載なし 。詳細はヘルプセンターを参照のこと。 3 並び順の選択肢の中での MOST_RELEVANT 並び順の値 意味(一般的な並び順) 今回の記事での扱い BEST_SELLING 売れ筋順 既存 PRICE_ASC / DESC 価格の昇順 / 降順 既存 ALPHA_ASC / DESC 名前の A→Z / Z→A 既存 CREATED / DESC 作成日(古い / 新しい)順 既存 MANUAL 手動で並べた順 既存 MOST_RELEVANT 関連度順 ★ 新規追加(2026-07+) ※ 上表のうち新規追加として本記事が明言しているのは MOST_RELEVANT のみ。他の値は文脈理解のための代表例。 4 利用条件 API バージョン 2026-07 以上 それより古いバージョンでは MOST_RELEVANT は利用不可。クエリ/ミューテーションのエンドポイントのバージョンを 2026-07 以上に上げる必要がある。 対象は Admin GraphQL API 記事のタグは「Admin GraphQL API」「2026-07」。Storefront API など他 API での扱いは本記事には 記載なし 。 対応プラン・地域・課金条件などの制約は本記事には 記載なし 。導入前に実際の管理画面 / API でバージョンを切り替えて挙動を確認すること。 5 使い方イメージ(GraphQL) コレクションの sortOrder を MOST_RELEVANT に設定するイメージ。実際のフィールド構成・必須項目は API バージョン 2026-07 のドキュメントで確認すること。 # API version 2026-07 以上のエンドポイントに対して mutation UpdateCollectionSort { collectionUpdate (input: { id: "gid://shopify/Collection/123456789" , sortOrder: MOST_RELEVANT # ← 今回追加された値 }) { collection { id sortOrder } userErrors { field message } } } 上記は値の指定箇所を示すための概念サンプル。 具体的なミューテーション名・入力スキーマは本記事には記載がない ため、実装時は 2026-07 のリファレンスに従うこと。 6 技術者が押さえるべき5つのポイント 1. バージョン依存 2026-07 未満のエンドポイントでは値が存在しない。クライアント側の API バージョン固定値を見直してから採用する。 2. 後方互換の「追加」 既存の列挙値や挙動は変わらず、選択肢が 1 つ増えただけ。既存実装を壊す変更ではない。 3. 関連度ロジックは非公開(記事内) 「関連度」をどう計算するか(売上・閲覧・在庫など何のシグナルか)は本記事に記載なし。期待挙動はサンドボックスで実測する。 4. MANUAL との性格差 MANUAL (人が並べる)に対し MOST_RELEVANT は自動順序。手動の並びを保ちたいコレクションには適用しない判断が要る。 5. ストアフロント表示への反映は要検証 Admin API の sortOrder 設定が、テーマ / ヘッドレスのフロント表示順にどう反映されるかは本記事に明記なし。 採用前に、対象コレクションを 2026-07 で設定 → 実フロントで並びを確認 するステップを挟むのが安全。 7 業務に活かせる3つのユースケース USE CASE 1 大規模カタログのコレクションを「関連度順」に切替 課題 商品点数が多いコレクションで、手動並べ替えや単純な作成日順だと回遊性が低い。 打ち手 対象コレクションの sortOrder を MOST_RELEVANT に設定し、関連度ベースの並びに寄せる。 効果 上位に出る商品の並びを人手で維持する運用から解放され、関連度順での見せ方を試せる。 技術メモ API バージョン 2026-07 以上が前提。関連度の算出根拠は記載なしのため、切替後に CVR・回遊を実測して採否を判断。 USE CASE 2 多数コレクションの並び順を API で一括統一 課題 コレクションが数百〜数千あり、並び順ポリシーを管理画面から手作業で揃えるのは非現実的。 打ち手 Admin GraphQL(必要に応じ bulk operation)で対象コレクションの sortOrder を一括で MOST_RELEVANT に更新。 効果 並び順ガイドラインを横断的に適用でき、運用工数とブレを削減。 技術メモ 2026-07 でクエリ/ミューテーションのバージョンを固定。手動並びを守るコレクションは除外リストで対象外に。 USE CASE 3 並び順の比較検証(従来順 vs 関連度順) 課題 「どの並び順が一番効くか」を根拠データ無しで決めてしまっている。 打ち手 一部コレクションだけ MOST_RELEVANT に切替え、従来の並び順コレクションと一定期間の指標を比較。 効果 関連度順の効き目を実データで確認でき、全体展開の判断材料・提案資料の根拠になる。 技術メモ 計測は決済前のコレクション回遊・CVR を分析ツールで。季節要因を吸収できる期間を確保。フロント反映の有無は事前検証必須。 8 提案で使える1行サマリ 「コレクションの商品並び順に 『関連度順(MOST_RELEVANT)』が API から指定可能 に。 既存の並び順はそのまま、 選択肢が 1 つ増えただけの後方互換な追加 。 使うには Admin GraphQL API バージョン 2026-07 以上 が必要。」 source : shopify.dev / changelog / added-mostrelevant-value-for-collectionsortorder 公開日 : 2026-04-17 / Admin GraphQL API ・ 2026-07