ガイド
eBay商品固有情報(Item Specifics)とは:入力のしかた
商品固有情報は、eBayの検索結果を絞り込んだときに、お客様が商品を見つけられるかどうかを左右します。このガイドでは、4つの区分、製品識別子、文字数制限、カテゴリーの項目(アスペクト)の調べ方、サプライヤーの仕様をきれいな値に変換する方法を解説します。
商品固有情報(Item Specifics)とは、eBayの出品に付く、項目名と値のペアです。たとえば Brand: Nordlicht、Colour: Black、Item Width: 45 cm のようなものです。eBayはこれを、商品について買い手に伝える説明的なキーワードと位置付けており、eBayのAPIではアイテムアスペクトと呼ばれます。
これは単なる飾りではありません。eBayは、絞り込み検索の結果に商品を表示したり、出品内容の充実度を判断したり、商品カタログと照合したりするために、これを利用します。正しく入力するためには、カテゴリーがどの項目を求めているかを知り、そこに入れる正確な値を持っていることが重要で、これは主にデータの作業です。
eBayの商品固有情報とは
eBayのカテゴリーにはそれぞれ独自のアスペクトのセットがあります。ノートパソコンのカテゴリーならプロセッサーや画面サイズ、衣類のカテゴリーならサイズやデパートメント(Department)、ほとんどのカテゴリーではブランドが求められます。各アスペクトにはeBayが決めた名前があり、値はeBayのリストから選ぶか、カテゴリーで許されている場合は自由入力で指定します。
商品固有情報は、タイトルや説明文の中ではなく、それらと並んで存在します。買い手は出品ページの構造化されたブロックでこれを見ることができ、eBayの検索は、左側の列の絞り込み条件(ブランド、サイズ、色、コンディションなど)にこれを使います。説明文にしか書かれていない情報は、これらの絞り込み条件には使われません。
Required、Required Soon、Recommended、Additional
Seller Hubの出品フローでは、eBayはカテゴリーの商品固有情報を4つの区分に分類しています。この区分によって、eBayが現在何を必須としているか、今後何を必須とするか、買い手が何を検索しているかがわかります。
| 区分 | 意味 | 空欄にした場合 |
|---|---|---|
| Required(必須) | 新規または修正する出品では、必ず入力が必要 | 商品を出品または修正できない |
| Required Soon(まもなく必須) | 今後必須になる。出品フローに期日が表示される | まだ強制されないが、表示された日付からRequired扱いになる |
| Recommended(推奨) | 買い手の需要データや人気の検索に基づく | 絞り込み検索にヒットしない可能性がある |
| Additional(追加) | カテゴリーに関する任意の追加情報 | ブロックはされないが、出品情報の詳細が少なくなる |
商品固有情報が検索、絞り込み、買い手に与える影響
絞り込みについて、eBayは明確に述べています。該当する商品固有情報を追加していない場合、その商品は絞り込み検索の結果に表示されません。ブランドやサイズで検索を絞り込んだ買い手には、その項目が空欄の出品は、タイトルがどれほど優れていても表示されません。
商品固有情報は、表示順位にも影響します。eBayのBest Matchの要因には、出品内容の充実度や、買い手の検索語とどれだけ一致しているかが含まれます。eBayのセラー向けガイダンスによると、商品固有情報は、eBay、Google ショッピング、外部の検索結果で見つかる可能性を高めます。出品フローには、各項目が過去30日間に何回検索されたかも表示されるため、どのRecommendedのアスペクトを優先するかを判断する際の参考になります。
買い手にとっては、商品固有情報は、説明文を読む前に比較に必要な疑問に答えてくれるものです。正確な値は「これは合いますか?」というメッセージを減らし、誤った値は返品の原因になります。幅45 cmで絞り込んだ買い手は、45 cmの商品を期待しています。
製品識別子:Brand、MPN、UPC、EAN、ISBN、「Does not apply」
製品識別子は、商品固有情報の中でも特別なグループです。eBayは、製品の製造者が付与する固有のコードであると説明しており、UPC、EAN、ISBNなどのGTINに加え、ブランドと製造者部品番号(MPN)が含まれ、ほとんどのカテゴリーで必須であるとしています。
識別子がeBayのカタログ内の製品と一致すると、eBayは一致候補を提示し、タイトル、写真、その他の詳細を自動入力できます。一致を受け入れるのは、完全に一致する場合だけにしてください。モデル年やパック数が異なれば、別の製品です。Inventory APIでは、1つのGTINが複数のカタログ製品に対応することがあるため、eBayはカタログとの照合にeBay製品ID(ePID)を推奨しています。
- Brand:製品に表示されているブランド名であり、仕入先の会社名ではありません。ブランドのない汎用品については、eBayの開発者向けベストプラクティスのガイダンスが「Unbranded」を提案しています。
- MPN:データシートに記載されている、製造者の部品番号または型番。自社のSKUは決して入力しないでください。カテゴリーでMPNが必須の場合、Inventory APIではブランドも必須となります。
- UPC、EAN、ISBN:その正確なバリエーションに対する製造者のGTIN。使用前にチェックデジットを検証してください。
- 「Does not apply」:骨董品やカスタム品など、識別子が本当に存在しない商品では、eBayで「Does not apply」を選択できます。正確な表記はeBayのマーケットプレイスによって異なります。
eBay商品固有情報の文字数制限
制限はeBayのAPIごとに異なるため、使用している出品ツールがどのAPIを利用しているかを確認してください。以下に示す数値は、各情報源に記載された上限です。一部のアスペクトについては、カテゴリーごとに独自の最大文字数が返されることもあります。
| 項目 | 制限 | 適用範囲 |
|---|---|---|
| 出品タイトル | 80文字 | すべての出品。eBayは80文字をすべて使うことを推奨 |
| サブタイトル | 55文字 | 有料のオプション出品アップグレード |
| 商品固有情報の値 | 65文字(標準) | Trading API。一部のアスペクトはそれ以上を許可し、aspectMaxLengthとして示される |
| アスペクト名/アスペクト値 | 40/50文字 | Inventory API |
| ブランドとMPN | 各65文字 | Inventory APIの製品項目 |
| 複数値アスペクトの値 | 最大30個 | MULTIカーディナリティのアスペクト(Taxonomy API) |
| 在庫アイテムの説明 | 4,000文字 | Inventory APIの製品説明 |
| 写真 | 出品あたり最大24枚 | Inventory API。グループ内のバリエーションごとに最大12枚 |
カテゴリーの必須の商品固有情報を調べる方法
eBayの商品固有情報の一覧は1つにまとまっているわけではありません。アスペクトとその区分は、末端カテゴリーとマーケットプレイスによって異なり、時間とともに変わります。販売するカテゴリーごとに調べてください。
出品数が少ない場合は、Seller Hubで十分です。出品フローでカテゴリーを選ぶと、Required、Required Soon、Recommended、Additionalの各項目が、検索回数やRequired Soonの期日とともに表示されます。既存の出品を一括で修正するには、Active Listings(出品中の商品)ページで、固有情報が不足している出品のExcelファイルをダウンロードして再度アップロードするか、複数の出品を選んで「Add item specifics」を使います。
大規模なカタログや頻繁に変わるカタログでは、同じメタデータを機械可読な形式で返すTaxonomy APIを利用します。
- 商品の末端カテゴリーを特定します。アスペクトは、親カテゴリーではなく末端カテゴリーごとに定義されています。
- 販売するeBayマーケットプレイスのカテゴリーツリーIDを取得します。
- GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id} を呼び出します。両方のパラメータが必須です。
- 何が必須かを判断するには、aspectConstraint.aspectRequired を読み取ります。aspectUsage には頼らないでください。必須のアスペクトでもRECOMMENDEDが返されるためです。
- aspectMode(SELECTION_ONLYの場合は、eBayの値のいずれかを使う必要があります)と itemToAspectCardinality(MULTIでは最大30個の値を指定できます)を確認します。
- Required Soonのアスペクトについては expectedRequiredByDate を保存しておき、期限前に入力できるようにします。
- 多数のカテゴリーを一度に扱う場合は、カテゴリーツリーに対して fetch_item_aspects を呼び出します。すべての末端カテゴリーのアスペクトが返されるので、手元のコピーを定期的に更新してください。
アスペクトのメタデータの読み方
getItemAspectsForCategory が返す各アスペクトには、入力方法を示す制約が付いています。マッピングの誤りの大半は、これらの項目を確認することで防げます。
| 項目 | 値 | 対応方法 |
|---|---|---|
| aspectRequired | true または false | 必須のアスペクトを判断するための信頼できる指標 |
| aspectUsage | RECOMMENDED または OPTIONAL | 推奨アスペクトを優先する。ただし、必須のアスペクトもRECOMMENDEDと表示されることに注意 |
| aspectMode | FREE_TEXT または SELECTION_ONLY | SELECTION_ONLYの場合は、値をeBayの値のいずれかに正規化する |
| itemToAspectCardinality | SINGLE または MULTI | 値は1つ送る。MULTIの場合は最大30個 |
| aspectDataType / aspectFormat | 例:DATE、NUMBER | 日付は YYYY、YYYYMM、または YYYYMMDD。数値は整数または小数 |
| aspectEnabledForVariations | true または false | サイズや色など、バリエーションを定義するためにそのアスペクトを使えるかどうか |
| aspectApplicableTo | PRODUCT または ITEM | PRODUCTアスペクトはカタログ製品を説明し、ITEMアスペクトは個別の商品を説明する |
サプライヤーのデータシートの属性をeBayのアスペクトにマッピングする
他社ブランドの商品を再販している場合、商品固有情報の値の大半は、サプライヤーのデータシートや仕様書にすでに存在しています。ただし、eBayの用語になっていないだけです。マッピングとは、データシートの1行を、アスペクト名とeBayが受け付ける値に変換する作業です。
以下の例は、代表的な変換パターンを示しています。アスペクト名はカテゴリーによって異なるため、マッピングに頼る前に、カテゴリーのメタデータで各項目を確認してください。
| データシートの記載 | 候補となるアスペクト | 入力する値 | 確認事項 |
|---|---|---|---|
| 全幅 45 cm | Item Width | 45 cm | 梱包サイズではなく、製品全体の寸法を使う |
| 製造者:Nordlicht Leuchten GmbH | Brand | Nordlicht | 法人名ではなく、製品に表示されているブランド名 |
| 品番 NL-2210-BK | MPN | NL-2210-BK | 自社のSKUではなく、製造者の番号 |
| EAN 6291041500213 | EAN | 6291041500213 | チェックデジットを検証する。バリエーションごとに1つのGTIN |
| 本体色 RAL 9005 ジェットブラック | Colour | Black | eBayの値を選ぶ。RALコードは説明文に残す |
| 表地:オーガニックコットン100% | Material | Cotton | カテゴリーまたは説明文で許される場合は「オーガニック」であることも記載する |
| 定格電圧 AC 220–240 V | Voltage(カテゴリーに項目がある場合) | 220–240 V | アスペクト名と形式はカテゴリーによって異なる |
カテゴリー別の例:家電、衣類、玩具
以下のアスペクトは、これらのカテゴリーでよく求められるもので、値が通常どこにあるかを示しています。あくまで例示です。実際の名称や区分は、末端カテゴリーとマーケットプレイスによって異なるため、上記の方法で調べてください。
衣類と履物については、eBayのヘルプページに、2026年に標準化されたサイズ値へ移行することが記載されており、サイズが未入力または不明確な出品は非表示になる場合があります。従来のサイズ表記に頼る前に、eBayの最新の「Creating a listing」ヘルプを確認してください。
| カテゴリー | よく見られるアスペクト | データの主な所在 | 注意点 |
|---|---|---|---|
| 家電 | Brand、Model、MPN、Type、Connectivity、Colour | 注文情報と技術データの表 | モデル名と部品番号の違い。地域ごとのプラグや電圧のバリエーション |
| 衣類 | Brand、Department、Size Type、Size、Colour、Style、Material | サイズ表と繊維組成のラベル | バリエーションごとにサイズと色は1つ。サイズ体系を統一する |
| 玩具 | Brand、Type、Age Level、Character or Franchise、Material | 梱包の記載、対象年齢、警告表示 | 年齢の値は製造者が定めた対象年齢と警告表示に一致させる |
商品固有情報でよくある間違い
商品固有情報の問題の大半は、eBayが何を求めているかを確認せずに値をコピーすることから生じます。次のような間違いは、露出の低下や返品の原因になりがちです。
- Requiredのアスペクトだけを入力し、買い手が絞り込みに使うRecommendedのアスペクトを無視する。
- APIを使う際に、何が必須かの判断に aspectRequired ではなく aspectUsage を使う。
- SELECTION_ONLYのアスペクトに自由入力の値を入れる、またはeBayのリストと一致しないブランド表記を使う。
- MPNに自社のSKUを入れる、またはUPCやEANに再販業者が購入したバーコードを入れる。
- 商品に実際に存在する識別子について「Does not apply」を選ぶ。
- 単位が混在している(ある出品では45 cm、別の出品では450 mm)ため、絞り込み条件が同じ値を別のものとして扱ってしまう。
- アスペクトが商品そのものの寸法を求めているのに、梱包の寸法を入力する。
- アスペクトの値に、単純な属性値ではなく宣伝文句を繰り返し入れる。
- 一度値を設定したきり、新たにRequired Soonになったアスペクトがないかカテゴリーを再確認しない。
eBay商品固有情報のチェックリストと、大規模な値の準備
出品をまとめて公開する前に、カテゴリーごとにこのリストを確認してください。時間がかかるのは通常、値の入力そのものではなく、サプライヤー文書から正確な値を集める作業です。
Doc2Shelfは、その最初のステップを支援します。サプライヤーのPDFを読み取り、候補となる属性を抽出して、抽出ごとに信頼度をスコア化し、抽出した各事実について出典ページと短い引用を保持します。そのうえで、eBay向けの文案の下書きと、商品固有情報の候補値をレビュー用に用意します。eBayへの新規接続は近日提供予定です。すでに接続済みのアカウントは、引き続き公開できます。新規のユーザーは、レビュー済みの文案を汎用のCSVまたはJSONとしてエクスポートし、Seller Hubまたは自社の出品ツールに値を入力します。この出力はeBayのインポート形式ではありません。
- 販売するマーケットプレイスの末端カテゴリーを確認した。
- Requiredのアスペクトをすべて入力し、Required Soonのアスペクトも期日前に入力した。
- 検索回数の多いRecommendedのアスペクトを入力した。
- Brand、MPN、GTINを製造者の文書から取得し、確認した。
- 選択式のみの値をeBayの値に正規化した。
- 単位と形式が出品間で統一されている。
- 値が、文書化された文字数制限内に収まっている。
- カタログとの照合は、完全に同一の製品である場合にのみ受け入れた。
よくある質問
- eBayの商品固有情報(Item Specifics)とは何ですか?
- ブランド、サイズ、色、素材など、商品に関する、名前と値の構造化された詳細情報です。eBayは、検索フィルター、Best Match、カタログとの照合にこれを使います。eBayのAPIでは、アイテムアスペクトと呼ばれます。
- 推奨の商品固有情報は必須ですか?
- いいえ。出品がブロックされるのは、Requiredの項目だけです。Recommendedの項目は買い手の需要データや人気の検索に基づくもので、入力した固有情報についてのみ商品が絞り込み結果に表示されるため、入力しておく価値があります。
- 商品固有情報はeBayの検索順位に役立ちますか?
- はい。eBayのBest Matchは出品内容の充実度を考慮し、eBayは、商品固有情報によって、eBay、Google ショッピング、外部の検索エンジンで見つかる可能性が高まるとしています。
- eBayの「Does not apply」とは何を意味しますか?
- その種類の製品識別子が、その商品にはないことをeBayに伝えるものです。たとえば骨董品やオーダーメイドの商品が該当します。実際にそうである場合にのみ使用してください。商品に存在する識別子の入力を省くために使ってはいけません。
- 商品固有情報の値は何文字まで入力できますか?
- Trading APIでの標準の上限は65文字で、アスペクトによってはそれ以上が許されます。Inventory APIでは、アスペクト名は40文字、値は50文字までに制限されています。
- eBayのタイトルは何文字まで入力できますか?
- 80文字です。eBayは、ブランド、モデル、主な属性などの関連情報に80文字をすべて使うことを推奨しています。有料のサブタイトルでは、さらに55文字を追加できます。
- eBayのAPIで、必須のアスペクトがRECOMMENDEDと表示されるのはなぜですか?
- getItemAspectsForCategory では、aspectUsage はRECOMMENDEDまたはOPTIONALのいずれかで、必須のアスペクトもRECOMMENDEDとして返されます。アスペクトが必須かどうかは、aspectConstraint.aspectRequired で確認してください。
- 多数の出品に商品固有情報を一括で追加するにはどうすればよいですか?
- Seller HubのActive Listingsで、Required、Required Soon、またはRecommendedの固有情報が不足している出品のExcelファイルをダウンロードし、入力して再度アップロードします。あるいは、複数の出品を選択して「Add item specifics」を使用します。