YML feed 要求
商品列表
产品 Feed 的一般要求:
-
每个产品必须拥有唯一的 ID。
-
同一产品在不同 feed 中的 ID 必须相同,即使 feed 的类型不同。 例如,相同的产品在您的 Yandex Market 和 Google Shopping feed 中应具有相同的 ID。
<offers> 元素指定产品列表。 在单独的 <offer> 元素中描述每款产品。 将 <shop> 元素中的 <currencies> 和 <categories> 元素添加到产品推荐列表之前。 要了解 <shop> 中包含的元素的更多信息,请参见 Yandex Market 帮助。
产品描述类型
产品描述有两种类型:简化和自定义。 这些描述类型仅在传递产品名称的方式上有所不同:
- 在简化产品中,产品名称在单个
<name>元素中传递。 - 在自定义产品中, 产品名称在以下三个元素中传递:
<typePrefix>、<vendor>和<model>。
您还可以使用组合描述类型并使用简化类型和自定义类型中的元素。 这样做的优点是您有更多的元素来生成相关广告。
|
简化类型 |
自定义类型 |
组合类型 |
|
|
|
简化和自定义产品推荐可以在同一 feed 中共存。
产品示例
这是一种较为简单的基本类型描述。
示例:
<offer id="0123456" available="true">
<url>http://www.worldsbestpcs.com/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc</url>
<price>1620.00</price>
<oldprice>1800.00</oldprice>
<currencyId>RUB</currencyId>
<categoryId>19</categoryId>
<picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>
<picture>http://89.123.45.678/catalog/photo/19/7.JPG</picture>
<store>false</store>
<pickup>true</pickup>
<delivery>false</delivery>
<name>ESET NOD32 杀毒软件白金版</name>
<vendor>Eset</vendor>
<vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
<description>ESET NOD32 杀毒软件白金版 — 2 年许可 — NOD32-ENA-NS(BOX)-2-1</description>
<video>http://89.123.45.678/catalog/video/19/6.MP4</video>
<sales_notes>可通过现金、银行转账、信用卡或借记卡支付,或申请分期付款</sales_notes>
<manufacturer_warranty>true</manufacturer_warranty>
<country_of_origin>俄罗斯</country_of_origin>
<age unit="year">18</age>
<property name="Operating system">Windows</property>
</offer>
此类描述实用而且适用范围广阔。 建议您使用此类描述方式描述大多数类别的产品。
示例:
<offer id="1234567" type="vendor.model" available="true">
<url>http://www.worldsbestpcs.com/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc</url>
<price>889.00</price>
<oldprice>17000.00</oldprice>
<currencyId>RUR</currencyId>
<categoryId>1111</categoryId>
<picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>
<picture>http://89.123.45.678/catalog/photo/19/7.JPG</picture>
<store>false</store>
<pickup>false</pickup>
<delivery>true</delivery>
<typePrefix>Printer</typePrefix>
<vendor>HP</vendor>
<model>Deskjet D2663</model>
<description>Explore a series of reliable, easy-to-use color printers designed for everyday printing needs...</description>
<sales_notes>Online payment.</sales_notes>
<manufacturer_warranty>true</manufacturer_warranty>
<country_of_origin>Japan</country_of_origin>
<property name="Paper size">A4, A5</property>
</offer>
<offer> 元素的属性
type 属性只能有一个值:"vendor.model",表示此产品是自定义的。
- 自定义类型:
<offer id="1234567" type="vendor.model" available="true"> - 简化类型:
<offer id="0123456" available="true">
类型 属性确定上传 feed 时 Yandex Direct 机器人将检查哪些元素:
-
如果您不传递
type属性,产品将被简化。 机器人还会检查是否存在<name>元素。 如果缺少,则产品会被忽略,不会生成产品广告。 -
如果您传递
type属性,产品推荐将被自定义。 请记得指定<vendor>和<model>元素。 如果缺少这些元素,则会出现错误,产品将被忽略,且不会生成广告。属性
描述
可用于筛选器设置
必需元素。
id产品 ID。
每个产品的 ID 必须是唯一的。
请检查电商产品
ID是否与信息库中指定的优惠 ID匹配。 这对于 YAN 中的动态再营销展示很有必要。 动态再营销仅适用于从网站推广产品。ID值可以由数字、字母或两者的组合构成。 可能包含字符。 最大长度为 100 个字符。提示
如果您计划设置筛选条件,请只使用数字
ID值。示例
- 18295
- 1223abc
- a12b34fq
是
是
type产品描述类型。
该值必须为
vendor.model.如果您传递
type属性,这表示您正在使用自定义描述类型。 Yandex Direct 会检查是否存在<vendor>和<model>元素。 如果缺少,则产品会被忽略,不会生成产品广告。无
针对自定义描述类型
available产品存货信息:
true:产品有货;false:产品缺货。默认情况下,Yandex Direct 假定 feed 中的所有产品都有现货。 如果您的 feed 包含缺货商品,您需要为每个商品指定
available属性。 如此一来,生成广告时可以过滤掉产品。Feed 中的产品供应信息应与着陆页和结账页面上的信息一致。
是
如果使用按产品存货筛选,则为必填项
<offer> 元素的子元素
|
元素 |
描述 |
可用于筛选器设置 |
必需元素。 |
||||||||||||
|
|
产品列表名称 建议简化产品的名称包括制造商的名称和代码,以及用户可能认为重要的关键产品特色。 要创建产品名称,您可以使用一个通用公式:
为确保 Yandex Direct 正确创建广告,产品名称应与着陆页上的内容一致。 名称不应包含促销文字,例如“免运费”。 您也不能使用全部大写或特殊字符来吸引用户注意。 示例
|
是 |
针对简化类型 |
||||||||||||
|
|
产品类型/类别。 根据制造商的产品定位方式指定产品类型。 例如,“手机”、“洗衣机”或“转角沙发”。 避免使用过于宽泛的产品类型描述和模棱两可的词语。 示例
|
是 |
针对自由格式类型 |
||||||||||||
|
|
制造商或品牌(商标)。 提供正确的品牌名称是提供良好用户体验和促进销售的关键。 仅当您销售自有产品或其他制造商的非品牌产品时,才指定您自己的品牌。 示例
|
是 |
针对自由格式类型 |
||||||||||||
|
|
型号和关键参数(例如名称、型号索引、特殊改装功能等)。 示例
|
是 |
针对自由格式类型 |
||||||||||||
|
|
用户指定的产品类别编号(不超过 18 个字符的正整数)。 产品只能属于一个类别。 示例
|
是 |
是
|
||||||||||||
|
|
网站推广的产品页面网址。 最大链接长度:2048 个字符。 您可以使用西里尔字母的链接。 (我们建议使用 Punycode 转换西里尔字符的链接。) URL 格式遵循 RFC 3986 标准。 示例
如何对 URL 中的字符编码?
URL 不得包含空格。 将空格替换为 |
是 |
是 |
||||||||||||
|
|
图像链接。 我们建议向 feed 中添加五张图像。 例如,从不同角度或不同内部展示的产品图像。 产品应至少占据整个图像区域的 2/3。 在 Yandex 网盟中,单个产品横幅可以显示为旋转式横幅。 对于仅支持一张图片的格式,如果第一张图片的宽度和高度大于或等于广告单元的宽度和高度,则使用该图片。 如果第一张图像不符合这些要求,则会考虑投放下一张图像。 产品图像应具有白色背景,并带有至少一个像素的白色边框,不含文字和亮色字体。
图像 URL 应包含 技术要求:
如何更改广告中的图像?要让 Yandex 机器人更新广告中的产品图片,请在信息流中更改其链接。 例如:
|
无 |
|
||||||||||||
|
|
产品推荐描述。 提供用户选择时所依据的重要产品特征的详细描述。 描述中不得包含“免运费”等促销文字,商店网站的链接,销售详情,或有关竞争对手或其他产品及其配件的信息。 示例
|
是 |
无 |
||||||||||||
|
|
订单信息:
示例
|
无 |
无 |
||||||||||||
|
|
指定产品特性和参数。
进行匹配查询时,Yandex Direct 会考虑以下四种类型的 如果制造商使用自定义颜色名称——例如, 示例
|
无 |
无 |
||||||||||||
|
|
这款产品的供应价格。 格式:整数或小数。 整数部分和小数部分之间的分隔符必须是圆点。 价格必须与网站上显示的产品价格一致,且不能为零。 建议在整合效果广告系列中使用该元素。 示例
|
是 |
针对产品廊中的展示 |
||||||||||||
|
|
产品原价,必须高于新价格 ( 格式:整数或小数。 整数部分和小数部分之间的分隔符必须是圆点。 价格不得为零。 您的网站应同时显示原价和新价格。 如果 feed 包含 示例
|
是 |
无 |
||||||||||||
|
|
货币代码。 支持的值
|
无 |
如果存在 |
||||||||||||
|
|
产品视频链接。 备注 如果视频托管在使用 HTTP 协议的平台上,则不会在使用 HTTPS 协议的资源上投放该视频。 视频应使用稳定的摄像机拍摄。 内容推荐:
为每个产品制作单独的视频:这将确保它们与您的广告标题和文字相匹配。 每个产品只能有一个视频。 仅在 YAN 中展示。 示例
|
无 |
无 |
||||||||||||
|
|
产品代码(输入供应商代码)。 示例
|
无 |
无 |
||||||||||||
|
|
产品类别。 |
是 |
无 |
||||||||||||
|
|
产品在零售商店出售:
|
是 |
无 |
||||||||||||
|
|
客户从交货地点取货:
|
是 |
无 |
||||||||||||
|
|
快递送货:
|
无 |
无 |
||||||||||||
|
|
官方保修:
|
是 |
无 |
||||||||||||
|
|
原产国。 示例
|
无 |
无 |
||||||||||||
|
|
产品年限类别。 带或不带+前缀的非负整数。 如果使用+,请确保将其放在数字前。 如果产品面向特定年龄段的群体,我们建议指定此元素。 示例
|
是 |
无 |
||||||||||||
|
|
此产品属于 “adult” 类别:
|
是 |
无 |
||||||||||||
|
|
产品下载:
|
无 |
无 |
||||||||||||
|
|
要以组合格式(产品广告中的产品和目录页面广告)投放广告,请传递产品与目录之间的链接。 该值等于 该值可以包含数字、字母或两者的组合。 一个 |
是 |
如果 feed 有 |
||||||||||||
|
自定义元素。 自由格式描述。 拉丁文和西里尔文字符和数字。 元素长度最多为 175 个字符。 您只能使用自定义 feed 文件元素在整合效果广告系列中创建筛选条件。 它们不会影响创意的生成方式。 这些筛选条建用于按特定参数细分产品,没有可用的标准筛选条件。 例如,针对电子商务,您可以根据产品是否属于某个促销活动来设置筛选条件。 |
是 |
无 |
||||||||||||
|
|
自定义元素。 值:0 或任何正整数。 您只能使用自定义 feed 文件元素在整合效果广告系列中创建筛选条件。 它们不会影响创意的生成方式。 这些筛选条建用于按特定参数细分产品,没有可用的标准筛选条件。 例如,针对电子商务,您可以根据产品的利润率设置筛选条件。 |
是 |
无 |
||||||||||||
|
|
产品规格,例如电视屏幕尺寸、服装颜色和支付条款。 您最多可以添加 10 个规格。 列出产品规格时,请突出显示有助于客户做出购买决策的细节。 规格信息仅在我们的系统预测其有助于提高广告点击率并最终促成转化时才会显示在产品图库广告中。 您的广告可能包含来自信息库的规格、来自网站的详情,或来自其他网店匹配产品的数据。 了解关于产品规格的更多信息。 示例
|
无 |
无 |
目录
在 YML feed 中,您可以传递有关产品目录的信息。 在树形结构中,<collections> 元素位于 <offers> 元素之后。
整合效果广告系列仅使用目录信息来推广网站。 如果您推广的是移动应用,则不会产生任何展示。
产品销售 feed 文件示例:
<?xml version="1.0" encoding="utf-8"?>
<yml_catalog>
<shop>
<categories> ... </categories>
<offers>
<offer>...
<collectionId>dukhi1</collectionId>
<collectionId>kosmetika2</collectionId>
</offer>
<offer> ... </offer>
</offers>
<collections>
<collection id="dukhi1">
<url>https://example.ru/catalog/dukhi</url>
<picture>https://example.ru/img/1.jpg</picture>
<picture>https://example.ru/img/2.jpg</picture>
<name>男士古龙水与香水在线示例</name>
<description>用标志性香氛提升您的风格</description>
</collection>
<collection id="kosmetika2">
<url>https://example.ru/catalog/kosmetika</url>
<picture>https://example.ru/img/3.jpg</picture>
<picture>https://example.ru/img/4.jpg</picture>
<name>剃须产品在线示例</name>
<description>用高端护理提升您的日常剃须体验</description>
</collection>
</collections>
</shop>
</yml_catalog>
<collections> 元素的子元素
|
元素 |
描述 |
必需元素。 |
||||||||||||
|
|
唯一的目录 ID。 最大长度:60 个字符。 值可以是数字、字母或字母数字。 每个目录的 ID 必须是唯一的。 |
是 |
||||||||||||
|
|
目录页面 URL。 最大链接长度:2048 个字符。 您可以使用西里尔字母的链接。 (我们建议使用 Punycode 转换西里尔字符的链接。) URL 格式遵循 RFC 3986 标准。 URL 必须指定 如何对 URL 中的字符编码?
URL 不得包含空格。 将空格替换为 |
是 |
||||||||||||
|
|
图像链接。 您可以添加多个图像链接,每个链接都位于自己的 picture 元素。 如何更改广告中的图像?要让 Yandex 机器人更新广告中的目录图像,请更改 feed 文件中的链接。 例如:
|
用于 Yandex 网盟和产品廊中的展示。 |
||||||||||||
|
|
目录名称。 |
是 |
||||||||||||
|
|
目录描述。 |
无 |
1C-Bitrix 用户可按照说明快速生成包含目录页的信息流。
如果您使用 InSales 平台并设置自动更新信息流,目录信息将自动添加到信息流中,无需您进行额外操作。 您也可以按照说明使用自定义导出到 Yandex Market 的方式创建包含目录的信息库。
如果您使用的是 HostCMS,可以按照该指南启用包含目录页面的信息库导出功能。 详情请参阅产品系列。
教育
准备一个包含在线课程和课件信息的 YML 格式的信息库。
通过此信息流创建产品广告时,广告标题将自动生成,广告文本则从广告设置中指定的默认文本字段提取。
该信息流包含产品以及每个产品所属的类别。 使用集合组合多个产品。
有关信息库的所有要求,请参阅 Yandex Webmaster 帮助。
卫生保健
准备一个包含医疗服务信息的 YML 格式的信息库。
通过此信息流创建产品广告时,广告标题将自动生成,广告文本则从广告设置中指定的默认文本字段提取。
信息流包含产品,您可以在其中传递有关医生、诊所和服务的数据。
有关信息库的所有要求,请参阅 Yandex Webmaster 帮助。
有问题吗?
注意
我们的客服只能协助您处理与您联系我们时使用的用户名关联的广告系列。 您可以通过在另一个浏览器标签页中打开 ya.ru 来查看您的用户名。 我们的团队只有在处理您的请求时才能访问您的数据。
扫描或轻触二维码即可访问链接。