撰写 Google 可接受的 product_detail 与 product_highlight 值（附 Feed 实例行）

根据 Google 官方的商品详情和商品亮点规范，Google 的 product_detail 属性每件商品最多可填 100 条，每条 1 至 150 个字符；product_highlight 要求每件商品至少 2 条，并建议提供 4 至 6 条简短的卖点说明。这两个属性都是可选的，所以大多数 feed 会直接跳过，或者粘贴一张规格表，结果被 Merchant Center 标记为格式错误。

Google 表示，product_detail 有助于商品在 AI Mode 等 AI 界面中展示；2026 年 5 月，Google 又基于同一思路新增了更多对话式属性。

本参考文档面向向 Google Merchant Center 提交商品数据的 feed 管理人员和代理商。读完后，您将能够用 TSV 和 XML 两种格式撰写这两个属性，对会导致解析出错的字符进行转义，避开被禁止的内容，并在提交前为每一行打分。

product_detail 和 product_highlight 的用途

这两个属性看起来相似，也常常取自同一数据源，但 Google 赋予它们不同的职责。product_detail 承载其他属性未涵盖的、可验证的技术规格：包装内容、连接方式、成分、电源要求、表面处理、气味等事实信息。product_highlight 则承载以平实语句写成的简短卖点。

我们的快速判断方法是：如果这一行适合放进“标签 + 值”的规格表，就是 product_detail；如果读起来像店员会说的一句话，就是 product_highlight。Google 的亮点规范同样作了这种区分，并要求不要在一个属性中重复另一个属性的内容。

规范一览

以下是 Google 目前公布的限制。Google 没有为 product_detail 列出任何 schema.org 属性，因此它不会从您的结构化数据标记中获取，必须放在 feed 里。

项目	product_detail	product_highlight
状态	可选	可选
结构	由三个子属性组成的组：section_name（可选，建议填写）、attribute_name（必填）、attribute_value（必填）	单个字符串
长度	每条详情 1 至 150 个字符	每条亮点 1 至 150 个字符
数量	每件商品最多 100 条	最少 2 条，最多 100 条，建议 4 至 6 条
字符集	允许 Unicode，建议使用 ASCII	允许 Unicode，建议使用 ASCII
文本 feed 格式	建议使用 TSV；子属性之间用冒号分隔，多条详情之间用逗号分隔	建议使用 TSV；多条亮点之间用逗号分隔
语言	在每种语言的 feed 中对分区、名称和值进行本地化	大部分文本必须与 feed 语言一致

来源：Google Merchant Center 帮助，Product detail [product_detail] 和 Product highlight [product_highlight]。

如何用 TSV、XML 和 Merchant API 撰写 product_detail

大多数行都栽在格式上。每条详情由三个值组成，用两个冒号连接，顺序为分区名称、属性名称、属性值。Google 明确指出，在文本 feed 中每条详情都必须包含两个冒号；如果提供的子属性数量与表头声明的不一致，就会在“Needs attention”下产生“子属性格式无效”的问题。

TSV 表头与单个单元格

在列标题中用括号声明子属性，并以冒号分隔。表头中一旦指明了子属性，值就可以按您声明的顺序排列。如果没有声明，Google 会默认按分区、名称、值的顺序处理。

product_detail(section_name:attribute_name:attribute_value)

包含三条详情的单元格如下所示：

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

如果某条详情没有分区，请保留开头的冒号，并将第一个字段留空：

:What's in the box?:"Machine,Measuring spoon,User manual"

转义冒号、逗号和引号

Google 的带引号属性规则适用于此类组属性：

• 任何包含逗号或冒号的子属性值，都要用英文直双引号括起来。引用的是单个值，而不是整个组。
• 字面的双引号要写成两个双引号。Google 自己的示例是 "APS-C max. 12"""，表示以英寸符号结尾的值。
• 不要使用反斜杠转义。Google 会把反斜杠当作普通字符读取。
• Google 表格数据源不支持带引号的字段。对于已有的文件数据源，需要在数据源设置中开启带引号字段。

XML

在 XML 中，每条详情都是一个独立元素，包含三个子元素，因此无需对冒号或逗号进行转义：

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

对于规格繁多的品类，XML 是更稳妥的格式，因为自然出现的逗号和冒号不再构成解析风险。

Merchant API

通过 Merchant API 提交时，每条详情是一个 ProductDetail 对象，包含 sectionName、attributeName 和 attributeValue 字段，详见 API 客户端参考。

如何撰写 product_highlight

亮点更简单：每条亮点就是一个字符串。在文本 feed 中，用逗号分隔各条亮点，任何包含逗号或冒号的亮点都要用双引号括起来。在 XML 中，让每条亮点使用各自的 <g:product_highlight> 元素。

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

每条只写一个卖点。Google 要求使用专业、语法正确的语言，不要用全大写强调，不要使用符号，也不要出现促销性措辞。

两个属性中 Google 都不允许的内容

格式错误会产生明显的报错，而内容错误则更隐蔽：一行数据可能被接受，却仍然违反政策。下表汇总了两份规范中的禁止事项。

请勿包含	适用于	应改用
价格、促销价、促销日期	两者	price、sale_price 及相关属性
运费、送达日期或其他与时间相关的信息	两者	shipping 及相关属性
贵公司名称	两者	不用替代，直接省略
关键词或搜索词	两者	仅限真实的规格或卖点
未经确认的值，例如默认的“False”	product_detail	省略该条详情
类目路径	product_highlight	google_product_category、product_type
店铺或网站链接	product_highlight	link
与其他商品、配件或兼容商品的比较	product_highlight	只描述商品本身
与标题、描述、question_and_answer 或另一属性重复的文字	两者	每个事实只放在一处

Google 还有一条容易被忽略的规则：如果您提交的 document_link 文件中已包含相同的信息，就不要再把这些信息写进这些属性，让 Google 从文档中自行提取。

实例：把规格表变成可通过的行

下面是某家店铺的一行典型数据，该店铺把商品规格导出为一个自由文本字段。商品是一台电动土耳其咖啡机；该店铺在土耳其销售，并以英语面向海湾市场销售。

修改前

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

一个单元格里有五个问题。分隔符混用，冒号数量与表头不匹配。“Stainless Steel, Plastic”没有加引号，其中的逗号把这条详情拆开了。Brand 与 brand 属性重复。“FREE SHIPPING”是全大写的运费文字。最后一段是关键词串。

修改后，英文 feed

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

品牌移到了自己的属性中，运费移到了 shipping，关键词已删除，值采用 Google 建议的句首大写形式，所有含逗号的值都加了引号。“Automatic shut-off: Yes”得以保留，因为制造商已确认这一点；如果某个字段是您的平台默认填为“No”的，就不应保留。

修改后，土耳其语 feed

Google 要求在每种语言的 feed 中对分区名称、属性名称和值进行本地化，所以土耳其语 feed 要使用自己的行，而不是英文那一行：

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

针对土耳其以外团队的两点地区性提示。第一，请保留土耳其语字母。Google 推荐 ASCII 只是一种偏好而非硬性要求，其亮点规范也明确允许带重音符号的字母；把“Paslanmaz çelik”音译成“Paslanmaz celik”会造成拼写错误，这与 Google 的语法和拼写指引相冲突。第二，如果某条规则会把这些值转为小写或句首大写，它需要支持区域感知的大小写转换，避免“İ”和“I”变成错误的字母，这个问题我们在土耳其语标题大小写指南中讲过。

如何从您的商品目录构建这些值

我们按以下顺序分四步填写这些属性。

1. 先映射结构化数据源。列出您的平台已经以“标签 + 值”形式存储的所有规格，例如规格标签页、metafield 或 ERP 属性。每一对生成一条 product_detail，并把来源分组作为 section_name。使用 feed rules 或补充 feed 之类的 feed 层，让源商品目录保持不变，同时使 Google 的输出可以不同于其他渠道。
2. 移除其他属性已涵盖的内容。如果品牌、颜色、尺寸、材质、价格和运费已在各自专属的属性中，就把这些行删掉。然后删除文字已出现在标题或描述中的任何详情。
3. 手写亮点，或使用经过审核的 AI 草稿。亮点是 AI 丰富化最有帮助、也最容易出错的地方。模型很乐意写出“Ideal gift for coffee lovers”这类促销性语句，或者编造商品并不具备的功能。只能根据已确认的规格生成草稿，并对照上面的禁止事项表进行审核。
4. 导出前验证长度和语法。检查每条详情和每条亮点是否不超过 150 个字符，每条详情是否恰好有两个未加引号的冒号，以及每件商品的亮点数量是否至少为 2。

提交前运行的评分标准

每个品类抽取 20 行进行评分。每项检查通过记 1 分，不通过记 0 分，每行满分 10 分。我们认为 9 或 10 分为可以提交，7 或 8 分为修正后再提交，更低则说明源数据需要先改进，这些属性才值得发送。

#	检查项	通过条件
1	冒号数量	每条详情恰好有两个未加引号的冒号
2	引号	每个包含逗号或冒号的值都加了引号；内部引号写成双引号
3	长度	每条详情和亮点均为 1 至 150 个字符
4	亮点数量	2 至 100 条亮点，理想为 4 至 6 条
5	无商业数据	没有价格、促销、运费、送达或日期文字
6	无重复	没有与标题、描述、品牌或另一属性重复的事实
7	仅限已确认的值	没有平台默认值或猜测值
8	无关键词	没有搜索词串或堆砌的同义词
9	语言	分区、名称和值与 feed 语言一致
10	大小写	句首大写，无全大写强调，当地字母正确

本指南的局限

我们不清楚这些属性对排名或点击率的影响有多大。Google 表示 product_detail 有助于商品在相关查询中展示，包括在 AI Mode 中，但并未公布任何数据，我们也没有看到公开的对照研究。在供应商给出的百分比附带方法说明之前，请对其保持怀疑。

本文是一份 Google 参考文档。OpenAI 的商品 feed 规范没有通用的键值规格字段，也没有亮点字段；它使用 material、dimensions 和 weight 等扁平字段，外加 5,000 个字符的描述。如果您也向其发送 feed，就必须把规格映射到这些字段或描述中。本指南没有核实 Meta 或 TikTok 的对应做法。

文中也没有涉及较新的对话式属性，例如 question_and_answer 和 document_link，上文关于内容重叠的规则除外。包括 Channable 和 Productsup 在内的几家 feed 供应商比我们更早发布了这些属性的映射指南，如果您现在就需要这套属性，值得一读。

最后，如果您的商品目录没有结构化规格，这种方法无法凭空创造它们；而在没有确认来源的情况下生成 AI 草稿，正是 Google“只提交已确认的值”这一规则要阻止的。

常见问题

Google Merchant Center 中 product_detail 是必填项吗？

不是。Google 将其列为对所有商品都可选。如果您掌握了其他属性无法涵盖的经过验证的规格，值得添加，因为 Google 表示它有助于商品在相关查询中展示，包括在 AI Mode 中。

应该提交多少条商品亮点？

Google 要求至少 2 条，最多允许 100 条，并建议每件商品 4 至 6 条。每条亮点最多可达 150 个字符。

为什么 Merchant Center 提示我的 product_detail 子属性格式无效？

值中的子属性数量与表头不一致，通常是因为某条详情缺少冒号，或者值内未加引号的逗号或冒号把它拆开了。请为包含这些字符的值加上引号，并保证每条详情有两个冒号。

土耳其语 feed 中应该使用土耳其语字符吗？

应该。Google 接受 Unicode，仅将 ASCII 作为一种偏好来推荐，而其亮点指引允许带重音符号的字母，并要求拼写正确。去掉土耳其语字母会造成拼写错误的单词。

可以让 AI 撰写商品亮点吗？

可以让它起草，但只能基于您已确认的规格，并且每份草稿都应检查是否有促销措辞、比较和编造的功能。Google 禁止在亮点中使用前两者，而编造的功能就是虚假的商品数据。

Google 表格支持带引号的 product_detail 值吗？

不支持。Google 的带引号属性指引指出，Google 表格数据源不支持带引号的字段，因此包含逗号或冒号的规格值最好通过 TSV 文件、XML 或 Merchant API 发送。

添加这些属性前，先检查您的 feed

只有当这些属性所依托的字段干净无误时，它们才会有帮助。在开始撰写详情和亮点之前，请用免费商品 feed 审核工具检查您的 feed，查看每件商品在完整性、质量和技术方面的问题。