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

產品說明頁面 (PDP) 介紹產品功能與優點，方便購物者決定是否透過「透過 Google 購買」完成交易。你可以透過 Content API for Shopping 上傳豐富的產品資料，建立豐富的 PDP。豐富產品資料包括產品功能和優點、產品子類和產品圖片等資訊。

詳盡的產品資料還有以下好處：

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

本指南說明如何使用 Content API，在透過 products.insert 方法建立產品時上傳豐富的產品資料。以下各節提供部分要求主體，其中包含構成豐富產品資料的products資源屬性。如需完整的 JSON 要求，請參閱範例：使用 products.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 屬性提供產品圖片，提升產品說明頁面品質。建議提供多張高畫質圖片，從不同角度和情境展示產品。如需產品圖片的額外規定和要求，請參閱圖片連結：定義。

要求範例

"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 屬性提供產品亮點部分的項目清單。建議至少提供五個產品亮點。如要瞭解產品亮點的額外規範和規定，請參閱產品亮點：定義。

要求範例

"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 屬性。建議至少提供六項產品詳細資料。如需產品詳細資料的其他規範和規定，請參閱產品詳細資料：定義。

要求範例

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

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

Google 會使用專屬產品 ID 來識別產品。強烈建議為每項產品提供全球交易品項識別碼值。如未提供全球交易品項識別碼，請務必提供品牌和製造商零件編號的值，以便我們識別產品。如要進一步瞭解 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"
}