商品説明ページ（PDP）では、「Google で購入」での購入が完了する前に、商品の機能や特長について買い物客に説明できます。充実した PDP を作成するには、Content API for Shopping を通じて豊富な商品データをアップロードします。詳細な商品データには、商品の機能やメリット、バリエーション商品、商品画像に関する情報が含まれます。
商品データが豊富であることには、他にも次のようなメリットがあります。
- 詳細な商品説明を提供して、顧客がニーズに合う商品を見つけやすくすることで、商品の見つけやすさを改善する
- 正確な商品情報を提供して購入の意思決定を後押しすることで、顧客の信頼を高める
- 商品の価値を顧客により明確に伝え、コンバージョン率を改善する
このガイドでは、products.insert メソッドを使用して商品を作成する際に、Content API を使用してリッチ商品データをアップロードする方法について説明します。以下のセクションでは、充実した商品データを構成する products リソースの属性を含む、部分的なリクエスト本文を提供します。完全な JSON リクエストについては、例: products.insert を使用してリッチ商品データをアップロードするをご覧ください。
商品 ID 属性
商品の id 属性（REST ID とも呼ばれます）は、channel、contentLanauge、feedLabel、offerId の各属性に指定した値から生成される一意の識別子です。例: online:en:US:1111111111詳細な商品データの場合は、すべての商品 ID 属性の値を含めます。
channel: 「オンライン」または「ローカル」contentLanguage: 2 文字の言語コード（「en」、「fr」など）feedLabel: 「US」や「FR」などの 2 文字の言語コードofferId: 販売者が提供する一意の識別子の文字列
リクエストの例
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
商品タイトル
ブランド、性別、サイズ、色に関する情報などの主要な商品の詳細を title 属性に含めると、ユーザーは適切な商品を見ているかどうかを簡単に判断できます。商品タイトルの他のガイドラインと要件については、title: 定義をご覧ください。
リクエストの例
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
プロダクトの説明
description 属性で商品説明を充実させることで、仕様や画像では説明できない方法で商品についてユーザーに説明できます。商品説明に関するその他のガイドラインと要件については、商品説明: 定義をご覧ください。
リクエストの例
"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."
商品画像
imageLink 属性と additionalImageLinks 属性を使用して商品画像を指定して、商品説明ページの効果を高めます。さまざまな角度や状況で商品を写した高品質の画像を複数用意することをおすすめします。商品画像のその他のガイドラインと要件については、image_link: 定義をご覧ください。
リクエストの例
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
]
商品バリエーション
itemGroupId 属性を使用して、類似商品のバリエーションの商品グループを定義できます。商品のグループ化の方法とタイミングに関するガイドライン、要件とベスト プラクティスについては、item_group_id: 定義をご覧ください。
リクエストの例
"itemGroupId": "pixels"
プロダクトに関する情報
商品説明ページの商品に関する情報セクションでは、メインの商品画像の横に商品の詳細の短い箇条書きリストが表示されます。productHighlights 属性を使用して、商品に関する情報セクションの商品アイテムのリストを指定します。少なくとも 5 つの商品に関する情報を含めることをおすすめします。商品に関する情報に関する詳細なガイドラインと要件については、product_highlights: 定義をご覧ください。
リクエストの例
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
]
プロダクトの詳細
商品説明ページの商品の詳細セクションでは、商品画像の下に追加の商品情報が表示されます（レイアウトはパソコン用とモバイル用で異なる場合があります）。productDetails 属性を使用して、商品の詳細オブジェクトのリストを指定します。各オブジェクトには sectionName 属性、attributeName 属性、attributeValue 属性が含まれます。少なくとも 6 件の商品の詳細を指定することをおすすめします。商品の詳細に関するガイドラインと要件については、product_detail: 定義をご覧ください。
リクエストの例
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
固有商品 ID（GTIN、ブランド、MPN）
Google では固有商品 ID を使用して商品を識別します。各商品に GTIN 値を指定することを強くおすすめします。GTIN を指定しない場合は、Google が商品を識別できるように、ブランドと MPN の両方の値を指定する必要があります。ID タイプについて詳しくは、固有商品 ID についてをご覧ください。
リクエストの例
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
例: products.insert でリッチ商品データをアップロードする
次の JSON サンプルは、リッチ商品データをアップロードする products.insert 呼び出しのリクエストの例を示しています。
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
{
"channel": "online",
"contentLanguage": "en",
"offerId": "pixel4",
"targetCountry": "US",
"feedLabel": "US",
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
"description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
],
"brand": "Google",
"googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
"gtin": "842776114952",
"mpn": "GA01188-US",
"price": {
"currency": "USD",
"value": "549.99"
},
"salePrice": {
"currency": "USD",
"value": "549.99"
},
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
],
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
],
"availability": "in stock",
"condition": "new",
"includedDestinations": [
"Shopping Actions"
],
"excludedDestinations": [
"Shopping Ads"
],
"sellOnGoogleQuantity": 100,
"shippingLabel": "US_Test"
}