商品説明ページの詳しい商品データ

商品説明ページ(PDP)では、ユーザーが Google で購入する前に商品の機能や特長について確認できます。Content API for Shopping を使用してリッチな商品データをアップロードすることで、リッチな商品詳細ページを作成できます。リッチ商品データには、商品の特徴やメリット、商品のバリエーション、商品の画像に関する情報が含まれます。

リッチな商品データには、次のようなメリットもあります。

  • より詳細な商品説明を提供することで、ユーザーがニーズに合った商品を見つけやすくなり、商品検索が改善されます。
  • 正確な商品情報を提供することで、お客様が自信を持って購入を決定できるようにし、信頼を高める
  • 商品の価値を顧客に明確に伝えることで、コンバージョンを改善する

このガイドでは、products.insert メソッドを使用して商品を作成する際に、Content API を使用してリッチな商品データをアップロードする方法について説明します。次のセクションでは、リッチな商品データを構成する products リソースの属性を含むリクエスト本文の一部を示します。完全な JSON リクエストについては、例: products.insert を使用してリッチな商品データをアップロードするをご覧ください。

商品 ID 属性

商品の id 属性(REST ID とも呼ばれます)は、channelcontentLanaugefeedLabelofferId 属性に指定した値から導き出される固有の ID です。例: online:en:US:1111111111。リッチな商品データの場合は、次の商品 ID 属性の値をすべて含めます。

  • channel: 「online」または「local」
  • contentLanguage: 「en」や「fr」などの 2 文字の言語コード
  • 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 属性を使用して、商品詳細オブジェクトのリストを指定します。各オブジェクトには、sectionNameattributeNameattributeValue 属性が含まれます。少なくとも 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 を指定しない場合は、商品を特定できるように、ブランド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"
}