应用推广的 YML 信息流要求

每个产品必须拥有唯一的 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>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
    <price>1620.00</price>
    <oldprice>1800.00</oldprice>
    <currencyId>RUB</currencyId>
    <categoryId>19</categoryId>
    <picture>https://site.ru/images/1.png</picture>
    <picture>https://site.ru/images/2.png</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>false</delivery>
    <name>ESET NOD32 Antivirus Platinum Edition</name>
    <vendor>Eset</vendor>
    <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
    <description>ESET NOD32 Antivirus Platinum Edition (2 years) NOD32-ENA-NS(BOX)-2-1</description>
    <video>http://89.123.45.678/catalog/video/19/6.MP4</video>
    <sales_notes>Pay by card, cash, bank transfer, or apply for financing</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Russia</country_of_origin>
    <age unit="year">18</age>
  </offer>

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

示例：

  <offer id="1234567" type="vendor.model" available="true">
    <url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
    <price>889.00</price>
    <oldprice>17000.00</oldprice>
    <currencyId>RUR</currencyId>
    <categoryId>1111</categoryId>
    <picture>https://site.ru/images/1.png</picture>
    <picture>https://site.ru/images/2.png</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <typePrefix>Printer</typePrefix>
    <vendor>НP</vendor>
    <model>Deskjet D2663</model>
    <description>Reliable, easy-to-use color printers designed for your everyday printing needs...</description>
    <sales_notes>Online payment only.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Japan</country_of_origin>
  </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` 值可以由数字、字母或两者的组合构成。可能包含字符。最大长度为 100 个字符。提示如果您计划设置筛选条件，请只使用数字 `ID` 值。示例 18295 1223abc a12b34fq	是	是
`type`	产品描述类型。该值必须为 `vendor.model.` 如果您传递 `type` 属性，这表示您正在使用自定义描述类型。 Yandex Direct 会检查是否存在 `<vendor>` 和 `<model>` 元素。如果缺少，则产品会被忽略，不会生成产品广告。	无	针对自定义描述类型
`available`	产品存货信息： `true`：产品有货； `false`：产品缺货。默认情况下，Yandex Direct 假定 feed 中的所有产品都有现货。如果您的 feed 包含缺货商品，您需要为每个商品指定 `available` 属性。如此一来，生成广告时可以过滤掉产品。 Feed 中的产品供应信息应与着陆页和结账页面上的信息一致。	是	如果使用按产品存货筛选，则为必填项

<offer> 元素的子元素

元素

描述

可用于筛选器设置

必需元素。

名称

产品或服务的名称。最大长度为 56 个字符。

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

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

对于旨在获取新用户的广告系列

标准跟踪链接或 OneLink 格式的跟踪链接。我们建议向您的跟踪链接添加延迟深度链接，这样您便可以在用户安装应用后立即将其重定向到您的产品概况。
对于再营销广告系列

添加包含深度链接并支持再营销归因的跟踪链接。

为了确保深度链接在 iOS 设备上正确打开，请使用支持通用链接技术的跟踪链接。

最大链接长度：2048 个字符。

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

示例

<url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid}&pid=yandexdirect_int&clickid={logid}&deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>

如何对 URL 中的字符编码？

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

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

产品描述。最大长度为 81 个字符。

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

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

示例

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

无

是

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 —— 本产品不可下载。

无

custom_label_0
custom_label_0
custom_label_0
custom_label_0
custom_label_0

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

您只能使用自定义信息流元素创建筛选条件。它们不会影响创意的生成方式。这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。例如，您可以根据产品是否属于某个促销活动来设置筛选条件。

是

无

custom_score

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

您只能使用自定义信息流元素创建筛选条件。它们不会影响创意的生成方式。这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。例如，您可以根据产品的利润率设置筛选条件。

是

无

有问题吗？

注意

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

联系我们

聊天

应用推广的 YML 信息流要求

有问题吗？

有用链接

法律文件

在线课程

了解更多

这篇文章是否有用？