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 中共存。

产品示例

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

示例：

  <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&amp;product_category_id=79&amp;category_name=divan</url>
如何对 URL 中的字符编码？

文字符号

YML 文件代码

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

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 文件元素在整合效果广告系列中创建筛选条件。 它们不会影响创意的生成方式。 这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。 例如，针对电子商务，您可以根据产品的利润率设置筛选条件。

是

无

目录

在 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>httpss://example.ru/catalog/dukhi</url>
          <picture>httpss://example.ru/img/1.jpg</picture>
          <picture>httpss://example.ru/img/2.jpg</picture>
          <name>Мужские духи в интернет-магазине Example</name>
          <description>Мужские духи – подчеркните свой стиль </description>
        </collection>
        <collection id="kosmetika2">
          <url>httpss://example.ru/catalog/kosmetika</url>
          <picture>httpss://example.ru/img/3.jpg</picture>
          <picture>httpss://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 文件代码

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

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 来查看您的用户名。 我们的团队只有在处理您的请求时才能访问您的数据。

联系我们



在线课程

 
上一篇
Feed 文件要求
下一篇
产品销售，其他 Feed 文件