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.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> 元素的子元素

元素

描述

可用于筛选器设置

必需元素。

名称

产品列表名称

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

要创建产品名称,您可以使用一个通用公式: 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

网站推广的产品页面网址。

最大链接长度: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 文件代码

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

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

是

是

picture

图像链接。

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

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

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

技术要求:

  • 像素尺寸:每边 450 或以上。
  • 格式:JPG、PNG、WEBP 或 GIF。
  • 最大文件大小:10 MB。
如何更改广告中的图像?

要让 Yandex 机器人更新广告中的产品图片,请在信息流中更改其链接。 例如:

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

无

  • 对于统一效果广告系列中的产品广告。
  • 针对产品廊中的展示。

description

产品推荐描述。

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

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

示例

<Description>单面中等硬度床垫,内置 EVS 500 独立弹簧块。填充物:PU 泡沫和乳胶椰壳纤维。尺寸:90×195 厘米,高度:17 厘米。每个床位的最大承重:100 千克。</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。

如果制造商使用自定义颜色名称——例如,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>1760</price>
  • <price>1760</price>

是

针对产品廊中的展示

oldprice

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

格式:整数或小数。

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

价格不得为零。

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

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

示例
  • <price>1760</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_0
  • custom_label_0
  • custom_label_0
  • custom_label_0

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

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

是

无

custom_score

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

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

是

无

Property name

产品规格,例如电视屏幕尺寸、服装颜色和支付条款。 您最多可以添加 10 个规格。

列出产品规格时,请突出显示有助于客户做出购买决策的细节。

规格信息仅在我们的系统预测其有助于提高广告点击率并最终促成转化时才会显示在产品图库广告中。 您的广告可能包含来自信息库的规格、来自网站的详情,或来自其他网店匹配产品的数据。 了解关于产品规格的更多信息。

示例

<property name="Control type">touch</property>

无

无

目录

在 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> 元素的子元素

元素

描述

必需元素。

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 用户可按照说明快速生成包含目录页的信息流。

如果您使用 InSales 平台并设置自动更新信息流,目录信息将自动添加到信息流中,无需您进行额外操作。 您也可以按照说明使用自定义导出到 Yandex Market 的方式创建包含目录的信息库。

如果您使用的是 HostCMS,可以按照该指南启用包含目录页面的信息库导出功能。 详情请参阅产品系列。

教育

准备一个包含在线课程和课件信息的 YML 格式的信息库。

通过此信息流创建产品广告时,广告标题将自动生成,广告文本则从广告设置中指定的默认文本字段提取。

该信息流包含产品以及每个产品所属的类别。 使用集合组合多个产品。

有关信息库的所有要求,请参阅 Yandex Webmaster 帮助。

卫生保健

准备一个包含医疗服务信息的 YML 格式的信息库。

通过此信息流创建产品广告时,广告标题将自动生成,广告文本则从广告设置中指定的默认文本字段提取。

信息流包含产品,您可以在其中传递有关医生、诊所和服务的数据。

有关信息库的所有要求,请参阅 Yandex Webmaster 帮助。

有问题吗?

注意

我们的客服只能协助您处理与您联系我们时使用的用户名关联的广告系列。 您可以通过在另一个浏览器标签页中打开 ya.ru 来查看您的用户名。 我们的团队只有在处理您的请求时才能访问您的数据。

扫描或轻触二维码即可访问链接。