商品数据规范

本文详细介绍了 Manufacturer Center 所接受的每个属性的相关要求和格式。某些属性是必需的,而另外一些属性是推荐的或可选的。如果没有为必需属性提供值,则会导致该特定商品无法在您的 Feed 上传中得到正确处理。未能提供推荐属性或可选属性会导致系统中的商品数据不完整,但不会导致 Feed 失败。

在本文中,您会看到商品和产品这两个术语。请注意,我们使用商品这个术语来描述一种商品款式。“商品”的概念和产品很接近,只不过我们认为产品可能会有多种变体。这些变体(或“商品款式”)可能是指不同的颜色、尺寸或样式。换句话说,商品是指一种商品款式。商品数据文件中的每个条目都应反映一件商品或产品的一种款式。

请注意,只能在 Feed 中提交英文属性,也就是下面示例中方括号里的内容。您将看到值的描述和/或翻译(仅用于说明)。

请注意,如果您为重复属性提供了很多值(例如功能说明),我们可能只会显示前几个值。

示例如下:

注意:您提供的值可能会对客户显示,因此请提供客户能理解的值。

基本信息

以下属性包含有关商品的基本信息。

要查看属性的完整信息(包括最佳做法),请选择每个属性表格中的链接。

属性 格式 最低要求概览
ID [id]

必须为所有商品提供
特定商品的标识码

示例
A2B4

语法/类型
最多 50 个字符
仅限 ASCII 字符

重复值/字段

文本 (TSV)
Tddy-123-uk

XML (Feed)
<g:id>tddy-123-uk</g:id>

商品提交后,在更新数据时便不得更改其 ID [id],以后也不得将此 ID 用于其他商品。

GTIN [gtin]

必须为所有商品提供
商品的全球贸易项目代码

语法
最多 150 个字符
8 位、12 位、13 位或 14 位数字(UPC、EAN、JAN 或 ISBN)

重复值/字段

文本 (TSV)
3234567890126

XML (Feed)
<g:gtin>3234567890126</g:gtin>

 
MPN [mpn]

建议为所有商品提供
商品的制造商部件号

语法/类型
字母数字字符
最多 70 个字符

重复值/字段

文本 (TSV)
GO12345OOGLE

XML (Feed)
<g:mpn>GO12345OOGLE</g:mpn>

 
商品名 [title]

必须为所有商品提供

商品的名称

语法/类型

文本(Unicode 字符)

建议的字符数范围:80 - 140 个

重复值/字段

文本 (TSV)

Google Nexus 5 Android 手机 32 GB - 黑色 - 已解锁 - CDMA/GSM

XML (Feed)

<g:title>Google Nexus 5 Android 手机 32 GB - 黑色 - 已解锁 - CDMA / GSM</g:title>

请严格遵守我们的编辑指南。例如,不要添加任何促销文字,英文也不要全大写。

对于多款式商品,您需要添加所有款式面向消费者的名称,包括每种款式的商品名区别。

例如,如果“Google Nexus 5 Android 手机 32 GB - 已解锁 - CDMA”有红色和黑色两种款式,则必须在提交两个不同商品时分别设置相应名称:

  1. Google Nexus 5 Android 手机 32 GB - 红色 - 已解锁 - CDMA
  2. Google Nexus 5 Android 手机 32 GB - 黑色 - 已解锁 - CDMA

品牌 [brand]

必须为所有商品提供

商品的品牌名称

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

Acme Toys

XML (Feed)

<g:brand>Acme Toys</g:brand>

 
商品名称 [product_name]

可选属性

商品的规范名称

语法/类型

文本(Unicode 字符)

建议的字符数范围:80 - 140 个

重复值/字段

文本 (TSV)

Color LaserJet CP2025

XML (Feed)

<g:product_name>Color LaserJet CP2025</g:product_name>

 
产品线 [product_line]

建议为所有商品提供

相关商品组的名称

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

Creativa

XML (Feed)

<g:product_line>Creativa</g:product_line>

 
商品类型 [product_type]

可选属性

商品的类型或类别

语法/类型

文本(Unicode 字符),使用“>”符号分隔层次结构

重复值/字段

是;建议每件商品最多 10 个

文本 (TSV)

““家居与园艺 > 厨房, 餐厅与餐桌 > 家用电器 > 冰箱””, 家用电器 > 厨房 > 冰箱

XML (Feed)

<g:product_type>家居与园艺 &gt; 厨房、餐厅与餐桌 &gt; 家用电器 &gt; 冰箱</g:product_type> <g:product_type>家用电器 &gt; 厨房 &gt; 冰箱</g:product_type>

 
商品亮点 [product_highlight]

可选属性

商品的亮点

语法/类型

文本(Unicode 字符)

每个亮点的字符数范围:1 - 150 个

建议:仅使用 ASCII 字符

重复值/字段

是,建议 4 - 6 个

最少 2 个,最多 100 个

文本 (TSV)

"支持数千款应用,包括 Netflix、YouTube、HBO Now、Spotify、Showtime、Pandora、Google Play 电影","最大分辨率为 1080p","支持 2.4 Ghz 和 5 Ghz Wi-Fi 网络","支持 iOS、Mac OS、Windows、Chrome 操作系统和 Android 设备"

XML (Feed)

<g:product_highlight>支持数千款应用,包括 Netflix、YouTube、HBO Now、Spotify、Showtime、Pandora、Google Play 电影</g:product_highlight>

<g:product_highlight>最大分辨率为 1080p</g:product_highlight>

<g:product_highlight>支持 2.4 Ghz 和 5 Ghz Wi-Fi 网络</g:product_highlight>

<g:product_highlight>支持 iOS、Mac OS、Windows、Chrome 操作系统和 Android 设备</g:product_highlight>

 
 

详细信息

 
详细信息包含与您的商品关联的富媒体的相关信息。这些信息可包括图片、视频、链接或格式化描述。虽然这些信息不是必需的,但此处提供的其他属性可以完善商品详情,从而让客户在使用购物广告和非付费商品详情时获得更好的体验。详细了解上传富媒体内容的价值
 
属性 格式
说明 [description]

必需属性
一段详细描述商品的内容

语法/类型

文本(Unicode 字符)

仅限 ASCII

建议的字符数范围:500 - 1,000 个

重复值/字段

文本 (TSV)

纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。

XML (Feed)

<g:description>纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。</g:description>

功能说明 [feature_description]

推荐
详细的格式说明

语法/类型

文本(Unicode 字符)和图片
标题:建议不超过 140 个字符
文本:建议范围为 250 - 700 个字符
图片链接:最低 800x800 像素

子属性
标题 [headline]
文本 [text]
图片链接 [image_link]

重复值/字段
是;每件商品最少 2 个,建议 3 - 6 个

文本 (TSV)

现在配备了更大的显示屏:新一代产品现在配备了更大的显示屏,带您重新审视生活。:"http://example.com/image1.png",分辨率更高:"本品现在配备了 15 英寸显示屏,清晰度是之前产品的 10 倍,支持 3.5 倍变焦。":

XML (Feed)

<g:feature_description>
<g:headline>现在配备了更大的显示屏</g:headline>
<g:text>新一代产品现在配备了更大的显示屏,带您重新审视生活。</g:text>
<g:image_link>http://example.com/image1.png</g:image_link>
</g:feature_description>
<g:feature_description>
<g:headline>分辨率更高</g:headline>
<g:text>本品现在配备了 15 英寸显示屏,清晰度是之前产品的 10 倍,支持 3.5 倍变焦。</g:text>
</g:feature_description>

图片链接 [image_link]

必需属性

接受的图片格式包括(按照偏好设置的顺序)WEBP (.webp)、JPEG (.jpg/.jpeg)、PNG (.png)、非动画格式的 GIF (.gif) 和 BMP (.bmp),图片的文件扩展名应与其格式相对应。

接受的网址协议为 http://https://。图片网址中使用的所有符号都必须替换成网址编码实体(例如,英文逗号要替换成 %2C)。

网址必须是可抓取的,不得使用密码保护。必须允许用户代理“googlebot”和“googlebot-image”访问包含您的文件的目录。详细了解如何设置 robots.txt 文件

商品图片的网址

语法/类型

网址(必须以 http:// https:// 开头)

重复值/字段

文本 (TSV)

http://www.site.com/image1.jpg

XML (Feed)

<g:image_link>https://www.site.com/image1.jpg
</g:image_link>

接受的图片格式包括(按照偏好设置的顺序)WEBP (.webp)、JPEG (.jpg/.jpeg)、PNG (.png)、非动画格式的 GIF (.gif) 和 BMP (.bmp),图片的文件扩展名应与其格式相对应。

接受的网址协议为 http://https://。图片网址中使用的所有符号都必须替换成网址编码实体(例如,英文逗号要替换成 %2C)。

网址必须是可抓取的,不得使用密码保护。必须允许用户代理“googlebot”和“googlebot-image”访问包含您的文件的目录。详细了解如何设置 robots.txt 文件
附加图链接 [additional_image_link]

建议为包含多张图片的商品提供

商品图片的其他网址

语法/类型

网址(必须以 http://https:// 开头)

重复值/字段

是;建议每件商品最多 10 个

文本 (TSV)

http://www.example.com/image2.jpg、
http://www.example.com/image3.jpg、
http://www.example.com/image4.jpg

XML (Feed)

<g:additional_image_link>https://www.example.com/image2.jpg</g:additional_image_link> <g:additional_image_link>https://www.example.com/image3.jpg</g:additional_image_link><g:additional_image_link>https://www.example.com/image4.jpg</g:additional_image_link>

视频链接 [video_link]

可选属性

商品视频的网址

语法/类型

YouTube 网址(必须以 http://https:// 开头)

重复值/字段

是;建议每件商品最多 10 个

文本 (TSV)

https://www.youtube.com/watch?v=abc

XML (Feed)

<g:video_link>https://www.youtube.com/watch?v=abc</g:video_link>

商品页网址 [product_page_url]

可选属性

制造商商品详情页面的网址

语法/类型

YouTube 网址(必须以 http://https:// 开头)

重复值/字段

文本 (TSV)

http://www.example.com/asp/sp.asp?cat=12&id=1030

XML (Feed)

<g:product_page_url>http://www.example.com/
asp/sp.asp?cat=12&id=1030</g:product_page_url>

公开宣传日期 [disclosure_date]

可选属性

公开宣布商品的日期

语法/类型

日期

重复值/字段

文本 (TSV)

2013-12-05

XML (Feed)

<g:disclosure_date>2013-12-05</g:disclosure_date>

富媒体商品内容 [rich_product_content]

可选属性

旨在宣传商品特殊功能的丰富商品说明和媒体内容。

语法/类型

特殊结构化数据

重复值/字段

文本 (TSV)

注意:您需要将整个字段用英文双引号引起来并对其进行编码,并且需要使用两个英文双引号来转义该字段内的双引号。CSV/TSV 导出程序通常会为您执行此操作。

{

""@context"": {

""s"": ""http://schema.org/"",

""g"": ""http://schema.googleapis.com/""

},

""@type"": ""g:Showcase"",

""g:showcaseBlock"": [

{

""@type"": ""g:ShowcaseFeatureSet"",

""s:headline"": ""功能集标题"",

""s:itemListElement"": [

{

""@type"": ""g:ShowcaseFeature"",

""s:headline"": ""功能标题",

""s:description"": ""功能说明""

}

]

}

XML (Feed)

注意:在 XML 文件中,您需要将此作为 CDATA 编码。

<g:rich_product_content><![CDATA[

{

"@context": {

"s": "http://schema.org/",

"g": "http://schema.googleapis.com/"

},

"@type": "g:Showcase",

"g:showcaseBlock": [

{

"@type": "g:ShowcaseFeatureSet",

"s:headline": "功能集标题",

"s:itemListElement": [

{

"@type": "g:ShowcaseFeature",

"s:headline": "功能标题",

"s:description": "功能说明"

}

]

}

]

}

]]></g:rich_product_content>

发布日期 [release_date]

可选属性

商品可供购买的日期

语法/类型

日期

重复值/字段

文本 (TSV)

2013-12-05

XML (Feed)

<g:release_date>2013-12-05</g:release_date>

建议零售价格 [suggested_retail_price]

可选属性

制造商建议的零售价

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

USD 9.99

XML (Feed)

<g:suggested_retail_price>USD 9.99 </g:suggested_retail_price>

商品详情 [product_detail]

可选属性

其他详情和规格

语法/类型

文本(Unicode 字符)

字符数

部件名称:建议不超过 140 个字符

属性名称:建议不超过 140 个字符

属性值:最多 1,000 个字符

子属性

部件名称 [section_name](必需)

属性名称 [attribute_name](必需)

属性值 [attribute_value](必需)

重复值/字段

文本 (TSV)

常规:商品类型:数字播放器,
常规:数字播放器类型:基于 Flash,显示屏:分辨率:432 x 240,显示屏:对角线尺寸:"2.5 英寸""

XML (Feed)

<g:product_detail>
    <g:section_name>常规</g:section_name>
    <g:attribute_name>商品类型</g:attribute_name>
    <g:attribute_value>数字播放器</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>常规</g:section_name>
    <g:attribute_name>数字播放器类型</g:attribute_name>
    <g:attribute_value>基于 Flash</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>显示屏</g:section_name>
    <g:attribute_name>分辨率</g:attribute_name>
    <g:attribute_value>432 x 240</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>显示屏</g:section_name>
    <g:attribute_name>对角线尺寸</g:attribute_name>
    <g:attribute_value>2.5"</g:attribute_value>
</g:product_detail>

3D 模型链接 [virtual_model_link]

可选

商品的 3D 模型。如果提供,请添加 3D 体验平台。

语法/类型

网址(必须以“http://”或“https://”开头)

字符数

不能超过 2,000 个字符

重复值/字段

文本 (TSV)

https://www.google.com/products/xyz.glb

XML (Feed)

<g:virtual_model_link>https://www.google.com/products/xyz.glb </g:virtual_model_link>

 

款式信息

我们将款式定义为一组仅在颜色 [color] 或样式 [style] 等属性上存在差异的类似商品。通过提交不同款式的商品,您可以在 Google 产品和服务上投放的广告和商品详情中正确地将商品分组,从而帮助 Google 改善客户体验。

如何提交款式数据

  • 首先为每个款式提交对应的商品。
    • 例如,如果您提供 4 种颜色(黑色、白色、银色和红色)和 3 种存储容量(8GB、16GB 和 32GB)的特定型号手机,则需要提交 12 种款式的商品(黑色 8GB、黑色 16GB、黑色 32GB、白色 8GB、白色 16GB 等)。
  • 为每种商品款式添加唯一 ID [id] 属性值,就像您为商品数据中的所有其他商品添加这些属性值一样。
  • 若要将商品标识为彼此的变体,您需要使用商品组 ID [item_group_id] 将它们组合在一起。组中的每个商品应具有相同的商品组 ID。根据经验,如果用户可以在商品着陆页上选择不同的颜色、图案、尺寸、样式等,请将它们标识为单独的商品,但使用相同的商品组 ID 标识它们。
  • 在商品名中加入能显示每个款式与众不同之处的款式属性。必须提交颜色 [color] 和/或商品详情 [product_detail] 值以将各个商品区分开。

在为不同款式的商品创建商品名 [title] 时,请务必添加所有商品款式通用的名称,再加上各自专用的款式属性来区分不同的商品。

示例:

  • Google Nexus 5 Android 手机 - 32GB - 黑色 - 已解锁 - GSM
  • Google Nexus 5 Android 手机 - 16GB - 白色 - AT&T
属性 格式 最低要求概览

商品组 ID [item_group_id]

可选属性建议为具有多个款式/规格的商品提供。

用于标识商品/样式的款式/规格

语法/类型

仅限 ASCII

最多 50 个字符

重复值/字段

文本 (TSV)

AB123-Sp14

XML (Feed)

<g:item_group_id>AB123-Sp14</g:item_group_id>

为每组款式/规格使用唯一值。

尽可能使用父级库存量单位 (SKU)

更新商品数据时保持该值不变

只使用有效的 Unicode 字符

为以下一个或多个属性存在差异的一组商品使用商品组 ID [item_group_id]

如果以上属性无法表示您的商品在设计元素上存在的差异,请勿使用商品组 ID [item_group_id]

为商品组中的每件商品添加相同的属性。例如,如果商品的尺寸 [size]颜色 [color] 存在差异,则为具有相同商品组 ID [item_group_id] 值的每件商品提交尺寸和颜色

香味 [scent]

必须为香味有差异的商品组的所有商品提供。

对于所有将香味用作重要特征区分属性的商品,该属性是推荐属性。

商品的特定香味

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

鲜松味

XML (Feed)

<g:scent>鲜松味</g:scent>

 

口味 [flavor]

必须为口味有差异的商品组的所有商品提供。

对于所有将风味用作重要特征区分属性的商品,该属性是推荐属性。

商品的特定风味

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

辛辣烧烤

XML (Feed)

<g:flavor>辛辣烧烤</g:flavor>

 

格式 [format]

必须为格式有差异的商品组的所有商品提供。

对于所有将格式用作重要特征区分属性的商品,该属性是推荐属性。

商品的媒体格式

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

蓝光

XML (Feed)

<g:format>蓝光</g:format>

 

容量 [capacity]

必须为容量有差异的商品组的所有商品提供。

对于所有将容量用作重要特征区分属性的商品,该属性是推荐属性。

电子设备的固定内存存储容量

语法/类型

整数 + 计量单位

最多 100 个字符

重复值/字段

文本 (TSV)

16GB

XML (Feed)

<g:capacity>16GB</g:capacity>

该属性接受以下 3 个值:

  • MB
  • GB
  • TB

适用性别 [gender]

建议为适用性别有差异的商品组的所有商品以及所有将适用性别用作重要特征区分属性的商品提供。

商品适用人群的性别

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

male

XML (Feed)

<g:gender>male</g:gender>

该属性接受以下 3 个值:

  • male
  • female
  • unisex

请仅为此属性提交英语值。如果您提交翻译的值,则您的商品可能会不显示此信息或遭到拒批。

年龄段 [age_group]

必须为适用年龄段有差异的商品组的所有商品提供。

必须为所有服饰商品提供。

对于所有将适用年龄段用作重要特征区分属性的商品,该属性是推荐属性。

商品的目标年龄段

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

adult

XML (Feed)

<g:age_group>adult</g:age_group>

该属性接受以下 5 个值:

  • newborn
  • infant
  • toddler
  • kids
  • adult

请仅为此属性提交英语值。如果您提交翻译的值,则您的商品可能会不显示此信息或遭到拒批。

尺寸 [size]

必须为尺寸有差异的商品组的所有商品提供。

必须为“服饰与配饰 > 服装”和“服饰与配饰 > 鞋类”商品类别及其子类别下的所有服饰商品提供该属性。

对于所有将尺寸用作重要特征区分属性的商品,该属性是推荐属性。

商品的尺寸

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

XL

XML (Feed)

<g:size>XL</g:size>

 

尺码类型 [size_type]

只需要为服饰商品提供。

必须为尺码有差异的商品组的所有商品提供。

必须为“服饰与配饰 > 服装”商品类别及其子类别下的所有服饰商品提供该属性。

商品的尺码类型

语法/类型

字符串(Unicode 字符。建议:仅使用 ASCII 字符)

重复值/字段

是(最多可提交 2 个值)

文本 (TSV)

petite

XML (Feed)

<g:size_type>petite</g:size_type>

<g:size_type>maternity</g:size_type>

该属性有六个可接受的值。您可以提供两个值(例如,“大号和高版”或“小号和孕妇”)。

  • regular
  • petite
  • maternity
  • plus
  • tall
  • big

请仅为此属性提交英语值。如果您提交翻译的值,则您的商品可能会不显示此信息或遭到拒批。

尺码体系 [size_system]

建议为服饰商品提供

商品的尺码体系

语法/类型

文本(Unicode 字符)

重复值/字段

文本 (TSV)

US

XML (Feed)

<g:size_system>US</g:size_system>

该属性接受以下 11 个值:

  • US
  • UK
  • EU
  • DE
  • FR
  • JP
  • CN
  • IT
  • BR
  • MEX
  • AU

注意:如果您没有为某件商品指定此属性,我们会自动使用您所售商品要销往的目标国家/地区的默认值。

颜色 [color]

必须为颜色有差异的商品组的所有商品提供。

必须为所有服饰商品提供。

对于所有将颜色用作重要特征区分属性的商品,该属性是推荐属性。

商品的颜色

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

金/银/黑

XML (Feed)

<g:color>金/银/黑</g:color>

 

主题 [theme]

必须为主题有差异的商品组的所有商品提供。

对于所有将主题用作重要特征区分属性的商品,该属性是推荐属性。

商品的主题样式、图片和外观的说明

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

XML (Feed)

<g:theme>熊</g:theme>

 

图案 [pattern]

必须为图案有差异的商品组的所有商品提供。

对于所有将图案用作重要特征区分属性的商品,该属性是推荐属性。

商品的图案/图形

语法/类型

文本(Unicode 字符)

最多 100 个字符

重复值/字段

文本 (TSV)

条纹

XML (Feed)

<g:pattern>条纹</g:pattern>

 

材质 [material]

必须为材质有差异的商品组的所有商品提供。

对于所有将材质用作重要特征区分属性的商品,该属性是推荐属性。

商品的材料

语法/类型

文本(Unicode 字符)

最多 200 个字符

重复值/字段

文本 (TSV)

皮革/棉

XML (Feed)

<g:material>皮革/棉</g:material>

 

数量 [count]

必须为数量有差异的商品组的所有商品提供。

对于所有将数量用作重要特征区分属性的商品,该属性是推荐属性。

指定尺寸的包装容器内的单位数量

语法/类型

整数 + 计量单位

最多 100 个字符

重复值/字段

文本 (TSV)

30 粒

XML (Feed)

<g:count>30 粒</g:count>

 

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
547653969533956994
true
搜索支持中心
true
true
true
true
true
104514
false
false