商品IDとhandleを混同するとフィード確認で何が困るか

Shopifyで商品を管理していると「商品ID」「handle」「variant ID」「SKU」と、似たような識別子が複数出てきます。Merchant Centerのフィードを確認するとき、どれを使えばいいのか迷った経験はないでしょうか。

実は、IDの種類を取り違えるだけで「フィードに商品が見つからない」「エラーの原因箇所が特定できない」といった無駄な往復が発生します。この記事では、各IDの違いとMerchant Center側での表記形式を整理し、トラブル時にどのIDで照合すればよいかをまとめました。


Shopifyに存在する4つの識別子

まずはShopify内部で使われる主な識別子を押さえておきます。

識別子 形式 何を指すか
商品ID(Product ID) 数値のみ 7429183012995 商品ページ全体(親)
Handle URLスラッグ blue-t-shirt 商品ページのURL末尾
Variant ID 数値のみ 42583019464899 サイズ・カラーなど個別のSKU単位(子)
SKU 自由入力 BTS-BLU-M 店舗側が任意で付与する管理コード

商品IDとVariant IDはどちらも数値ですが、桁数が異なることが多く、用途も違います。商品IDは「この商品ページ」全体を指し、Variant IDは「この商品のこのサイズ・カラー」を指します。


Merchant Centerのitem idはどう見えるか

Google Merchant CenterにShopifyアプリ経由でフィードを送ると、商品IDは次のような形式に変換されます。

shopify_JP_7429183012995_42583019464899

この文字列は3つの部分で構成されています。

  • shopify ― プラットフォーム接頭辞
  • JP ― ストアの販売チャネル地域
  • 7429183012995 ― Shopify商品ID
  • 42583019464899 ― Shopify Variant ID

つまりMerchant Center上の「item id」はVariant ID単位で付与されており、親商品IDだけでは一意に特定できません。ここを押さえておかないと、Shopify管理画面で商品IDだけ検索してもMerchant Center側と一致しないという事態になります。


IDの混同で起きる具体的なトラブル

1. Handleでフィードを検索してしまいヒットしない

Merchant Centerのフィード検索はitem idベースで行われます。blue-t-shirtのようなhandleで検索しても結果はゼロです。「フィードに商品が登録されていない」と早合点してしまう原因のひとつです。

2. 商品IDとVariant IDを逆に伝える

エラー報告をするとき「商品ID 42583019464899が rejects されています」と伝えても、それが実はVariant IDだと相手には伝わりません。Merchant Center側では先頭にshopify_JP_が付くため、数字だけではどの部分のIDか判断がつきません。

3. SKUの不一致で重複登録に見える

SKUは自由入力なので、運用中に変更するとMerchant Center側では別商品として扱われます。ID体系を理解していないと「同じ商品が2つある」という誤解につながります。


ShopifyとMerchant CenterのID対応表

実際に照合するときの対応関係をまとめました。

Shopify側 Merchant Center側 照合に使う場面
商品ID 7429183... shopify_JP_7429183..._* 「どの商品か」を大まかに特定
Variant ID 4258301... shopify_JP_*_4258301... エラーの原因になった特定バリアントを特定
Handle blue-t-shirt (直接は使われない) Shopify管理画面内での移動・確認用
SKU BTS-BLU-M attribute sku として格納 自社内の在庫管理と突き合わせ
商品ステータス(active/draft) destination Shopping の承認状態 公開対象かどうかの確認

エラー報告に使うべきID

Merchant Centerで商品が rejects や警告になった場合、報告に使うべき識別子は次の優先順位です。

  1. Merchant Centerのitem id(shopify_JP_...形式) ― これが最も確実です。Merchant Center画面の「商品」一覧から直接コピーできます。
  2. Variant ID ― item idの末尾部分です。Shopify管理画面のバリアント編集URLから確認できます。
  3. 商品ID ― 大まかな対象商品を伝える目的で補助的に使います。

Handleや商品名だけ伝えても、検索の手間が増えるだけで解決は速くなりません。


自動連携と手動確認の切り分け

自動で処理されること

  • ShopifyアプリからMerchant Centerへのフィード送信
  • 商品ID → item id(shopify_JP_...形式)への自動変換
  • 新規商品公開時の自動反映

これらはアプリとMerchant Centerの連携設定が正しければ、手動操作は不要です。

人が確認・判断すべきこと

  • rejects や警告の内容確認と原因特定
  • Shopify側の商品情報(タイトル、画像、価格)とMerchant Center側の表示との突き合わせ
  • SKU変更や商品削除に伴うフィードの整合性確認
  • フィード仕様の変更ポリシーへの対応判断

自動連携に任せきかりではなく、エラーが出たときにどのIDを手がかりに調査するかを知っておくことが、対応の早さに直結します。


照合の手順まとめ

Merchant Centerで不審なステータスを見つけたときの基本的な確認手順です。

  1. Merchant Centerの「商品」画面で該当商品の item id をコピーする
  2. item idの末尾の数値(Variant ID)を確認する
  3. Shopify管理画面で /admin/products/商品ID/variants/Variant ID のURLにアクセスし、該当バリアントを開く
  4. タイトル・画像・価格・在庫などの情報を比較する
  5. 原因が判明したら、Shopify側の該当項目を修正する

商品IDだけではバリアント単位の特定ができないため、必ずVariant IDまで確認するのがポイントです。


相談時に用意するとよい情報

  • Merchant Centerで表示されているitem id(shopify_JP_...形式)
  • 該当商品のShopify管理画面URL
  • Merchant Centerのエラーメッセージ本文(テキストでOK)
  • エラーが発生し始めたおおよその時期
  • 最近行ったShopify側の変更(SKU変更、価格改定、商品の複製など)

初回相談では機密CSVやスクリーンショットの送付は不要です。上記のテキスト情報が揃っていれば、原因の切り分けを進められます。

参考にした公式情報

この記事の内容で困っている方へ

Merchant Center / 商品フィード まわりの作業整理、小さな自動化、簡易チェックツール化について相談できます。初回相談で機密CSVやスクリーンショットを送る必要はありません。

無料相談する