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>。

您还可以使用组合描述类型并使用简化类型和自定义类型中的元素。这样做的优点是您有更多的元素来生成相关广告。

简化类型	自定义类型	组合类型
`<name>`Smartphone Samsung Galaxy S22 Ultra 8/128 GB，blue`</name>`	`<typePrefix>`Smartphone`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 GB，blue`</model>`	`<name>`Smartphone Samsung Galaxy S22 Ultra 8/128 GB，blue`</name>` `<typePrefix>`Smartphone`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 GB，blue`</model>`

简化和自定义产品推荐可以在同一 Feed 中共存。

产品示例

简单描述

自定义描述 (vendor.model)

这是一种较为简单的基本类型描述。

示例：

  <offer id="0123456" available="true">
    <url>http://www.надежнаятехника.рф/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 Platinum Edition</name>
    <vendor>Eset</vendor>
    <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
    <description>Антивирус ESET NOD32 Platinum Edition - лицензия на 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>
  </offer>

此类描述实用而且适用范围广阔。建议您使用此类描述方式描述大多数类别的产品。

示例：

  <offer id="1234567" type="vendor.model" available="true">
    <url>http://www.надежнаятехника.рф/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>Принтер</typePrefix>
    <vendor>НP</vendor>
    <model>Deskjet D2663</model>
    <description>Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати...</description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Япония</country_of_origin>
  </offer>

<offer> 元素的属性

type 属性只能有一个值："vendor.model"，表示此产品是自定义的。

自定义类型：<offer id="1234567" type="vendor.model" available="true">
简化类型：<offer id="0123456" available="true">

type 属性确定上传 feed 时 Yandex Direct 机器人将检查哪些元素：

如果您不传递 type 属性，产品将被简化。机器人还会检查是否存在 <name> 元素。如果缺少，则产品会被忽略，不会生成产品广告。

如果您传递 type 属性，产品推荐将被自定义。请记得指定 <vendor> 和 <model> 元素。如果缺少，则会出现错误并且产品推荐会被忽略，这表示产品广告将不会启动。

属性	Description	可用于筛选器设置	必需元素。
`id`	产品 ID。每个产品的 ID 必须是唯一的。检查电子商务中的产品 `ID` 是否与 feed 中指定的`offer ID` 一致。这对于 YAN 中的动态式再营销展示是必要的。动态式再营销仅适用于在网站上推广产品。 `ID` 值可以由数字、字母或两者的组合构成。可能包含字符。最大长度：100 个字符。示例 18295 1223abc a12b34fq	是	是
`type`	产品描述类型。该值必须为 `vendor.model.` 如果您传递 `type` 属性，这表示您正在使用自定义描述类型。 Yandex Direct 会检查是否存在 `<vendor>` 和 `<model>` 元素。如果缺少，则产品会被忽略，不会生成产品广告。	无	针对自定义描述类型
`available`	产品存货信息： `true`：产品有货； `false`：产品缺货。默认情况下，Yandex Direct 假定 feed 中的所有产品都有现货。如果您的 feed 包含缺货商品，您需要为每个商品指定 `available` 属性。如此一来，生成广告时可以过滤掉产品。 Feed 中的产品供应信息应与着陆页和结账页面上的信息一致。	是	如果使用按产品存货筛选，则为必填项

<offer> 元素的子元素

元素

描述

可用于筛选器设置

必需元素。

名称

产品列表名称

建议简化产品的名称包括制造商的名称和代码，以及用户可能认为重要的关键产品特色。

要创建产品名称，您可以使用一个通用公式： WHAT + WHO + MODEL 和 MODIFICATION，其中：

“WHAT” 是产品的类别（类型）或子类别；
“WHO” 是制造商、品牌或商标；
“MODEL” 是产品名称、系列、集合或 SKU。
“MODIFICATION” 是关键产品特征。

为确保 Yandex Direct 正确创建广告，产品名称应与着陆页上的内容一致。

名称不应包含促销文字，例如“免运费”。您也不能使用全部大写或特殊字符来吸引用户注意。

示例

<name>Smartphone Samsung Galaxy S22 Ultra 8/128 GB，blue</name>
<name>NOW — B-50 vitamin complex, 100 capsules</name>
<name>Long fitted knit black strapless dress</name>
<name>Loft Yellow Sofa with convertible mechanism by Monolith Factory</name>

是

针对简化类型

typePrefix

产品类型/类别。

根据制造商的产品定位方式指定产品类型。例如，“手机”、“洗衣机”或“转角沙发”。避免使用过于宽泛的产品类型描述和模棱两可的词语。

示例

Adidas sneakers (VLNEO) V RACER NYLON

<typePrefix>Sneakers</typePrefix>
Smartphone Apple iPhone 15 Pro 1TB Natural Titanium

<typePrefix>Smartphone</typePrefix>

是

针对自由格式类型

vendor

制造商或品牌（商标）。提供正确的品牌名称是提供良好用户体验和促进销售的关键。

仅当您销售自有产品或其他制造商的非品牌产品时，才指定您自己的品牌。

示例

Adidas sneakers (VLNEO) V RACER NYLON

<vendor>Adidas</vendor>
Smartphone Apple iPhone 15 Pro 1TB Natural Titanium

<vendor>Apple</vendor>

是

针对自由格式类型

model

型号和关键参数（例如名称、型号索引、特殊改装功能等）。

示例

Adidas sneakers (VLNEO) V RACER NYLON

<model>(VLNEO) V RACER NYLON</model>
Smartphone Apple iPhone 15 Pro 1TB Natural Titanium

<model>iPhone 15 Pro 1TB Natural Titanium</model>

是

针对自由格式类型

categoryId

广告商指定的产品类别编号（不超过 18 个字符的正整数）。产品只能属于一个类别。

示例

<categoryId>12345</categoryId>

是

<offer> 元素只能包含一个 <categoryId> 元素。

url

用于宣传网站的产品页面 URL 或用于宣传移动应用的跟踪链接。如果您正在宣传移动应用，我们建议添加延迟深层链接。

最大链接长度：2048 个字符。您可以使用西里尔字母的链接。（我们建议使用 Punycode 转换西里尔字符的链接。） URL 格式遵循 RFC 3986 标准。

示例

<url>https://www.example.ru/myagkaya-mebel/loft-ellou/</url>
<url>https://www.example.ru/myagkaya-mebel/loft-ellou/?product_id=351354&product_category_id=79&category_name=divan</url>

如何对 URL 中的字符编码？

文字符号	YML 文件代码
`"`	`"`
`&`	`&`
`>`	`>`
`<`	`<`
`'`	`'`

URL 不得包含空格。将空格替换为 %20。

是

picture

图像链接。

我们建议向 feed 中添加五张图像。例如，从不同角度或不同内部展示的产品图像。产品应至少占据整个图像区域的 2/3。

在 Yandex 网盟中，单个产品横幅可以显示为旋转式横幅。如果格式仅支持一张图片，则会选择第一张图像，前提是其宽度和高度大于或等于广告单元的尺寸。如果第一张图像不符合这些要求，则会考虑投放下一张图像。

产品图像应具有白色背景，并带有至少一个像素的白色边框，不含文字和亮色字体。图像 URL 应包含 http 或 https 前缀。

技术要求：

像素尺寸：每边 450 或以上。
格式：JPG、PNG 或 GIF。
最大文件大小：10 MB。

如何更改广告中的图像？

要让 Yandex 机器人更新广告中的产品图像，请更改 feed 中的图像链接。例如：

当前图像的链接：<picture>https://ikea.ru/images/1.png</picture>
新图像的链接：<picture>https://ikea.ru/images/1-new.png</picture>

无

针对整合效果广告系列中的产品广告和目录页面广告。
针对产品廊中的展示。

description

产品推荐描述。

提供用户选择时所依据的重要产品特征的详细描述。

描述中不得包含“免运费”等促销文字，商店网站的链接，销售详情，或有关竞争对手或其他产品及其配件的信息。

示例

<description>A one-sided medium firmness mattress based on the EVS 500 independent springs block. Fillers: PU foam and latex coconut coir. 尺寸：90 x 195 厘米，高度：17 厘米。 Maximum weight per sleeping spot: 100 kg.</description>

是

无

sales_notes

订单信息：

最低订单价格、最少产品数量、必须预付款。
支付方式、促销活动和廉价销售的描述。

示例

<sales_notes>Cash, MIR, Visa/Mastercard, non-cash payment</sales_notes>
<sales_notes>Prepayment required</sales_notes>
<sales_notes>Up to 60% off</sales_notes>

无

param

指定产品特性和参数。

name 属性必须包含参数名称。

匹配查询时，Yandex Direct 会考虑以下四类 param 值：材质、颜色、性别和尺寸。如果您手动管理广告标题和文字，那么 param 值不会影响广告生成。如果您使用自动生成，则会根据产品元素生成多个文字结果，包括 param。

如果制造商使用自定义颜色名称（如mineral purple），您还应该提供该颜色的通用名称。

示例

颜色：

<param name="Цвет">gray</param>

<param name="Color">gray</param>
材料：

<param name="Материал">aluminium</param>

<param name="Material">titanium</param>
尺码（服装）：

<param name="Size" unit="INT">S</param>

<param name="Size" unit="RU">40</param>

传递尺码时，一定要注明尺码表：RU、EU、US、INT — 国际尺码名称（服装：XS、S、M、L、XL、XXL、2XL 等；胸罩：AA、A、B、C 等）。
尺寸：

<param name="Width" unit="cm">180</param>

<param name="Depth" unit="cm">70</param>

<param name="Height" unit="cm">90</param>

您可以使用宽度、深度、高度和直径传递产品尺寸。请务必指定测量单位：毫米、厘米或米。
性别：

<param name="Gender">female</param>

例如：

female, for women

male, for men

unisex, for men and women

无

price

这款产品的供应价格。

格式：整数或小数。

整数部分和小数部分之间的分隔符必须是圆点。

价格必须与网站上显示的产品价格一致，且不能为零。

建议在整合效果广告系列中使用该元素。

示例

<price>1234</price>
<price>1234.56</price>

是

针对产品廊中的展示

oldprice

产品原价，必须高于新价格 (price)。

格式：整数或小数。

整数部分和小数部分之间的分隔符必须是圆点。

价格不得为零。

您的网站应同时显示原价和新价格。

如果 feed 包含 price 和 oldprice 标签，您可以在广告中显示折扣，两者的差价幅度至少为 5%。

示例

<price>1620</price>

<oldprice>1800</oldprice>
我们不显示折扣金额，因为 price 和 oldprice 的差价幅度小于 5%：

<price>1760</price>

<oldprice>1800</oldprice>

是

无

currencyId

货币代码。

支持的值

RUR、RUB、USD、EUR、UAH、KZT、BYN、GBP、TRY、ALL、AFN、ARS、AWG、AUD、AZN、BBD、BZD、BMD、BOB、BAM、BWP、BGN、BRL、BND、KHR、CAD、KYD、CLP、CNY、COP、CRC、HRK、CUP、CZK、DKK、DOP、XCD、EGP、SVC、FKP、FJD、GHS、GIP、GTQ、GYD、HNL、HKD、HUF、ISK、INR、IDR、IRR、ILS、JMD、JPY、KPW、KRW、KGS、LAK、LBP、LRD、MKD、MYR、MUR、MXN、MNT、MAD、MZN、NAD、NPR、ANG、NZD、NIO、NGN、NOK、OMR、PKR、PAB、PYG、PEN、PHP、PLN、QAR、RON、SHP、SAR、RSD、SCR、SGD、SBD、SOS、ZAR、LKR、SEK、CHF、SRD、SYP、TWD、THB、TTD、AED、UYU、UZS、VEF、VND、YER、MDL、TJS、GEL、AMD、BHD、KWD。

无

如果存在 price 元素

video

产品视频链接。

备注

如果视频托管在使用 HTTP 协议的平台上，则不会在使用 HTTPS 协议的资源上投放该视频。

视频应使用稳定的摄像机拍摄。

内容推荐：

谈论您的产品而不是您的品牌。
避免过多的文字、插图和模糊。不要造成视频提供按钮或声音控制的错觉。
在视频的第一帧中展示您的产品及其优势。
为您的视频打上品牌：确保公司标志清晰可见。

为每个产品制作单独的视频：这将确保它们与您的广告标题和文字相匹配。每个产品只能有一个视频。

仅在 YAN 中展示。

示例

<video>http://example.ru/catalog/video/19/6.MP4</video>

无

vendorCode

产品代码（输入供应商代码）。

示例

<vendorCode>A4068LM-12SG</vendorCode>

无

market_category

产品类别。

是

无

store

产品在零售商店出售：

yes、1、+、true — 本产品在商店有售。
no、0、−、false — 本产品在商店暂无销售。

是

无

皮卡车

客户从交货地点取货：

yes、1、+、true — 本产品支持自提。
no、0、−、false — 本产品不支持自提。

是

无

delivery

快递送货：

yes、1、+、true — 支持快递送货；
no、0、−、false — 不支持快递送货。

无

manufacturer_warranty

官方保修：

yes、1、+、true — 本产品享有官方质保。
no、0、−、false — 本产品没有官方质保。

是

无

country_of_origin

原产国。

示例

<country_of_origin>Russia</country_of_origin>
<country_of_origin>Belarus</country_of_origin>
<country_of_origin>Vietnam</country_of_origin>

无

年龄

产品年限类别。

带或不带+前缀的非负整数。如果使用+，请确保将其放在数字前。

如果产品面向特定年龄段的群体，我们建议指定此元素。

示例

<age>+6</age>
<age>18</age>

是

无

adult

此产品属于 “adult” 类别：

是, 1, +, true —— 是。
否, 0, −, false —— 否。

是

无

downloadable

产品下载：

yes、1、+、true — 本产品可供下载。
no、0、−、false — 本产品不可下载。

无

collectionId

要以组合格式（目录页广告和产品广告）投放广告，请将产品链接传递到目录。该值等于 <collections> 元素中的 <collection id>。

该值可以包含数字、字母或两者的组合。

一个 <offer> 可以包含多个 <collectionIds>。

是

如果 feed 有 <collections>，则推荐。

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

自定义元素。自由格式描述。拉丁文和西里尔文字符和数字。一个元素的最大长度为 175 个字符。

您只能使用自定义 feed 文件元素在整合效果广告系列中创建筛选条件。它们不会影响创意的生成方式。这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。例如，针对电子商务，您可以根据产品是否属于某个促销活动来设置筛选条件。

是

无

custom_score

自定义元素。值：0 或任何正整数。

您只能使用自定义 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>Мужские духи в интернет-магазине Example</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>Косметика для бритья в интернет-магазине Example</name>
          <description>Косметика для бритья: приятный ежедневный уход</description>
        </collection>
      </collections>

    </shop>
  </yml_catalog>

<collections> 元素的子元素

元素

描述

必需元素。

collection id

唯一的目录 ID。最大长度：60 个字符。值可以是数字、字母或字母数字。

每个目录的 ID 必须是唯一的。

是

url

目录页面 URL。

最大链接长度：2048 个字符。您可以使用西里尔字母的链接。（我们建议使用 Punycode 转换西里尔字符的链接。） URL 格式遵循 RFC 3986 标准。

URL 必须指定 http 或 https 协议。

如何对 URL 中的字符编码？

文字符号	YML 文件代码
`"`	`"`
`&`	`&`
`>`	`>`
`<`	`<`
`'`	`'`

URL 不得包含空格。将空格替换为 %20。

是

picture

图像链接。

您可以添加多个图像链接，每个链接都位于自己的 picture 元素。

如何更改广告中的图像？

要让 Yandex 机器人更新广告中的目录图像，请更改 feed 中的图像链接。例如：

当前图像的链接 — <picture>https://ikea.ru/images/1.png</picture>
新图像的链接 — <picture>https://ikea.ru/images/1-new.png</picture>

用于 Yandex 网盟和产品廊中的展示。

名称

目录名称。

是

description

目录描述。

无

1C-Bitrix 用户可以按照说明快速生成包含目录页面的 feed 文件。

如果您使用 InSales 平台并设置了自动 feed 文件更新，目录信息将自动添加到其中， — 无需您执行任何其他操作。您还可以按照说明使用自定义导出到 Yandex Market 来创建包含目录的 feed 文件。

有问题吗？

注意

我们的客服部门只能就您提供的账户名里的广告系列提供咨询。您可以通过在另一个浏览器标签页中打开 ya.ru 来查看您的用户名。我们的团队只有在处理您的请求时才能访问您的数据。

联系我们

聊天

YML feed 要求

商品列表

目录

有问题吗？

有用链接

法律文件

在线课程

了解更多

这篇文章是否有用？