与 Merchant Center 共享包含您的全部本地商品数据的文件。根据您选择的设置,Merchant Center 中的商品数据可以自动与商品数据文件保持同步。如果您已提供包含您的全部商品数据的文件,则可以为本地商品目录广告和非付费本地商品详情使用同一文件。
本文内容
- 商品数据源
- 提交商品数据源
- 属性要求汇总
- 必需的标识属性
- 必需的能效等级属性(仅限欧盟)
- 建议提供的排除属性
- 格式
- 如果您使用的是旧版本地商品数据源,则可以提供匹配属性(可选)
- 服饰商品
- 价格属性(可选)
- 门店自提属性(可选)
- 显示具体实体店库存状况和价格信息的商品页面属性(可选)
- 其他属性(可选)
商品数据源
要使用尚未启用本地商品目录广告或非付费本地商品详情的现有商品数据源,您需要启用相应插件,并选择将您的商品数据源用在向本地买家展示的广告或商品详情中。如要将商品数据源用在向本地买家展示的广告或商品详情中,请执行以下操作:
- 在您的 Merchant Center 账号中,点击左侧导航菜单中的设置图标
。
- 选择数据源。
- 选择要修改的商品来源。
- 点击您的设置,然后将“此数据源中商品数据的使用方式”修改为“将商品数据用于本地实体店和网店”。
Google 建议您在一个数据文件中提交所有商品,然后将该数据文件同时用于本地商品目录广告和非付费本地商品详情。对于新创建的数据源,您可以在数据源创建过程中选择数据源适用的所有目标平台。对于现有数据源,您可以通过主要数据源设置选择启用本地商品目录广告和/或非付费本地商品详情(作为其他目标平台)。如果您需要从购物广告或本地商品目录广告及非付费本地商品详情中排除某些商品,则可以使用禁止的目标平台 [excluded_destination] 属性。详细了解禁止的目标平台
提交商品数据源
文件类型:您可以使用带分隔符的文本文件(推荐)、XML 或 API。
注册新数据源:按照标准步骤注册新数据源。
请注意,商品在提交后最长可能需要 2 天才会显示。
重要提示:此商品数据规范中的某些属性包含空格和下划线。为确保提交的属性使用了正确的字符和分隔符号,请遵循下文中与您的文件类型相对应的准则:
- 制表符分隔的数据源:必须使用空格。如果属性带有下划线,请用空格代替“_”。
- XML 数据源或 XML API:必须使用下划线。下划线会在文件收到后转换为空格
- JSON API:必须使用下划线。下划线会在文件收到后转换为空格
属性要求汇总
| 属性 | 提交要求 |
商品名 [title] |
必须为您在商店出售的所有商品提供这些属性。 |
GTIN [gtin] |
对于所有具有制造商指定 GTIN 的新商品,是必需属性。 对于所有其他商品,是可选属性,但强烈建议提供。 |
品牌 [brand] |
对于所有新商品(电影、图书和音乐唱片品牌除外),是必需属性。 对于所有其他商品,是可选属性。 |
使用情况 [condition] |
对于二手或翻新商品,是必需属性。 对于全新商品,是可选属性。 |
|
能效等级 最低能效等级 [max_energy_efficiency_class] |
如果您的商品的目标市场是任何欧盟成员国、英国或瑞士,则为必需属性。 如果您的商品的目标市场不是任何欧盟成员国、英国或瑞士,则为可选属性。 |
禁止的目标平台 [excluded_destination] |
如果您使用单个商品数据源同时提交在线商品和本地商品的商品数据,建议您提供此属性。 使用此属性可阻止不在商店出售的商品显示在本地商品目录广告和非付费本地商品详情中。 |
|
MPN |
可选 如果您使用旧版本地商品数据源为本地商品提交商品数据,则可以使用这些属性将商品数据源与本地商品数据源中同时采用在线销售和实体店内销售两种方式的商品进行匹配。为此,您有 2 种选择:
[condition] 属性。 |
|
促销价有效期 [unit_pricing_base_measure] |
推荐属性 如果不同商店之间的商品价格一致,可以在主要数据源中提交价格 必需属性 如果使用显示实体店库存状况的商品页面,则必须在主要数据源中使用价格 [unit_pricing_measure] 和基准价格计量单位 [unit_pricing_base_measure] 为必需属性。 |
|
如果您希望允许用户在线购买商品后到门店提货,则需要提供这 2 个属性:
重要提示:自 2024 年 9 月 1 日起,在为商品启用门店自提功能时,提货方法
[pickup_method] 属性为可选属性。 |
|
|
移动版链接模板 [ads_redirect] |
如果您要使用商家自管的本地店面页面,则这些属性为可选属性。 对于显示实体店库存状况的商品页面,链接 对于显示具体实体店库存状况和价格信息的商品页面,商家自管的本地店面页面的链接 商家自管的本地店面页面的移动版链接 |
重要提示(仅适用于 XML 文件):如果您通过 XML 文件为 Merchant Center 数据源更新下面所列的属性,则必须添加 Google Merchant Center 命名空间声明。否则,系统可能无法正确处理您的数据源。
必需的标识属性
下面这些属性用于说明有关您商品的基本信息。所有商品都必须提供这些属性。
ID [id] - 商品的标识码
每件商品的标识码在所有商店中都是唯一的,并且不能在针对同一国家/地区、使用同一语言的同类型数据源间重复使用。
在什么情况下需要提供:数据源中的所有商品都需要提供此属性。
| 类型 | 字符串 |
| 文本/制表符分隔示例 | 421486 |
| XML 示例 | <g:id>421486</g:id> |
重要提示:
- 开头和结尾的空格和回车符 (0x0D) 会被移除。
- 系统会将每个序列的回车符 (0x0D) 和空白字符(具有空格属性的 Unicode 字符)替换为一个空格 (0x20)。
- 请仅使用有效的 Unicode 字符,不包括以下字符:
- 控制字符(回车符 0x0D 除外)
- 功能字符
- 私人使用区字符
- 代理项对
- 非指定的码位(特别是大于 0x10FFFF 的所有码位)
- 商品提交后,在更新数据数据源时便无法再更改 ID,以后也无法再将此 ID 用于其他商品。
- 如果您要在购物广告系列中使用 ID,我们建议您只使用小写或不区分大小写的字符。
商品名 [title] - 商品的名称
您所售商品的名称。Google 建议您在商品名中加入颜色或品牌等特征,以便将相关商品与其他商品区分开来。如果匹配成功,Google 可能会改为投放在线商品或 Google 目录数据中的商品名。
在什么情况下需要提供:数据源中的所有商品都需要提供此属性。
| 类型 | 文本(字符串),少于 70 个字符 |
| 文本/制表符分隔示例 | Netgear ReadyNAS Duo |
| XML 示例 | <g:title>Netgear ReadyNAS Duo</g:title> |
重要提示:
- 请严格遵守我们的编辑指南。例如,请勿加入任何促销文字(如“免运费”),也不要全部大写。
- 对于多款式商品,您需要添加各款式通用的商品名。例如,如果“男式珠地网眼 Polo 衫”有红色和蓝色两种款式,则您可以使用以下其中一个商品名:
- 男式珠地网眼 Polo 衫(红蓝两款都适用)
- 男式珠地网眼 Polo 衫 - 红(适用于红色款)
- 男式珠地网眼 Polo 衫 - 蓝(适用于蓝色款)
说明 [description] - 商品的说明
只能包含与商品相关的信息。描述最相关的属性,如尺寸、材质、适用年龄段、特殊商品特征,或其他技术规格。此外还应添加有关商品的直观属性(如形状、图案、质地和设计)的详细信息,因为我们可能会根据这些文字来查找您的商品。
建议提供 500 到 1000 个字符的简介,但最多可提供 5000 个字符。说明应遵循标准的语法规则,并以标点结尾。
在什么情况下需要提供:数据源中的所有商品都需要提供此属性。
Merchant API v2 (JSON):"description": "纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。"
Merchant API v2 (XML):<description>纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。</description>
| 类型 | 文本 |
| 字符数限制 | 5000 |
| 文本 (TSV) | 纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。 |
| XML(数据源) | <description>纯红色大码床单,100% 梭织全涤 300T 面料。四件套中包括一件床罩、一件床单以及两个标准枕套。可机洗;超深装口袋。</description> |
重要提示:
- 请务必严格遵守 Google 的编辑指南。例如,不要添加任何促销文字(如“免运费”),不要全部大写,也不要添加品牌或公司简介。
- 此外,说明中也不能包含以下信息:
- 商店或其他网站的链接
- 结算、付款或销售信息
- 对内部分类系统的引用,例如:“玩具和游戏 > 玩具 > 洋娃娃”
- 与其他人售卖的商品进行的比较,例如:“比 X 更好/更快/更大”
- 关于其他商品、配件或类似商品的详细信息。
图片链接 [image_link] - 商品图片的网址
这是商品主图的网址,此图片是客户进入商品详情页后看到的第一张图片。
如果商品有多张不同的图片,请使用此属性提交主图,并在附加图链接 [additional_image_link] 属性中添加其他所有图片。
图片大小:
- 提交您能找到的最大、分辨率最高的完整尺寸商品图片,文件大小不得超过 16MB。
- 建议使用不低于 800 x 800 像素的图片。
- 对于服饰商品,图片不得小于 250 x 250 像素,但也不能超过 6400 万像素。对于其他所有商品,图片不得小于 100 x 100 像素,但也不能超过 6400 万像素。
- 请勿放大图片或提交缩略图。我们建议商品在整个图片中占据 75% - 90% 的比例。
在什么情况下需要提供:数据源中的所有商品都需要提供此属性。
Merchant API v2 (JSON):"imageLink": "http://www.example.com/image1.jpg"
Merchant API v2 (XML):<image_link>http://www.example.com/image1.jpg</image_link>
| 类型 | 网址(必须以“http://”或“https://”开头) |
| 字符数限制 | 2000 |
| 文本 (TSV) | http://www.example.com/image1.jpg |
| XML(数据源) |
|
满足以下要求并采纳以下建议有助于改善客户的购物体验。
要求:
- 如果您没有商品的图片,就不能提交商品。
- 不允许使用以下类型的图片:
- 占位图片或错误的商品图片
- 不是实际商品图片的通用图片、图形或插图,'硬件' (632) 或 '汽车及零配件' (888) 类别中的商品除外,上述类别允许使用实际商品的图片和/或插图
- 仅含颜色方格的单色图片,'汽车涂料' (3812)、'工艺涂料、墨水和釉料' (505378) 以及 '绘画消耗品' (503740) 类别中的商品除外
- 包含促销元素(例如“购买”等号召性用语;与服务相关的信息,例如延保;免运费;价格信息;促销性质的形容词,例如“物美价廉”;使用情况或兼容性,例如“新”“两件套”“可适配”)或商家名称以及/或者商家徽标的图片,无论上述元素是否遮盖商品本身都不允许。这同样适用于带有促销元素或商家名称以及/或者商家徽标的水印
- 包含叠加在所售商品上且妨碍正常观看的内容(例如水印、品牌名称和/或徽标)的图片
- 带有边框的图片
- 未展示套装内所有商品的商品套装图片
- 多件组合装图片中未显示其中的单件商品
- 另外,我们不允许着陆页上不展示任何图片,也不允许使用未显示实际商品的占位图片。
-
请确保您为每件商品提供的图片与您在颜色
[color]、图案[pattern]和材质[material]属性中提供的值保持一致,否则我们可能会拒批您的商品。
建议:
- 如果您无法提供合适的图片以便将商品作为一件商品的不同款式/规格提交,则可以将多款式商品作为该款式/规格属性具有多个值的单件商品提交,并提供可用图片。
- 图片中必须正确显示商品,并尽量少显示或不显示商品场景元素。
- 对于按颜色分类的款式,您提交的各种不同款式的商品必须都有一张显示单一颜色商品的图片。
- 主图应采用纯白色、灰色或浅色背景;
-
商品的主图应包含正在出售的商品的主视图和/或清晰视图。商品的其他视图(除主视图外)应提交到附加图链接
[additional_image_link]属性中。
格式设置:
- 接受的图片格式包括非动画格式的 GIF (.gif)、JPEG (.jpg/.jpeg)、PNG (.png)、BMP (.bmp) 和 TIFF (.tif/.tiff),图片的文件扩展名应与其格式相对应。
- 接受的网址协议为“http”和“https”。图片网址中使用的所有符号都必须替换成网址编码实体(例如,英文逗号要替换成“%2C”)。
- Google 建议您提交图片的稳定网址,并且仅在商品的实际图片发生变化时才更新此网址。这种做法在您使用内容分发网络来托管图片时尤为重要,因为这可以确保 Google 能够正确抓取您的图片。
图片剪裁:
我们可能会自动剪裁您的图片,以进一步突出商品。
使用情况 [condition] - 商品的使用情况或状态
Google 允许宣传优质的二手商品。Google 也允许宣传翻新商品,前提是这些商品遵守当地的法律法规和我们的政策。
此属性仅接受以下 3 种值:
- 全新
[new]:该商品是全新的,从未使用过。商品的包装原封未动。 - 翻新
[refurbished]:商品经过专业处理后达到可正常使用的状态,像新的一样,并有售后保修服务。包装有可能不是原包装。这类商品有时也称为“再生”商品。 - 二手
[used]:如果“全新”和“翻新”不适用,请使用此值。例如:使用过的商品、重装了墨汁的打印机墨盒或原包装已打开或缺失的商品。
在什么情况下需要提供:如果您的商品是二手或翻新商品,此属性为必需属性。对于全新商品,是可选属性。
Merchant API v2 (JSON):"condition": "二手"
Merchant API v2 (XML):<condition>二手</condition>
| 类型 |
仅接受以下 3 种值:
|
| 文本 (TSV) | used |
| XML | <g:condition>used</g:condition> |
重要提示:如果您用英文提交属性名称,则属性值也必须以英文提供。
GTIN [gtin] - 商品的全球贸易项目代码 (GTIN)
使用 GTIN 属性以下列某种格式提交全球贸易项目代码 (GTIN):
- UPC(适用于北美,也称为 GTIN-12):12 位数字(8 位数的 UPC-E 代码应转换为 12 位数代码)。
- EAN(适用于欧洲,也称为 GTIN-13):13 位数字。
- JAN(适用于日本,也称为 GTIN-13):8 或 13 位数字。
- ISBN(适用于图书):10 或 13 位数字。如果两种格式的代码都有,只需输入 13 位数字的代码。ISBN-10 代码已弃用,应转换为 ISBN-13 代码。
- ITF-14(适用于多件组合装,也称为 GTIN-14):14 位数字。
| 在哪里需要提供 | 对于所有具有制造商指定 GTIN 的新商品,是必需属性 |
| 类型 | 8 位、12 位、13 位或 14 位数字(UPC、EAN、JAN 或 ISBN) |
| 字符数限制 | 50 |
| 文本/制表符分隔 | 3234567890126 |
| XML(数据源) | <g:gtin>3234567890126</g:gtin> |
重要提示:
- 我们只接受官方 GS1 验证指南中定义的有效 GTIN,其中包括以下要求:
- 校验和数字是最新的且正确无误。
- GTIN 不受限制(GS1 前缀范围:02、04、2)。
- GTIN 不是优惠券(GS1 前缀范围:98 - 99)。
品牌 [brand] - 商品的品牌
在什么情况下需要提供:对于所有新商品(电影、图书和音乐唱片品牌除外),此属性为必需属性。对于所有其他商品,是可选属性。
Merchant API v2 (JSON):"brand": "Acme"
Merchant API v2 (XML):<brand>Acme</brand>
| 类型 | 文本 |
| 字符数限制 | 70 |
| 文本 (TSV) | Acme |
| XML(数据源) | <g:brand>Acme</g:brand> |
重要提示:除非您是商品的制造商,否则请勿将商店名称作为品牌使用。
能效等级 [energy_efficiency_class]、最低能效等级 [min_energy_efficiency_class] 和最高能效等级 [max_energy_efficiency_class] 属性是可选属性,但根据当地的法律或法规,您可能需要提供这些信息。例如,如果您的商品的目标市场是任何欧盟成员国、英国或瑞士,请注意遵守欧盟指令 2017/1369 的国家实施法案及任何其他适用地方法律对此问题的法律要求。
能效等级 [energy_efficiency_class]、最低能效等级 [min_energy_efficiency_class]、最高能效等级 [max_energy_efficiency_class]
您可以使用此属性指定商品所需的能效等级值。
在什么情况下需要提供:我们强烈建议您为适用的商品提交能效等级、最低能效等级和最高能效等级属性。您可能需要为以下类型的商品提供此类属性:
| 冰箱 | 烤箱 |
| 冰柜 | 热水器 |
| 洗衣机 | 热水存储设备 |
| 滚筒干衣机 | 空调 |
| 洗衣干衣一体机 | 电灯 |
| 葡萄酒存储设备 | 照明设备 |
| 洗碗机 | 电视机 |
| 类型 |
可接受的值:
|
| 文本 (TSV) | A+ |
| XML 示例 | <g:energy_efficiency_class>A+</g:energy_efficiency_class> |
重要提示:
- 最低能效等级
[min_energy_efficiency_class]值必须小于最高能效等级[max_energy_efficiency_class]值。例如,您的能效等级一般应按照从 A 到 D(而非从 D 到 A)排列。 - 您提供的能效等级
[energy_efficiency_class]值必须在最低能效等级值和最高能效等级值之间。例如,如果能效等级范围为 A 到 D,则您为能效等级提供的值不能是 G。
建议提供的排除属性
您可以使用禁止的目标平台 [excluded_destination] 属性排除不符合特定目标平台要求的商品,也可以使用它来控制哪些位置可以展示商品内容。例如,如果您希望在购物广告系列中展示商品,但不在本地商品详情中展示,则可以使用此属性。
在什么情况下需要提供:如果您不希望在特定类型的广告和商品详情中展示您的商品,建议提供此属性。
支持的值:
- 购物广告
[Shopping_ads]。阻止您所售的商品在购物广告中展示。了解购物广告 - 展示广告
[Display_ads]。阻止您所售的商品在动态再营销广告中展示。了解零售动态再营销 - 本地商品目录广告
[Local_inventory_ads]。阻止您所售的商品在本地商品目录广告中展示。详细了解本地商品目录广告 - 非付费商品详情
[Free_listings]。阻止您所售的商品在非付费商品详情中展示。详细了解如何在 Google 上免费展示您的商品 - 非付费本地商品详情
[Free_local_listings]。阻止在 Google 上免费展示您所售的本地商品。详细了解如何在 Google 上免费展示您的本地商品
Shopping Actions、Surfaces across Google、Local surfaces across Google。这些值仍然可以接受,但是我们建议您更新商品,改用表示这些目标平台的新值:Free_listings、Free_local_listings。格式
请遵守以下格式准则,确保 Google 能正确解读您提交的数据。
| 支持的值 | Shopping_ads、Display_ads、Local_inventory_ads、Free_listings、Free_local_listings |
| 重复字段 | 是 |
| 文件格式 | 示例值 |
| 文本数据源 | Display_ads |
| XML 数据源 | <g:excluded_destination>Display_ads</g:excluded_destination> |
重复字段
文本
如需提交多个要禁止的目标平台,建议您多次提交该属性,每个目标平台提交一次。例如:
| 矫形狗床的商品数据 | |
| 属性 | 值 |
商品名 [title] |
XXL 矫形狗床 |
禁止的目标平台 [excluded_destination] |
Display_ads |
禁止的目标平台 [excluded_destination] |
Shopping_ads |
您也可以用英文逗号 (,) 分隔各个目标平台:
Display_ads、Shopping_ads
XML
若要通过 XML 数据源提交多个禁止的目标平台,请单独为每个禁止的目标平台添加此属性:
<g:excluded_destination>Display_ads</g:excluded_destination>
<g:excluded_destination>Shopping_ads</g:excluded_destination>
如需详细了解格式 API,请参阅 Merchant API
如果您使用的是旧版本地商品数据源,则可以提供匹配属性(可选)
匹配 ID [webitemid] - 匹配在线 ID 和本地 ID
如果本地商品数据源中的 ID [id] 属性与商品数据源中的 ID 不一致,您可以使用匹配 ID 进行匹配。您应为 ID 提交不同的值,但必须为匹配 ID 和 ID 提交相同的值。此值应始终与商品数据源中相应款式/规格(如果有)的 ID 保持一致。
由于匹配 ID 仅用于进行匹配,因此如果多个商品映射到商品数据源中的同一商品,则这些商品可能会共用同一个匹配 ID。
在什么情况下需要提供:建议为在线及本地使用不同 ID/SKU 的所有商品都提供此属性。
| 类型 | 文本(字符串) |
| 文本 (TSV) | WB1011 |
| XML 示例 | <g:webitemid>WB1011</g:webitemid> |
重要提示:
- 开头和结尾的空格和回车符 (0x0D) 会被移除。
- 系统会将每个序列的回车符 (0x0D) 和空白字符(具有空格属性的 Unicode 字符)替换为一个空格 (0x20)。
- 请仅使用有效的 Unicode 字符,不包括以下字符:
- 控制字符(回车符 0x0D 除外)
- 功能字符
- 私人使用区字符
- 代理项对
- 非指定的码位(特别是大于 0x10FFFF 的所有码位)
- 商品提交后,在更新数据源时便无法再更改匹配 ID [webitemid],以后也无法再将它用于其他商品。
GTIN [gtin] - 商品的全球贸易项目代码 (GTIN)
在此属性中,您可以添加商品的全球贸易项目代码 (GTIN)。
在什么情况下需要提供:如果您同时在实体店和网店中销售商品,且不能使用 ID [id] 属性进行匹配,则需要使用匹配 ID [webitemid] 或唯一商品标识码作为匹配属性。
如果您使用某种唯一商品标识码进行匹配,则需要在此数据源中添加“使用情况”属性。
| 类型 | 文本(字符串) |
| 文本 (TSV) | 0606449056822 |
| XML 示例 | <g:gtin>0606449056822</g:gtin> |
MPN [mpn] - 商品的制造商部件号 (MPN)
此编号可唯一识别商品的制造商。品牌和 MPN 的组合可以特别明确地指定某件商品。
在什么情况下需要提供:如果您同时在实体店和网店中销售商品,且不能使用 ID [id] 属性进行匹配,则需要使用匹配 ID [webitemid] 或唯一商品标识码作为匹配属性。
如果您使用某种唯一商品标识码进行匹配,则需要在此数据源中添加“使用情况”属性。
| 类型 | 文本(字符串) |
| 文本 (TSV) | RND2150 |
| XML 示例 | <g:mpn>RND2150</g:mpn> |
品牌 [brand] - 商品的品牌
在什么情况下需要提供:如果您同时在实体店和网店中销售商品,且不能使用 ID [id] 属性进行匹配,则需要使用匹配 ID [webitemid] 或唯一商品标识码作为匹配属性。
如果您使用某种唯一商品标识码进行匹配,则需要在此数据源中添加“使用情况”属性。
| 类型 | 文本(字符串) |
| 文本 (TSV) | Netgear |
| XML 示例 | <g:brand>Netgear</g:brand> |
服饰商品
在主要数据源中,服饰商品需要几个额外的属性:
商品组 ID [item_group_id] - 同一商品的所有款式共有的标识码
同一商品的所有不同款式商品必须使用相同的商品组 ID 值。如果同一商品的所有款式有相同的“父级 SKU”,则可提供此 SKU 作为商品组 ID 值。
在什么情况下需要提供:如果目标国家/地区为巴西、法国、德国、日本、英国和美国,对于使用以下详细商品属性区分款式的所有商品,此属性为必需属性:颜色 [color]、尺码 [size]、图案 [pattern]、材质 [material]、年龄段 [age group]、适用性别 [gender]、尺码类型 [size type] 和尺码体系 [size_system]。对于所有其他国家/地区,此属性为推荐属性。
Merchant API v2 (JSON):"itemGroupId": "AB12345"
Merchant API v2 (XML):<item_group_id>AB12345</item_group_id>
| 类型 | 字母数字代码 |
| 字符数限制 | 50 |
| 文本 (TSV) | AB12345 |
| XML(数据源) | <g:item_group_id>AB12345</g:item_group_id> |
重要提示:
- 商品组 ID
[item_group_id]属性与 ID[id]属性不同。同一商品的不同款式具有相同的商品组 ID 属性值,而同一商品的不同款式以及不同商品的 ID 属性值各不相同。 - 您为不同商品提供的商品组 ID 值不能相同,只有同一商品的不同款式才能共用一个值。
- 如果您向我们提交商品组 ID 属性,我们就会自动查找款式属性。如果商品使用商品组 ID 属性,请确保同时为该商品指定至少一个详细商品属性。
颜色 [color] - 商品的颜色
此属性定义了商品的主体色。如果单一商品有多种颜色,您最多可额外提交 2 个代表强调色的值:
- 按颜色的显眼程度顺序以“/”组合颜色,主体色在前,最多 2 种强调色在后。例如,带绿色强调色的黑色鞋子的“颜色”值应为“黑色/绿色”。如果是漆面或材质等同于颜色的不可变形的服饰类别商品(如珠宝首饰或木质配饰),漆面或材质名称可作为颜色
[color]属性的值提交(例如“红木”“不锈钢”与“玫瑰金”)。 - 如果您使用 XML,则需用“#47;”表示“/”
在什么情况下需要提供:对于商品组中以颜色区分的所有商品,以及数据源中目标国家或地区为巴西、法国、德国、日本、英国和美国的所有服饰商品,此属性为必需属性。对于将颜色用作重要特征区分属性的所有商品,此属性为推荐属性。
Merchant API v2 (JSON):"color": "黑色"
Merchant API v2 (XML):<color>黑色</color>
| 类型 | 文本 |
| 字符数限制 | 100 |
| 文本 (TSV) | 黑色 |
| XML(数据源) | <g:color>黑色</g:color> |
不能添加的内容:
- 包含数字的颜色值(例如“0 2 4 6 8”)。
- 包含非字母数字字符的颜色值(例如“
#fff000”)。 - 以单个拉丁字母表示的颜色值(例如“G”)。但是可以使用以中文/日文/韩文单个字表示的颜色值(例如“红”)。
- 引用商品或商品图片的颜色值(例如“参见图片”)。
- 不是实际有效颜色名称的说明性值(例如:多种颜色、不同颜色、各种颜色、参见图片、无)。
- 超过 40 个字符的长颜色值。
- 由多种其他颜色组合而成的长颜色值(例如
红粉蓝)。正确做法:- 如果要为单件商品(并非多个商品款式/规格)指定多种颜色,请指定一种主体色,并可在后面添加最多两种辅助色,颜色之间以“/”分隔。例如,将
红粉蓝替换为红/粉/蓝。 - 如果要为多件类似商品(商品款式)指定多种颜色,请单独提交这些商品,并为每件商品使用相同的商品组 ID 和不同的颜色值。
- 如果要为单件商品(并非多个商品款式/规格)指定多种颜色,请指定一种主体色,并可在后面添加最多两种辅助色,颜色之间以“/”分隔。例如,将
无效提交说明:
- 如果您提交的颜色值违反上述句法规则,Google 可能会在您提交数据源时拒绝整条商品信息。
- Google 会定期验证您提交的属性正确与否,包括颜色。如果发现您提供的值不正确,Google 可能会从“购物”标签页中移除您的所有商品。
重要提示:
- 对于商品款式,您必须将每种不同的颜色或颜色组合作为独立商品分别提交,同时提供相应的商品组 ID。
- 请对相同商品的各个款式以及同一类别下的多件商品使用一致的颜色名称。
- 您提供的值可能会对客户显示,因此请提供客户能理解的值。
尺码 [size] - 商品的尺码
该属性用于表示商品的尺寸。对于“服饰与配饰”商品,您还可以提交尺码类型 [size_type] 和尺码体系 [size_system] 属性,以提供更详细的商品尺寸信息。
- 只能为每件商品提交一个尺寸属性。如果您为同一商品提供多个尺寸属性,则系统只会应用第一个尺寸属性。其他尺寸属性将被舍弃,并且您会收到一条警告。
在什么情况下需要提供:对于商品组中以尺码区分的所有商品,此属性为必需属性。对于在商品数据中属于“服装与配饰 > 服装”和“服装与配饰 > 鞋类”商品类别,且目标国家/地区为巴西、法国、德国、日本、英国和美国的所有服饰商品,此属性为必需属性。对于所有将尺码用作重要特征区分属性的商品,此属性为推荐属性。
Merchant API v2 (JSON):"sizes": ["XL"]
Merchant API v2 (XML):<size>XL</size>
| 类型 |
如果您的商品面向美国销售,请参阅可识别的值列表(仅限美国) 对于所有其他国家/地区,请参阅示例尺码。 |
| 字符数限制 | 100 |
| 文本 (TSV) | XL |
| XML(数据源) | <g:size>XL</g:size> |
重要提示:
- 对于商品款式,您必须将每种不同的尺寸或尺寸组合作为独立商品分别提交,同时提供相应的商品组 ID。详细了解如何提交服饰商品
- 如果尺寸中包含多种规格,请将其精简为一个值(例如,“16/34 高”表示领口 16 英寸,袖长 34 英寸,适合“高大”身材)。
- 相同商品的不同款式以及相同类别下的不同商品需使用统一尺寸值。例如,在 T 恤系列商品中,请使用统一的“S”“M”和“L”表示尺寸,不要混用“S”“中号”和“加大”。
- 如果没有不同尺码款式的具体图片,您可以使用相同的图片;但是我们建议,链接 [link] 属性应指向提供了相关商品款式所有详情的页面。
- 您提供的值可能会对客户显示,因此请提供客户能理解的值。
- 您可以在文本字符串中提供更多关于尺寸的详细信息。例如,您可以提供“3.5 儿童”或“3.5 幼儿”等值。
- 如果您的商品是均码尺寸或适合大多数人的尺寸,则可以在此属性中使用“one size”或“OS”(单码)、“one size fits all”或“OSFA”(均码)、“one size fits most”或“OSFM”(适合大多数人)等表述。
尺寸值示例
尺寸值可能难以用于表示不同类型的服饰商品。您不一定要提供准确的值,但建议您为服饰商品提供标准化的尺寸值。此外,您还可以使用尺码类型 [size_type] 和尺码体系 [size_system] 属性,提供更多的商品尺寸信息。
上装、外套和连衣裙
XXS、XS、S、M、L、XL、1XL、2XL、3XL、4XL、5XL、6XL
00、0、02、04、06、08、10、12、14、16、18、20、22、24、26、28、30、32、34
下装
XXS、XS、S、M、L、XL、1XL、2XL、3XL、4XL、5XL、6XL
00、0、02、04、06、08、10、12、14、16、18、20、22、24、26、28、30、32、34
23、24、26、27、28、29、30、32、34、36、38、40、42、44
对于裤装:24x30、24x32、24x34
加大、小号、大、高、内长等
- 如果商品适用特殊的尺码组(例如加大、小号、孕妇或加肥加大),请使用尺码类型
[size_type]属性。 - 如果商品包含内长信息,请考虑使用以下尺码格式:30 号缩短、30 号常规、30 号加长
鞋类
- 美国码:5、5.5、6、6.5、7、7.5、8、8.5、9、9.5、10、10.5、11、11.5、12、12.5、13、13.5、14、14.5、15、15.5、16。
- 欧洲码:37、38、39、40、41、42、43、44、45。
适用性别 [gender] - 商品所面向的性别
"gender": "male" Merchant API v2 (XML) <gender>male</gender>| 格式 |
仅接受以下 3 种值:
|
| 文本 (TSV) | male |
| XML(数据源) | <g:gender>male</g:gender> |
重要提示:
- 如果您以英文提交属性名称,则属性值也必须以英文提供。
- 对属于“服饰与配饰”类别中“钮扣徽章”“领带夹”“腕带”“鞋套”“鞋带”“马刺”和“表带”子类别下面的商品,此属性只是推荐属性,而非必需属性。
年龄段 [age_group] - 商品的目标年龄段
"ageGroup": "成人"Merchant API v2 (XML):<age_group>成人</age_group>
| 格式 |
此属性仅接受以下 5 种值:
|
| 文本 (TSV) | adult |
| XML(数据源) | <g:age_group>adult</g:age_group> |
重要提示:
- 每个值的目标市场的定义如下:
- 新生儿
[newborn]:3 个月以下。新生儿尺寸通常以 0-3 个月这一年龄段和/或单独的“新生儿”[newborn] 值来表示。 - 婴儿
[infant]:3-12 个月。婴儿尺寸通常以 3-12 个月这一年龄段来表示。 - 幼儿 [toddler]:1-5 岁。幼儿尺寸通常以 12-24 个月或 1-5 岁这样的年龄段来表示。
- 儿童
[kids]:5-13 岁。此年龄段对应的所有尺寸专为该年龄段内的儿童而设计。 - 成人
[adult]:通常是指青少年或年龄更大的群体。此年龄段对应的所有尺寸专为该年龄段内的成人或青少年而设计。 - 如果您以英文提交属性名称,则属性值也必须以英文提供。
- 新生儿
- 对属于“服饰与配饰”类别中“钮扣徽章”“领带夹”“腕带”“鞋套”“鞋带”“马刺”和“表带”子类别下面的商品,此属性只是推荐属性,而非必需属性。
- 如果某件商品明显并非仅适用于儿童,应将其声明为“成人”
[adult],因为每件商品只能提交一个值。
价格属性(可选)
还有一些可选属性,您可以在适用的情况下提交。
价格 [price] - 商品在全国范围内的默认价格
如果商品在所有商店中的价格一致,请使用此属性提交此默认价格。如果商品在所有商店中的价格一致,或者您要使用显示实体店库存状况的商品页面,请提交此价格。
否则,您在本地商品目录数据源中包含的任何特定商店的价格都会覆盖此属性值。
如果您要使用显示实体店库存状况的商品页面功能,则必须提供价格属性,并且此价格必须与着陆页上的价格一致。
注意:Google 会根据商店所在的国家/地区采用相应的币种。如果币种是在商品级别设置的,请确保它符合 ISO 4217 标准。
在什么情况下需要提供:对于所有商品,此属性都是推荐属性。
| 类型 | 价格(浮点数) |
| 文本 (TSV) | 299.99 USD |
| XML 示例 | <g:price>299.99</g:price> |
促销价 [sale_price] - 用于宣传商品的促销价格
Google 建议您为任何具有促销价的商品提交促销价有效期 [sale_price_effective_date] 属性,这将决定您的促销价何时生效。如果不提交促销价有效期,该商品通过数据源提交后,促销价就会生效。
在什么情况下需要提供:对于促销商品,此属性为推荐属性。
| 类型 | 数字 |
| 文本 (TSV) | 249.99 |
| XML 示例 | <g:sale_price>249.99</g:sale_price> |
促销价有效期 [sale_price_effective_date] - 商品促销的日期范围
与促销价 [sale price] 属性结合使用。此属性指明了促销价的生效日期。详细了解促销价的定义
| 类型 | 开始日期和结束日期以正斜线 (/) 分隔。开始日期应遵循 ISO 8601 标准,具体格式如下:先是日期 YYYY-MM-DD,后面依次为字母“T”、促销开始的具体时间,以及促销所在时区的代码。结束日期应采用相同的格式。如果未指定时区,则系统会采用世界协调时间 (UTC)。 |
| 文本 (TSV) |
世界协调时间 (UTC) 示例:2021-07-19T17:00:00/2021-07-27T05:00:00 太平洋标准时间示例:2021-07-19T09:00:00-08:00/2021-07-26T21:00:00-08:00 |
| XML | <g:sale_price_effective_date>2021-07-19T17:00:00/2021-07-27T05:00:00</g:sale_price_effective_date> |
价格计量单位 [unit_pricing_measure] - 定义商品的计量单位和尺寸
使用价格计量单位 [unit_pricing_measure] 属性定义商品的计量单位和尺寸。此值可帮助客户了解商品的确切单价。
在什么情况下需要提供:对于每种商品,此属性都是可选属性(除非当地法律或法规要求提供)。
| 类型 | 正数加单位 |
| 文本 (TSV) | 1.5kg |
| XML 示例 | <g:unit_pricing_measure>1.5kg</g:unit_pricing_measure> |
基准价格计量单位 [unit_pricing_base_measure] - 即单价中的分母
商品的基准价格计量单位(例如,“100ml”表示价格以 100ml 为单位进行计算)。如果您使用价格计量单位 [unit_pricing_measure],则请使用基准价格计量单位属性为商品添加基准单价。为了使网页上所有广告和非付费本地商品详情中的单位价格更容易比较,您的商品所显示的基准计量单位可能与您在此处提供的不同。
在什么情况下需要提供:可选属性(除非当地法律法规要求提供)。
| 类型 | 整数 + 单位 |
| 文本 (TSV) | 100g |
| XML 示例 | <g:unit_pricing_base_measure>100g</g:unit_pricing_base_measure> |
门店自提属性(可选)
您可以在数据源中添加以下 2 个属性,以突出显示门店自提选项。对于在所有门店内的属性值均为“true”的商品,您可以在主要数据源中添加这些属性(例如,客户可在全国各地的任意门店自提 XYZ 电视)。
提货方法 [pickup_method] - 商品的门店自提选项
指明相关商品是否支持门店自提,以及提货选项是应显示为“购买”“预订”“店内取货”还是“不支持”。
- 购买
[buy]:整个交易都在线进行 - 预留
[reserve]:商品可在线预留,但交易需在实体店内完成 - 店内取货
[ship_to_store]:客户在线购买商品,并在商品运送到本地门店后到门店提货 - 不支持
[not_supported]:商品不支持门店自提
| 类型 | 文本(字符串)。只能从上面列出的指定值中选择一个。 |
| 文本 (TSV) | buy |
| XML 示例 | <g:pickup_method>buy</g:pickup_method> |
提货服务等级协议 (SLA) [pickup_SLA] - 商品的门店自提时间表
指明预计可提货的日期(相对于下单日期)。
- 当天
[same_day]:表示商品在下单当天即可提货,具体取决于截止时间。 - 次日
[next_day]:表示商品在下单次日即可提货。 - 2 天
[2-day]:表示商品将运送到门店,客户可以在 2 天后提货。 - 3 天
[3-day]:表示商品将运送到门店,客户可以在 3 天后自提。 - 4 天
[4-day]:表示商品将运送到门店,客户可以在 4 天后自提 - 5 天
[5-day]:表示商品将运送到门店,客户可以在 5 天后自提。 - 6 天
[6-day]:表示商品将运送到门店,客户可以在 6 天后自提。 - 7 天
[7-day]:表示商品将运送到门店,客户可以在 7 天后自提。 - 数周
[multi-week]:表示商品将运送到门店,客户需要等待超过一周才可自提。
| 类型 | 文本(字符串)。只能从上面列出的指定值中选择一个。 |
| 文本 (TSV) | same_day |
| XML 示例 | <g:pickup_sla>same day</g:pickup_sla> |
显示具体实体店库存状况和价格信息的商品页面属性(可选)
若要使用显示具体实体店库存状况和价格信息的商品页面,请将广告重定向 [ads_redirect] 属性和商家自管的本地店面页面的链接 [link_template] 属性添加到您的主要数据源。您还可以添加商家自管的本地店面页面的移动版链接 [mobile_link_template] 可选属性,以提供针对移动设备优化的商家自管的本地店面页面,并跟踪来自移动设备的点击。
链接 [link]
当客户点击您的广告或指定的非付费商品详情时,如果您的账号启用了显示实体店库存状况的商品页面功能,客户会被定向至商品在您网站上的着陆页。您可以通过链接 [link] 属性设置此着陆页的网址。
重要提示:
- 使用经过验证的域名。
- 以
http或https开头。 - 使用经过编码且符合 RFC 2396 或 RFC 1738 规范的网址。例如,英文逗号应表示为“%2C”。
- 除非法律有要求,否则请勿链接到插页。
| 类型 | 网址(必须以“http://”或“https://”开头) |
| 文本 (TSV) | http://mikemart.com/123 |
| XML | <g:link>http://mikemart.com/123</g:link> |
商家自管的本地店面页面的链接 [link_template]
当客户点击您的广告或非付费商品详情时,如果您的账号启用了显示具体实体店库存状况和价格信息的商品页面功能,客户会被定向至商品在您网站上的着陆页。您可以通过商家自管的本地店面页面的链接 [link_template] 属性设置此着陆页的网址。
重要提示:
- 添加商店代码 {
store_code} ValueTrack 参数。各个网站的网址结构会有所不同。实体店代码可以是网址参数,也可以是网址路径的一部分。 - 验证网站网址并声明所有权,还需确保在 Merchant Center 中注册的网站网址与链接模板中的网域相符。如果网站网址与注册网域不相符,请了解如何解决该问题。
- 仅在广告重定向
[ads_redirect]属性中添加网址衡量参数。
| 类型 | 网址(必须以“http://”或“https://”开头) |
| 文本 (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:link_template>http://mikemart.com/123?store={store_code}</g:link_template> |
商家自管的本地店面页面的移动版链接 [mobile_link_template]
当客户点击您的广告或非付费商品详情时,如果您的账号启用了显示具体实体店库存状况和价格信息的商品页面功能,客户会被定向至商品在您网站上的着陆页。
通过商家自管的本地店面页面的移动版链接 [mobile_link_template] 属性,您可以添加针对移动设备进行了优化的着陆页版本的网址。如果客户使用手机或平板电脑之类的移动设备,就会看到这个移动版本的着陆页。
重要提示:
- 添加商店代码 {
store_code} ValueTrack 参数。各个网站的网址结构会有所不同。实体店代码可以是网址参数,也可以是网址路径的一部分。 - 验证网站网址并声明所有权,还需确保在 Merchant Center 中注册的网站网址与商家自管的本地店面页面的链接
[link_template]属性中的网域相符。如果网站网址与注册网域不相符,请了解如何解决该问题。 - 仅在广告重定向
[ads_redirect]中添加网址衡量参数。
| 类型 | 网址(必须以“http://”或“https://”开头) |
| 文本 (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:mobile_link_template>http://mikemart.com/123?store={store_code}</g:mobile_link_template> |
广告重定向 [ads_redirect]
当客户点击您的广告时,如果您的账号启用了显示具体实体店库存状况和价格信息的商品页面功能,客户会被定向至商品在您网站上的着陆页。
使用广告重定向属性可以设置包含衡量参数的网址,有助于您更好地了解到达着陆页的流量。
重要提示:
- 添加商店代码 {
store_code} ValueTrack 参数。各个网站的网址结构会有所不同。实体店代码可以是网址参数,也可以是网址路径的一部分。 - 验证网站网址并声明所有权,还需确保在 Merchant Center 中注册的网站网址与链接模板中的网域相符。如果网站网址与注册网域不相符,请了解如何解决该问题。
- 在您设置此属性后,点击您广告的客户将被引导至广告重定向
[ads_redirect]属性中的位置,而不是您在商家自管的本地店面页面的链接[link_template]属性或商家自管的本地店面页面的移动版链接[mobile_link_template]属性中设置的位置。
| 类型 | 网址(必须以“http://”或“https://”开头) |
| 文本 (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:ads_redirect>http://mikemart.com/123?store={store_code}</g:ads_redirect> |
其他属性(可选)
您可以在主要数据源中为您的商品提供更多相关信息,以便展示更详细的广告或商品详情。如需了解所有可能出现的属性的信息,请参阅商品数据规范。