まず、ファイル名の元になっている識別子を選び、次に一致の厳しさを選びます：完全一致、画像名に識別子を含む、識別子に画像名を含むのいずれかです。迷ったらSKUの完全一致でマッチから始めましょう。
かんたん判断ガイド
- ファイル名がSKUやバーコードとまったく同じ？ → SKU / バーコードの完全一致でマッチ。
- ファイル名にSKUと他の文字が含まれる？ → 画像名にSKUを含む場合にマッチ。
- 共通のベースコードを持つ複数のバリエーションで1枚の写真を使う？ → SKUに画像名を含む場合にマッチ。
- SKUもバーコードもファイル名と一致しない？ → 画像コードをメタフィールドに入れてメタフィールドの完全一致でマッチを使うか、AIマッチングを試しましょう。
各識別子の取得元
| 識別子 | Shopifyから取得する値 |
|---|---|
| SKU | バリエーションのSKU |
| バーコード | バリエーションのバーコード（EAN、UPC、GTIN） |
| タイトル | 商品のタイトル（バリエーション名ではありません） |
| メタフィールド | 設定 → メタフィールドでのマッチングで指定した商品またはバリエーションのメタフィールド（namespace.key） |
| バリエーションID | 管理画面のURLにあるバリエーションの数値ID（例：44436602683565） |
値は小文字に変換され、前後の空白が除かれます。値が空のバリエーションはスキップされ、マッチすることはありません。
3つのマッチング形式
| 形式 | マッチする条件 | 例 |
|---|---|---|
| 完全一致 | ファイル名が識別子と同じ | AB1234.jpg → SKU AB1234 |
| 画像名に識別子を含む | 識別子がファイル名の中にある | photo-ab1234-front.jpg → SKU AB1234 |
| 識別子に画像名を含む | ファイル名が識別子の中にある | AB1234.jpg → SKU AB1234-S、AB1234-M、AB1234-L |
- 画像名に識別子を含む：最も長く一致したものが優先されます。 ファイル名に
ab12とab1234の両方が含まれる場合、画像が付くのはab1234のバリエーションだけです。短いSKUに画像を奪われることはありません。 - 識別子に画像名を含む：一致したものすべてが対象です。 1枚の画像が多くのバリエーションに割り当てられることがあります。アップロード前に必ずプレビューで件数を確認してください。
すべてのマッチング方法
| オプション | 使う場面 |
|---|---|
| SKUの完全一致でマッチ | ファイル名がSKUとまったく同じ。初期設定で、最も安全な選択肢です。 |
| 画像名にSKUを含む場合にマッチ | ファイル名に他の文字が含まれる：nikon-d750-AB1234-front.jpg。 |
| SKUに画像名を含む場合にマッチ | ファイル名がベースコードで、SKUがそれを拡張している：AB1234.jpg → すべてのサイズ。 |
| バーコードの完全一致でマッチ | ファイル名がEAN/UPC/GTIN。非常に信頼性が高い方法です。 |
| 画像名にバーコードを含む場合にマッチ | 7891234567890-1200x1200.jpgのようなファイル。 |
| バーコードに画像名を含む場合にマッチ | まれなケース。ファイル名が短縮されたバーコード。 |
| タイトルの完全一致でマッチ | SKUやバーコードがなく、ファイル名が商品タイトルと完全に同じ。 |
| 画像名にタイトルを含む場合にマッチ | ファイル名に商品タイトルと他の文字が含まれる。 |
| タイトルに画像名を含む場合にマッチ | ファイル名がタイトル中の特徴的な単語。プレビューを入念に確認してください。 |
| メタフィールドの完全一致でマッチ | 画像コード（ERPや仕入れ先のコード）をメタフィールドで管理している。 |
| 画像名にメタフィールドを含む場合にマッチ | 同上で、ファイル名に他の文字が含まれる。 |
| メタフィールドに画像名を含む場合にマッチ | メタフィールドにコードを含む複合値が入っている。 |
| バリエーションIDの完全一致でマッチ | ファイル名をShopifyのバリエーションIDに変更した。曖昧さはまったくありません。 |
| 画像名にバリエーションIDを含む場合にマッチ | photo-44436602683565.webpのようなファイル。 |
AIマッチング（ベータ版）
SKU / バーコード / タイトル / メタフィールドをAIでマッチは、各ファイル名を人と同じように読み取ります。区切り文字の違い、余分な単語、色名、画像番号があってもマッチします。整形ルールは適用せず、元の名前のまま比較します。
- 明確な名前はすぐにマッチし、残りは結果ページで進捗表示とともにまとめて判定されます。
- AIによるマッチにはそれぞれ信頼度が表示され、信頼度の低い候補はマッチしないまま残ります。
- 他の方法と同様に、アップロード前にすべてのマッチを確認できます。
- 無料プランのストアはAIで1日1,000枚（月5,000枚）まで判定でき、有料プランには上限がありません。
識別子の重複
2つのバリエーションが同じSKU、バーコード、タイトルを持つ場合、初期設定では最初の1つだけに画像が付きます。一部の商品に画像が付かない最も多い原因がこれです。特に商品タイトルは重複しがちです。カタログで意図的に識別子を共有している場合は、複数のバリエーションや商品へのマッチングの有効化をご依頼ください。
ストア向けにアーカイブ済み商品を除外しない限り、すべての商品ステータス（販売中、下書き、アーカイブ済み）が対象になります。
ストア向けに有効化できるオプション
これらはアプリの設定画面にはありません。お問い合わせいただければ有効化します。
- 選択したフォルダーのサブフォルダーを読み取る。
- 共有された識別子に対する複数のバリエーション・商品へのマッチング。
- 同じ画像を商品の複数のバリエーションに割り当てる。
- 各画像を1回だけマッチさせる。
- 最長一致だけでなく、一致したすべての識別子に割り当てる。
- 商品全体ではなく、マッチしたバリエーションの画像だけを置き換える。
- アーカイブ済み商品を除外、またはコレクションや販売元で絞り込む。
- 識別子の整形ルール：末尾のN文字を削除、ハイフン以降を無視、文字を置換。
- 代替テキストの形式：オプション値のみ、メタフィールド＋タイトル、独自の接尾辞。
- アクセント付きタイトルのUnicode正規化。