本文提供了在以 Atom 1.0 格式创建 XML 商品数据源时所需遵循的准则。我们将标准属性与官方 Atom 1.0 规范中的相应章节关联了起来,以便帮助您查找有关示例中各个组成部分的更多信息。虽然我们提供了 Atom 1.0 文件的示例,但对于 Atom 1.0 本身则仅仅提供了最基本的信息。
如果您想详细了解这种标准,建议您访问 Atom 供稿格式查看具体规范。
如需下载 Atom 1.0 示例文件,请点击此处。
第 1 节:Atom 1.0
根据 Atom 1.0 规范,在条目一级有五个预定义的元素,即标题 (title)、id、链接 (link)、摘要 (summary) 和更新时间 (updated)。这些元素虽然在 Atom 1.0 标准中是可选元素,但在商品数据源中却是必需元素。
商品数据源还要求使用其他元素,如价格和使用情况。为了添加更多商品详细信息,我们通过添加 Google Merchant Center 命名空间对 Atom 1.0 进行了扩展。通过指定 Google Merchant Center 命名空间,您可以使用更多元素(称为“属性”),并增加在商品数据源中提供的关于每件商品的信息量。
下面是基本 Atom 1.0 示例文档,其中包含一种商品:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>商品数据源的名称</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry>
<title>红色羊毛衫</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>这款毛衣舒适柔软,能让您在寒冷冬夜中倍感温暖。</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>
此示例中主要添加了两项内容,即命名空间声明和三个属性(图片链接 [image_link]、价格 [price] 和使用情况 [condition])。
Google Merchant Center 命名空间声明
必须进行以下命名空间声明,才能使用仅在 Google Merchant Center 命名空间中定义的属性。
xmlns:g="http://base.google.com/ns/1.0"
除了声明 Google Merchant Center 命名空间外,您还必须在每个属性标记中添加前缀。我们之所以要求在属性中添加这种前缀,目的是将命名空间中定义的属性与 Atom 1.0 中定义的元素区分开来。在此示例中,我们为命名空间声明选择的前缀是“g”:
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>
Google Merchant Center 命名空间中的属性必须包含这种前缀,否则属性和其中包含的值都会被忽略。
属性
您可以根据商品使用任意数量的相关属性。通过使用这些属性提供有关您商品的更多信息,可以大大提高您的商品出现在搜索结果中的机率。此外,Google Merchant Center 命名空间中所定义的许多属性都能在单一商品中多次使用。这样您就能在商品数据源中为商品添加更多可用信息。
第 2 节:重要检查事项清单
强烈建议您先按以下清单进行通检,然后再提交商品数据源,以确保文件格式正确:
文件名末尾必须使用 .xml 扩展名。
您在 Google Merchant Center 账号中注册的商品数据源文件名必须与您指定给文件的名称一致。
记得要添加命名空间声明。这些值应该与如下所示完全一致。
- Google Merchant Center 命名空间:
xmlns:g="http://base.google.com/ns/1.0". - 自定义属性命名空间:
xmlns:[前缀]="http://base.google.com/cns/1.0",其中 [前缀] 会替换为您在文件中添加的前缀。
验证添加到 Google Merchant Center 属性标记和自定义 Google Merchant Center 属性标记中的前缀是否都与命名空间声明中定义的前缀一致。
移除不含值的属性。
第 3 节:最后提示
本文中的示例经过简化,以便更加清楚地突出有关如何构建 Google Merchant Center XML 商品数据源的基础知识。虽然我们接受商品数据源中含有 Atom 1.0 标准指定的或您自己的命名空间中所指定的其他元素,但在处理过程中,这些元素所含的信息都会被系统忽略,因此不会出现在您的广告或非付费商品详情中。目前,我们仅会处理默认 Atom 1.0 元素所含的数据,以及 Google Merchant Center 和自定义 Google Merchant Center 命名空间中的属性所含的数据。