BLOG / productgroup-variant-sku-gtin.mdx
ProductGroup、Variant、SKU、GTIN:曖昧なら止める識別ガイド
商品群、選択肢の組み合わせ、市場・言語別文書、安定URL、SKU、GTINを、欠落識別子を推測せずモデル化します。
識別は商品候補を絞るためのもので、確実性を捏造するためのものではありません。v0.10では、すべてのVariantに空でない販売者のskuが必須です。販売者SKUがない実在商品では、現時点で適合するProduct Documentを作成できません。安定したソースIDは有用ですが、skuの代替にはなりません。GTINとMPNは省略できます。
SKU.md は、販売者が自らホストする商品発見と安定した商品知識のレイヤーです。Agent が商品を見つけ、出典のある事実を理解し、リアルタイムの商取引情報をどこで再確認すべきか把握できるようにします。新しい Checkout プロトコルではありません。
4つの識別概念は別の問いに答える
| 概念 | 答える問い | 省略可能か |
|---|---|---|
| ProductGroup | 関連する商品ファミリーはどれか | 商品群をモデル化しないなら可 |
| Variant | 購入可能な正確な選択肢組合せはどれか | 選択可能とする商品では不可 |
| SKU | 販売者が割り当てた在庫参照は何か | 不可。v0.10は全Variantで必須 |
| GTIN | 登録済み国際取引商品は何か | 可 |
Schema.org Productにはsku、gtin、isVariantOfなどの属性がありますが、語彙があるだけでは販売者による入力・管理は保証されません。SKU.mdは既知の識別子を保持し、名称やURL断片から推測しません。省略可能なGTIN・MPNと異なり、販売者skuはv0.10の適合要件です。
選択肢の組合せがVariantを定義する
販売者がS、M、Lを扱うなら「青いジャケット」だけでは曖昧です。Variantには、元システムで商品を区別するために必要な選択肢選択をすべて含めます。名称が同じでも裁断、市場、梱包サイズ、素材が違えば、類似度で選んではいけません。
- 安定した情報源から商品群を解決します。
- 必須選択肢の名称と値をすべて照合します。
- 安定したVariant IDと必須の販売者SKUを比較し、GTINがあれば照合します。
- 識別子が衝突するか候補が複数残れば停止します。
市場、言語、URLは次元であり識別の近道ではない
同じVariantの現地言語ページ、市場固有Variant、似た説明の別商品が存在します。content_languageは文書言語を、marketはコマース文脈を示します。どちらも2文書が同一Variantだと単独で証明しません。
正規URLと親文書URLは改訂をまたいで安定させます。廃番商品からカテゴリーページへのリダイレクトは人には便利でも、旧文書の事実を新商品へ黙って結び付けてはいけません。対応する場合は代替商品または廃番情報を明示します。
欠落・衝突時は安全側に停止する
| 状況 | 安全な結果 |
|---|---|
| GTINがない | 他の識別が正確ならGTINなしで続行 |
| 販売者SKUがない | 作らない。販売者が割当て・管理するまで適合v0.10 Product Documentを作れない |
| SKU一致、Variant ID衝突 | 停止して不一致を報告 |
| 部分選択肢に2 Variantが一致 | 欠けた選択肢を質問 |
| 市場別ページで購入商品が変わる | 別の対応付け判断として扱う |
安定したソースIDは修復や照合に役立ってもskuを代替しません。曖昧なら停止することで、よく書かれたFact、Claim、Disclosureが別商品へ適用されるのを防ぎます。
関連資料
正確な照合の実行手順はAIコマースの権限引き継ぎで、知識管理は商品知識の事実・主張・開示・制約で確認できます。