商品说明页面 (PDP) 会向买家展示商品的功能与优势,吸引买家通过“在 Google 上购买”完成购买。您可以通过 Content API for Shopping 上传丰富的商品数据,从而创建丰富的 PDP。丰富的商品数据包括商品的功能和优势、商品款式/规格以及商品图片方面的信息。
丰富商品数据的其他优势包括:
- 提供更详细的商品说明,帮助客户找到满足其需求的商品,从而提高商品发现率
- 提供准确的商品信息,让客户放心地做出购买决定,从而提高客户信任度
- 通过更清晰地向客户传达产品价值,帮助提高转化率
本指南介绍了如何在使用 products.insert
方法创建商品时,使用 Content API 上传丰富的商品数据。以下部分提供了部分请求正文,其中包含构成丰富商品数据的 products
资源的属性。如需查看完整的 JSON 请求,请参阅示例:使用 products.insert 上传丰富的商品数据。
商品 ID 属性
商品的 id
属性(也称为 REST ID
)是一种唯一标识符,它派生自您为 channel
、contentLanauge
、feedLabel
和 offerId
属性提供的值。例如,online:en:US:1111111111
。对于丰富的商品数据,请为所有商品 ID 属性添加值:
channel
:“在线”或“本地”contentLanguage
:双字母语言代码,例如“en”或“fr”feedLabel
:双字母语言代码,例如“US”或“FR”offerId
:商家提供的唯一标识符字符串
示例请求
"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
属性可为“商品亮点”部分提供商品列表。我们建议您至少提供 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
属性。我们建议您至少提供六项商品详情。如需了解有关商品详情的其他准则和要求,请参阅 product_detail:定义。
示例请求
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
唯一商品标识码(GTIN、品牌、MPN)
Google 会使用唯一商品标识码来标识商品。我们强烈建议您为每件商品提供 GTIN 值。如果您不提供 GTIN,则必须同时为品牌和 MPN 提供值,以便我们识别您的商品。如需详细了解标识码类型,请参阅唯一商品标识码简介。
示例请求
"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"
}