產品說明頁面的詳盡產品資料

產品說明頁面 (PDP) 介紹產品功能與優點，方便購物者透過 Buy on Google 完成交易。您可以透過 Content API for Shopping 上傳豐富的產品資料，藉此建立豐富的 PDP。豐富的產品資料包括產品的功能和優點、產品子類，以及產品圖片等資訊。

多媒體產品資料的其他優點包括：

  • 提供更詳盡的產品說明，協助顧客找到符合需求的產品，藉此提升產品曝光率
  • 提供準確的產品資訊，讓購物者更有信心地做出購物決定，藉此提高消費者的信任感
  • 向消費者清楚傳達產品價值，進而提高轉換

本指南說明如何在使用 products.insert 方法建立產品時，透過 Content API 上傳豐富的產品資料。以下各節提供部分要求主體，內含構成豐富產品資料的 products 資源屬性。如需完整的 JSON 要求，請參閱範例：使用 product.insert 上傳豐富的產品資料。

產品 ID 屬性

產品的 id 屬性 (又稱為 REST ID) 是專屬 ID，衍生自您為 channel、contentLanauge、feedLabel 和 offerId 屬性提供的值。例如：online:en:US:1111111111。如果是豐富的產品資料，請為所有產品 ID 屬性加入值：

  • channel：「online」或「local」
  • contentLanguage：兩個字母的語言代碼，例如「en」或「fr」
  • feedLabel：由兩個字母組成的語言代碼，例如「US」或「FR」
  • offerId：商家提供的不重複 ID 字串

要求範例

"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"

產品名稱

在 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 屬性為產品亮點部分提供商品清單。建議您至少提供五項產品亮點。如要進一步瞭解產品亮點的其他規範和規定，請參閱 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 屬性。建議您至少提供六個產品詳細資料。如要進一步瞭解產品詳細資料的其他指南和規定，請參閱 product_detail：定義。

要求範例

  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ]

專屬產品 ID (全球交易品項識別碼、品牌、製造商零件編號)

Google 會使用專屬產品 ID 識別產品。強烈建議您為每項產品提供全球交易品項識別碼值。如未提供全球交易品項識別碼，則須同時提供 brand [品牌] 和 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"
}