商品の詳細 [product_detail] 属性を使用すると、技術仕様または他の追加の詳細情報を提供し、他の属性によって明示されていない商品の特徴を記述できます。この属性は、理解しやすい構造化データを顧客に提供できるうえ、顧客のクエリをもとに個々の商品を表示する能力を向上できます。
この属性を登録すると、Google 検索の AI モードなどの AI 搭載のサーフェスで、商品に関する情報を顧客に見つけてもらいやすくなります。また、従来の検索エクスペリエンスも向上します。
このページの内容
使用場面
各商品で省略可
サブ属性
この属性には次の 3 つのサブ属性があります。
- セクション名
[section_name]（省略可、ただし推奨） - 属性名
[attribute_name]（必須） - 属性値
[attribute_value]（必須）
形式
登録したデータを Google が認識できるようにするため、以下の入力形式に関するガイドラインに沿って設定してください。
詳しくは、商品データを英語で登録するケースとその方法をご覧ください。
| ファイル形式 | 値の例 |
| テキスト |
注: TSV（タブ区切り）テキスト ファイルを推奨します。 ヘッダー: 属性ヘッダーには、登録するサブ属性を含めます。商品の詳細 値: 値は、各サブ属性をヘッダーと同じ順序でコロン（ たとえば、attribute_name と attribute_value を登録するには、次のように記述します。 ヘッダー: 値の例: ヘッダーでサブ属性名を明記する場合は、任意の順序で記述できます。一方、明記しない場合（属性名のみを指定する場合）は、属性値に必須サブ属性が次の順序で含まれているとみなされます。
たとえば、section_name、attribute_name、attribute_value を登録するには、次のように記述します。 ヘッダー: 値の例: 一部の属性値について、省略可能なサブ属性であるセクション名 ヘッダー: 値の例: [product_detail] の形式が無効です」という警告が表示されます。 |
| XML（フィード） | <g:product_detail> |
Merchant API 用にデータをフォーマットするには、Merchant API for Shopping に関するリソースをご覧ください。
重要: これは繰り返しグループ属性であるため、サブ属性の値に特殊文字（コロン、カンマ、引用符、バックスラッシュ）が含まれている場合は、形式の要件に十分注意してください。こちらの記事の最後にある詳細な形式の例を参照してください。
- テキスト フィードの場合は、テキスト フィードでの引用符付きの属性に関する詳細な手順を参照してください。
- カンマ記号の処理が複雑になるため、テキスト ファイルには CSV（カンマ区切り値）ではなく TSV（タブ区切り値）形式の使用をおすすめします。
最小要件
商品を表示するには、次の要件を満たす必要があります。これらの要件を満たしていない場合は商品が不承認となり、お客様の Merchant Center アカウントに通知が表示されます。
テキスト フィードを送信するときは、商品の詳細を正しい形式で記載してください。
商品の詳細 [product_detail] 属性には、3 つのサブ属性を区切る 2 つのコロンをそれぞれに含める必要があります。
- 他の属性やプロモーション テキストに含まれる情報を追加しないでください。価格、セール価格、販売期間、送料、配送日などの時間に関する情報や会社名といった情報を入力しないでください。こうした情報はセール価格
[sale_price]や送料[shipping]などの他の属性を使って指定します。 - 属性の名前と値は、値が確認できる場合にのみ指定します。たとえば、食品がベジタリアン向けでないと確認できている場合のみ「
Vegetarian:False」と指定します。ブール値属性のデフォルト値が False であるという理由だけで「False」を指定しないでください。 - キーワードや検索語句は含めないでください。商品の関連する詳細と仕様のみを記載してください。
おすすめの方法
ここでは、商品データの基本的な要件を満たしたうえで、さらに効果を上げるための最適化方法を紹介します。
- この属性は、顧客にとって重要なさまざまな商品固有の情報に使用します。たとえば、パッケージの内容物、接続性、原材料リスト、設置手順、電力要件、機能リストなどです。
- この属性を使用して、次のような商品の重要な情報や特徴を Key-Value ペアとして登録することもできます。
- 形状: 商品の形状を説明します（例: 美術品や家具）
- 場面: その商品が想定されている特別な場面（例: お祝い、休日）
- スポーツ: 商品が対象としている特定のスポーツ
- 仕上げ: 商品の外観や質感を変えるための表面の処理（例: 家具）
- アクティビティ: 商品が対象とするアクティビティ（例: ガーデニング）
- 形式: 商品の形式（例: 書籍、音楽などのメディア）
- テーマ: 商品に関連付けられたテーマ
- 香り: 商品の香り
- フレーバー: 商品のフレーバーまたは味
- 属性の値を登録する際は、最初の語の先頭を大文字にします。たとえば、「focal length」や「Focal Length」ではなく「Focal length」とします。
- 検索エンジン最適化（SEO）キーワードを使用しないでください。
- 文法、スペル、大文字表記の誤りを確認してください。
- この属性内のデータ、またはタイトル
[title]、商品説明[description]、質問と回答[question_and_answer]、商品に関する情報[product_highlight]など、他の属性ですでに登録しているデータを重複して登録しないでください。 - ドキュメント リンク
[document_link]属性も登録していて、これらのドキュメントに同じ情報が記載されている場合は、その情報を登録しないでください。代わりに、これらのドキュメントから FAQ 情報が抽出されます。 - フィードを複数の言語で提供する場合は、この属性を各言語のフィードに含め、セクション名、属性名、属性値を対応するフィードの言語にローカライズします。詳しくは、サポート対象の言語と通貨をご覧ください。
例
商品に含められるセクション名と属性名の組み合わせの例としては、次のようなものが挙げられます。これは包括的または網羅的な一覧ではありません。商品に適用可能な場合、一覧にはないプロパティも自由に追加できます。
アパレル
| リサイクル素材で作られたランニング シューズの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
サステナビリティ:素材:リサイクル |
| オーガニック素材で作られたジャケットの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
サステナビリティ:素材:オーガニック |
電化製品、家電
| Energy Star 認証を受けた衣類乾燥機の商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
サステナビリティ:認証:Energy Star |
携帯電話
| 64 GB のフラッシュ メモリ搭載、バッテリー容量 12.5 時間のスマートフォンの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
全般:寸法:20x5 cm。 |
商品の詳細 [product_detail] |
全般:統合コンポーネント:"カメラ,マイク" |
商品の詳細 [product_detail] |
全般:保護:傷に強いディスプレイ |
商品の詳細 [product_detail] |
モバイル:テクノロジー:"GSM,CDMA" |
商品の詳細 [product_detail] |
モバイル:帯域:"4G:1900、1700/2100、850、700、2300" |
商品の詳細 [product_detail] |
メモリ:64 GB フラッシュ |
商品の詳細 [product_detail] |
バッテリー:容量:12.5 時間 |
商品の詳細 [product_detail] |
バッテリー:充電:"1,440 mAh" |
デジタルカメラ
| 本体と 24-105 mm - F/4.0 レンズのカメラ一括販売の商品データ | |
| 属性 | 値 |
ID [id] |
camera1-bundle-A |
商品グループ ID [item_group_id] |
camera1 |
商品の詳細 [product_detail] |
本体の機能:センサー:CMOS |
商品の詳細 [product_detail] |
本体の機能:プロセッサ:ABCD 画像処理プロセッサ |
商品の詳細 [product_detail] |
レンズシステム:レンズ焦点距離:24-105 mm |
商品の詳細 [product_detail] |
本体の機能:ビデオ:1080p フル HD 60 FPS |
商品の詳細 [product_detail] |
レンズシステム:絞り値範囲:F/4.0 |
| 本体は同一だがレンズが異なる（50 mm - F/1.8 固定）カメラ一括販売の商品データ | |
| 属性 | 値 |
ID [id] |
camera1-bundle-B |
商品グループ ID [item_group_id] |
camera1 |
商品の詳細 [product_detail] |
本体の機能:センサー:CMOS |
商品の詳細 [product_detail] |
本体の機能:プロセッサ:ABCD 画像処理プロセッサ |
商品の詳細 [product_detail] |
本体の機能:ビデオ:1080p フル HD 60 FPS |
商品の詳細 [product_detail] |
レンズシステム:レンズ焦点距離:50 mm |
商品の詳細 [product_detail] |
レンズシステム:絞り値範囲:F/1.8 |
ノートパソコン
| 2 GB RAM とリチウムイオン バッテリーを備えた 13 インチ ノートパソコンの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
ディスプレイ:サイズ:13 インチ |
商品の詳細 [product_detail] |
プロセッサ:CPU:Nvidia Tegra K1（armV7） |
商品の詳細 [product_detail] |
メモリ:フラッシュ:16 GB SSD |
商品の詳細 [product_detail] |
バッテリー:容量:オンライン ストリーミング動画テストで 7 時間稼働 |
商品の詳細 [product_detail] |
バッテリー:テクノロジー:リチウムイオン |
商品の詳細 [product_detail] |
メモリ:RAM:2 GB |
ビタミン
| マルチビタミン 60 カプセルの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
全般: 錠剤: 0 |
商品の詳細 [product_detail] |
全般:用法:朝食とともに摂取 |
商品の詳細 [product_detail] |
全般:成分:"ビタミン C、ビタミン D、鉄、ナイアシン、クエン酸、ナチュラル フルーツ エキス" |
商品の詳細 [product_detail] |
栄養成分:カロリー:0 |
商品の詳細 [product_detail] |
栄養成分:摂取サイズ:2 錠 |
化粧品
| 顔用保湿剤の商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
使用方法:朝と夜に清潔な肌に塗布 |
商品の詳細 [product_detail] |
原料:"オーガニック ローズ エッセンシャル オイル、ミネラル ウォーター" |
商品の詳細 [product_detail] |
保存可能期間:1 年 |
家具
| ソファの商品データ | |
| 属性 | 値 |
商品の詳細 [product_detail] |
全般:商品の重量: 約 47.6 kg |
商品の詳細 [product_detail] |
追加詳細:着座人数:1 人 |
商品の詳細 [product_detail] |
追加詳細:組み立て情報: "組み立てが必要、必要な工具と手順を同梱。オプション: 専門家による組み立ては 3,500 円の追加料金で提供。" |
形式の詳細な例
販売するカメラの商品の詳細 [product_detail] グループ属性を登録するとします。その場合、コンテンツは次のように 4 つのセクションで構成し（うち 1 つは特定のセクション名なし）、合計 14 個の値（行）を含めます。
|
section_name |
attribute_name |
attribute_value |
|
接続 |
接続技術 |
HDMI, NFC, USB |
|
接続 |
ワイヤレス技術 |
802.11b/g/n 内蔵（NFC 対応） |
|
接続 |
動画出力 |
タイプ C Mini HDMI |
|
接続 |
動画出力ポートの合計数 |
2 |
|
メモリ |
フラッシュ メモリのタイプ: |
シングル スロット: SD/SDHC/SDXC（UHS-I） |
|
メモリ |
録画容量 |
30 分 |
|
メモリ |
書き込み速度 |
数 MB/秒～100 MB/秒以上 |
|
メモリ |
Windows ディレクトリ |
C:\\camera\defaults |
|
カメラの設定 |
測光方式 |
平均,マルチゾーン,部分,スポット |
|
カメラの設定 |
露出制御 |
自動, 手動, プログラム, シャッター優先 |
|
カメラの設定 |
クロップモード |
APS-C, 最大 12 インチ |
|
付属品 |
カメラ本体,レンズ,バッテリー パック,マニュアル |
|
|
保証 |
1 年間のメーカー保証 |
|
|
ベストセラー ランキング |
電化製品 1,065 位,デジタル一眼レフカメラ 1 位 |
タブ区切りテキスト ファイルを使用した形式
この場合は、次のように 1 つのセルに登録します（カンマやコロンを含む値は引用符で囲み、引用符は二重にします）。タブ文字は <tab> 記号で表しています。
|
ヘッダー: …<tab>product_detai<tab>… 商品行: …<tab>接続:接続技術:"HDMI, NFC, USB",接続:ワイヤレス技術:802.11b/g/n 内蔵（NFC 対応）,接続:動画出力:タイプ C Mini HDMI,接続:動画出力ポートの合計数:2,メモリ:フラッシュ メモリのタイプ:"シングル スロット: SD/SDHC/SDXC（UHS-I）",メモリ:録画容量:30 分,メモリ:書き込み速度:数 MB/秒～100 MB/秒以上,メモリ:Windows ディレクトリ:"C:\\camera\defaults",カメラの設定:測光方式:"平均,マルチゾーン,部分,スポット",カメラの設定:露出制御:"自動, 手動, プログラム, シャッター優先",カメラの設定:クロップモード:"APS-C 最大 12 インチ",:付属品:"カメラ本体,レンズ,バッテリー パック,マニュアル",:保証:1 年間のメーカー保証,:ベストセラー ランキング:"電化製品 1,065 位,デジタル一眼レフカメラ 1 位"<tab>… |
また、個別の列を複数作成して、それぞれに 1 つ以上の値を含めることもできます。たとえば、各セクションに 1 つの列を設定するには、次のように 4 つのタブ区切り列で登録します。
|
ヘッダー: …<tab>product_detail <tab>product_detail<tab>product_detail<tab>product_detail<tab>… 商品行: …<tab>接続:接続技術:"HDMI, NFC, USB",接続:ワイヤレス技術:802.11b/g/n 内蔵（NFC 対応）,接続:動画出力:タイプ C Mini HDMI,接続:動画出力ポートの合計数:2<tab>メモリ:フラッシュ メモリのタイプ:"シングル スロット: SD/SDHC/SDXC（UHS-I）",メモリ:録画容量:30 分,メモリ:書き込み速度:数 MB/秒～100 MB/秒以上,メモリ:Windows ディレクトリ:"C:\\camera\defaults"<tab>カメラの設定:測光方式:"平均,マルチゾーン,部分,スポット",カメラの設定:露出制御:"自動, 手動, プログラム, シャッター優先",カメラの設定:クロップモード:"APS-C 最大 12 インチ"<tab>:付属品:"カメラ本体,レンズ,バッテリー パック,マニュアル",:保証:1 年間のメーカー保証,:ベストセラー ランキング:"電化製品 1,065 位,デジタル一眼レフカメラ 1 位"<tab>… |
各値を個別の列で登録することもできます。この場合は、次のように 14 列が必要で（3 列のみ表示）、各列はタブで区切ります。
|
ヘッダー: …<tab>product_detail <tab>product_detail<tab>product_detail<tab>… 商品行: …<tab>接続:接続技術:"HDMI, NFC, USB"<tab>接続:ワイヤレス技術:802.11b/g/n 内蔵（NFC 対応）<tab>接続:動画出力:タイプ C Mini HDMI <tab>… |
Google スプレッドシートを使用した形式
この場合は、次のように 1 つのセルに登録します（上記の表で赤字で示されているように、属性値の一部であるカンマ、コロン、バックスラッシュは、バックスラッシュ（\）を使用してエスケープします）。
|
N |
O |
P |
|
|
1 |
… |
|
… |
|
2 |
… |
|
… |
|
3 |
… |
… |
… |
また、個別の列を複数作成して、それぞれに 1 つ以上の値を含めることもできます。たとえば、セクションごとに 1 つの列を使用するには、次のように 4 つのセルで登録します。
|
N |
O |
P |
Q |
|
|
1 |
|
|
|
|
|
2 |
|
|
|
|
|
3 |
… |
… |
… |
… |
また、各値を個別のセルで登録できます。その場合、次のように 14 列が必要になります（3 列のみ表示）。
|
N |
O |
P |
Q |
|
|
1 |
|
|
|
… |
|
2 |
|
|
|
… |
|
3 |
… |
… |
… |
… |