Feed 文件要求

  1. 产品销售
  2. 其他类别
  3. 有问题吗？

产品销售

产品 Feed 的一般要求：

  • 每个产品必须拥有唯一的 ID。

  • 同一产品在不同 Feed 中的 ID 必须相同，即使 Feed 的类型不同。 例如，相同的产品在您的 Yandex Market 和 Google Shopping Feed 中应具有相同的 ID。

零售，其他业务：Yandex Market feed

您可将 YML（Yandex Market Language）格式的 Yandex Market feed 文件用于"零售"和"其他"类型的业务。 欲了解有关 YML 的更多信息，请参阅 Yandex Market Help。

任何 XML 文件都可能只包含一个根元素。 YML 格式使用 <yml_catalog> 元素作为根元素。 <yml_catalog> 元素的日期属性应与广告主生成 YML 文件的日期和时间对应。 日期必须采用 YYYY-MM-DD hh:mm 格式。

广告主的产品列表包含在 <offers> 元素中。 在单独的 <offer> 元素中描述每款产品。 将 <shop> 元素中的 <currencies> 和 <categories> 元素添加到产品推荐列表之前。 欲了解有关构成 <shop> 的元素的更多信息，请参阅 Yandex Market Help。

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

示例：
<offer id="0123456" available="true">
  <url>http://www.reliableappliances.biz/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc&amp</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 Antivirus</name>
  <vendor>Eset</vendor>
  <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
  <description> ESET NOD32 Platinum Edition Antivirus-2-year license NOD32-ENA-NS(BOX)-2-1</description>
  <video>http://89.123.45.678/catalog/video/19/6.MP4</video>
  <sales_notes>Payment: cash, wire transfer, bank card, loan</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Russia</country_of_origin>
  <age unit="year">18</age>
</offer>

<offer> 元素的属性

属性 Description
id

产品 ID。

必需属性。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。
available

产品上市信息：

  • true —— 产品是现货。
  • false —— 产品缺货中。
属性 Description
id

产品 ID。

必需属性。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。
available

产品上市信息：

  • true —— 产品是现货。
  • false —— 产品缺货中。

<offer> 元素的子元素

元素 Description
name

产品名称。建议您在简单 offer 名称中指明供应商或制造商的名称和代码。

必需元素。
url

产品页面 URL。

必需元素。
picture

图像链接。

必需元素（智能横幅）。

从一种产品的卡片中添加多张图像。 例如，从不同角度或不同内部展示的产品图像。 YAN 允许您以某些格式显示最多五张图像。 有关智能横幅中图像的选择和处理的更多信息，请参阅问题与解答。
price

这款产品的供应价格。

动态广告和智能横幅的推荐元素。
currencyId

货币代码（RUB、USD、UAH、KZT）。

如果存在 price 元素，则为必需元素。
model

型号。
vendor

供应商或制造商。
vendorCode

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

产品描述。
video

产品视频链接。

请提供长度不超过 45 秒且满足其他技术要求的 MP4 视频。

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

内容推荐：

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

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

在 <offer> 中，添加多个 <video> 标签，且视频具有不同的宽高比：16 : 9；1 : 1；9 : 16，以确保最大程度的覆盖率。 Yandex Direct 算法将根据投放选项选择最合适的格式。

展示仅在 YAN 中。
categoryId

广告主分配的产品类别 ID（不超过 18 个字符的整数）。 产品只能属于一个类别。

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

Yandex Market 上使用的产品类别。
store

产品在零售商店出售：

  • true —— 适用。

  • false —— 不适用。
pickup

客户从交货地点取货：

  • true —— 适用。

  • false —— 不适用。
delivery

快递送货：

  • true —— 适用。

  • false —— 不适用。
oldprice

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

订单信息：

  • 最低订单价格、最低产品寄售金额、法定预付款。

  • 付款选项、促销和销售描述。
manufacturer_warranty

官方保修：

  • true —— 适用。

  • false —— 不适用。
country_of_origin

原产国。
adult

此产品属于 "adult" 类别：

  • true —— 是。

  • false —— 否。
age

产品年限类别。
downloadable

产品下载：

  • true —— 适用。

  • false —— 不适用。
param

指定产品特性和参数。 在名称属性中，输入参数名称（必填）：

  • Пол/性别。

  • Цвет/颜色或色彩。

  • Материал/材料。
  • Размер/尺寸。

示例：

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

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

产品名称。建议您在简单 offer 名称中指明供应商或制造商的名称和代码。

必需元素。
url

产品页面 URL。

必需元素。
picture

图像链接。

必需元素（智能横幅）。

从一种产品的卡片中添加多张图像。 例如，从不同角度或不同内部展示的产品图像。 YAN 允许您以某些格式显示最多五张图像。 有关智能横幅中图像的选择和处理的更多信息，请参阅问题与解答。
price

这款产品的供应价格。

动态广告和智能横幅的推荐元素。
currencyId

货币代码（RUB、USD、UAH、KZT）。

如果存在 price 元素，则为必需元素。
model

型号。
vendor

供应商或制造商。
vendorCode

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

产品描述。
video

产品视频链接。

请提供长度不超过 45 秒且满足其他技术要求的 MP4 视频。

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

内容推荐：

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

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

在 <offer> 中，添加多个 <video> 标签，且视频具有不同的宽高比：16 : 9；1 : 1；9 : 16，以确保最大程度的覆盖率。 Yandex Direct 算法将根据投放选项选择最合适的格式。

展示仅在 YAN 中。
categoryId

广告主分配的产品类别 ID（不超过 18 个字符的整数）。 产品只能属于一个类别。

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

Yandex Market 上使用的产品类别。
store

产品在零售商店出售：

  • true —— 适用。

  • false —— 不适用。
pickup

客户从交货地点取货：

  • true —— 适用。

  • false —— 不适用。
delivery

快递送货：

  • true —— 适用。

  • false —— 不适用。
oldprice

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

订单信息：

  • 最低订单价格、最低产品寄售金额、法定预付款。

  • 付款选项、促销和销售描述。
manufacturer_warranty

官方保修：

  • true —— 适用。

  • false —— 不适用。
country_of_origin

原产国。
adult

此产品属于 "adult" 类别：

  • true —— 是。

  • false —— 否。
age

产品年限类别。
downloadable

产品下载：

  • true —— 适用。

  • false —— 不适用。
param

指定产品特性和参数。 在名称属性中，输入参数名称（必填）：

  • Пол/性别。

  • Цвет/颜色或色彩。

  • Материал/材料。
  • Размер/尺寸。

示例：

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

<param name="Материал">aluminium</param>
零售，其他业务：Google Shopping feed 文件

您可将 Google Shopping 格式的 Feed 文件用于"零售"和"其他业务"类型。

示例：
<channel>
<title>example.ru online store</title>
<link>example.ru</link>
<item>
<g:link>
https://example.ru/catalog/kompyutery/kompyuter-apple-mac-mini-z12p000b0-apple-m1-16gb-512gb/<g:/link>
<g:id>123</g:id>
<g:price>15550.00 RUB</g:price>
<g:sale_price>12550.00 RUB</g:sale_price>
<g:condition>new</g:condition>
<g:availability>in stock</g:availability>
<g:product_type>Computers</g:product_type>
<g:image_link>
https://example.ru/upload/iblock/40a/40aca7181dcb81cb1cbffb3bc555e038.jpg
</g:image_link>
<g:brand>Apple</g:brand>
<g:google_product_category>Electronics</g:google_product_category>
<g:title>Computer APPLE Mac mini Z12P000B0, Apple M1, 16GB, 512GB (SSD), macOS, silver</g:title>
<g:description>
APPLE Mac mini Z12P000B0 features a matte enclosure case making it stylish and practical. 此型号仅重 1.2 公斤，便于运输和存放。 要连接有线设备，您可以使用 USB 3.0、HDMI 和 Thunderbolt 端口。 对于无线设备，您可以使用内置的蓝牙模块。 这台计算机支持 Wi-Fi，因此您上网不会有任何问题。 其 SSD 存储容量高达 512 GB。
</g:description>
</item>
</channel>
Google Shopping 中包含的元素
元素 Description 示例
<g:id> 产品 ID 可以包含字符和数字。 必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。 <g:id>123</g:id>
<g:title> 产品名称。 必需元素。 <g:title>Computer APPLE Mac mini Z12P000B0, Apple M1, 16GB, 512GB(SSD), macOS, silver</g:title>
<g:description> 产品描述。 推荐元素。 <g:description>APPLE Mac mini Z12P000B0 采用哑光饰面，时尚实用。 此型号仅重 1.2 公斤，便于运输和存放。 要连接有线设备，您可以使用 USB 3.0、HDMI 和 Thunderbolt 端口。 对于无线设备，您可以使用内置的蓝牙模块。 这台计算机支持 Wi-Fi，因此您上网不会有任何问题。 其 SSD 存储容量高达 512 GB。</g:description>
<g:link> 链接到网站上的产品。 必需元素。 <g:link>https://example.ru/catalog/kompyutery/kompyuter-apple-mac-mini-z12p000b0-apple-m1-16gb-512gb/<g:/link>
<g:price> 以货币表示的产品价格。 格式："1000.00 卢布"。 推荐元素。 <g:price>15550.00 RUB</g:price>
<g:price> 折扣后的产品价格。 格式类似于 <g:price>。 推荐元素。 <g:sale_price>12550.00 RUB</g:sale_price>
<g:image_link> 链接到产品图片。 必需元素。 <g:image_link>https://example.ru/upload/iblock/40a/40aca7181dcb81cb1cbffb3bc555e038.jpg</g:image_link>
<g:brand> 制造商的品牌。 可选元素。 <g:brand>Apple</g:brand>
<g:availability> 产品可得性。 可选元素。 可取三个值：库存、缺货或预订。 <g:availability>in stock</g:availability>
<g:google_product_category> 符合 Google 规范的产品类别。 可选元素。 <g:google_product_category>Electronics</g:google_product_category>
<g:product_type> 网站上的产品类别。 可选元素。 <g:product_type>Computers</g:product_type>
<g:condition> 产品状况。 可选元素。 <g:condition>new</g:condition>
<g:material> 产品材料。 可选元素。 <g:material>Aluminum</g:material>
<g:gender> Genderю 可选元素。 <g:gender>Men</g:gender>
<g:size> 产品尺寸或规格。 可选元素。 <g:size>44RUS</g:size>
<g:color> 产品颜色。 可选元素。 <g:color>Blue</g:color>
元素 Description 示例
<g:id> 产品 ID 可以包含字符和数字。 必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。 <g:id>123</g:id>
<g:title> 产品名称。 必需元素。 <g:title>Computer APPLE Mac mini Z12P000B0, Apple M1, 16GB, 512GB(SSD), macOS, silver</g:title>
<g:description> 产品描述。 推荐元素。 <g:description>APPLE Mac mini Z12P000B0 采用哑光饰面，时尚实用。 此型号仅重 1.2 公斤，便于运输和存放。 要连接有线设备，您可以使用 USB 3.0、HDMI 和 Thunderbolt 端口。 对于无线设备，您可以使用内置的蓝牙模块。 这台计算机支持 Wi-Fi，因此您上网不会有任何问题。 其 SSD 存储容量高达 512 GB。</g:description>
<g:link> 链接到网站上的产品。 必需元素。 <g:link>https://example.ru/catalog/kompyutery/kompyuter-apple-mac-mini-z12p000b0-apple-m1-16gb-512gb/<g:/link>
<g:price> 以货币表示的产品价格。 格式："1000.00 卢布"。 推荐元素。 <g:price>15550.00 RUB</g:price>
<g:price> 折扣后的产品价格。 格式类似于 <g:price>。 推荐元素。 <g:sale_price>12550.00 RUB</g:sale_price>
<g:image_link> 链接到产品图片。 必需元素。 <g:image_link>https://example.ru/upload/iblock/40a/40aca7181dcb81cb1cbffb3bc555e038.jpg</g:image_link>
<g:brand> 制造商的品牌。 可选元素。 <g:brand>Apple</g:brand>
<g:availability> 产品可得性。 可选元素。 可取三个值：库存、缺货或预订。 <g:availability>in stock</g:availability>
<g:google_product_category> 符合 Google 规范的产品类别。 可选元素。 <g:google_product_category>Electronics</g:google_product_category>
<g:product_type> 网站上的产品类别。 可选元素。 <g:product_type>Computers</g:product_type>
<g:condition> 产品状况。 可选元素。 <g:condition>new</g:condition>
<g:material> 产品材料。 可选元素。 <g:material>Aluminum</g:material>
<g:gender> Genderю 可选元素。 <g:gender>Men</g:gender>
<g:size> 产品尺寸或规格。 可选元素。 <g:size>44RUS</g:size>
<g:color> 产品颜色。 可选元素。 <g:color>Blue</g:color>

如果您的 Feed 文件包含表格中未指定的标签，请勿删除它们。 处理过程中会忽略额外的标签。

其他业务：通用 feed 文件

对于"其他业务"类型，您可以使用 CSV 格式的通用 feed 文件。 首个字符串包含列名，以下字符串则包含实际数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例

下载 CSV 格式的通用 feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅的 feed 文件元素。

元素 Description

ID

商品 ID。

必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

URL

产品推荐页面 URL。

必需元素。

Image

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Title 商品名称。
Description

产品描述

Price

商品价格，不区分货币。 使用点 (.) 作为十进制分隔符。

推荐元素。
Currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 Price 元素，则为必需元素。

Old Price

商品原价，必须高于新价格 (Price)。
元素 Description

ID

商品 ID。

必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

URL

产品推荐页面 URL。

必需元素。

Image

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Title 商品名称。
Description

产品描述

Price

商品价格，不区分货币。 使用点 (.) 作为十进制分隔符。

推荐元素。
Currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 Price 元素，则为必需元素。

Old Price

商品原价，必须高于新价格 (Price)。
其他业务：Google Ads "Custom" feed 文件

对于"其他业务"类型，您可以使用 CSV 格式的 Google Ads "Custom" feed 文件。 首个字符串包含列名，以下字符串则包含实际数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例

下载 CSV 格式的 Google Ads "Custom" feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅的 feed 文件元素。

元素 Description

ID

商品 ID。

必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Item title

商品名称。
Item description

产品描述

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。
元素 Description

ID

商品 ID。

必需元素。 每个产品的 ID 必须是唯一的，并且在不同的 Feed 中不能重叠。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Item title

商品名称。
Item description

产品描述

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。

其他类别

酒店：Google Ads "Hotels and rentals" Feed 文件

对于 CSV 格式的 Google Ads "Hotels and rentals" feed 文件，您可以使用 "Hotels" 作为业务类型。 首个字符串包含列名，以下字符串则包含数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例：

下载 CSV 格式的酒店 feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅或动态广告的 feed 文件元素。

元素 Description

Property ID

酒店 ID。

必需元素。

Property name

酒店名称。

必需元素。

Final URL

产品推荐页面 URL。

必需元素。

Destination name

酒店位置（不超过 25 个字符）。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Price

优惠价格。 货币符号和代码（RUB、USD、UAH、KZT）。 使用点 (.) 作为十进制分隔符。

推荐元素。

Star rating

星级。 从 1 到 5 的整数。

Score

用户评级，以数字表示。 使用点 (.) 作为十进制分隔符。

Max score

最高可能评级，以整数表示。 默认数值为 5。

Facilities

酒店提供的设施或服务。 输入以分号分隔的值：bar;pool;free Wi-Fi
元素 Description

Property ID

酒店 ID。

必需元素。

Property name

酒店名称。

必需元素。

Final URL

产品推荐页面 URL。

必需元素。

Destination name

酒店位置（不超过 25 个字符）。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Price

优惠价格。 货币符号和代码（RUB、USD、UAH、KZT）。 使用点 (.) 作为十进制分隔符。

推荐元素。

Star rating

星级。 从 1 到 5 的整数。

Score

用户评级，以数字表示。 使用点 (.) 作为十进制分隔符。

Max score

最高可能评级，以整数表示。 默认数值为 5。

Facilities

酒店提供的设施或服务。 输入以分号分隔的值：bar;pool;free Wi-Fi
注. 包含逗号的值需要在写入时添加引号 ("")。 例如，"Moscow, center"。
汽车： Auto.ru feed

您应使用 XML 格式的 Auto.ru feed 文件推广 "Automobile" 业务。 Feed 文件数据必须编码为 UTF-8。

客车的完整 XML 格式描述（zip 存档文件，1477 KB）

推广优惠列表包含在 <cars> 元素中。 在单独的 <car> 元素中描述每款汽车。

示例：
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Hyundai</mark_id>
            <folder_id>Sonata</folder_id>
            <modification_id>2.0 AT (150 Hp)</modification_id>
            <url>http://www.auto.ru/1</url>
            <images>http://picture.auto.ru/1.jpg</images>
            <body_type>Sedan</body_type>
            <color>gray</color>
            <availability>in stock</availability>
            <custom>cleared</custom>
            <year>2022</year>
            <price>2575000</price>
            <currency>RUB</currency>
            <vin>XWBCA41ZXDK259205</vin>
            <owners_number>No past owners</owners_number>
         </car>
     </cars>
</data>

<car> 元素中包含的子元素

下表描述用于创建智能横幅或动态广告的 feed 文件元素。

元素 Description
unique_id

产品优惠 ID。

如果不存在 vin 元素，则为必需元素。
vin

汽车 VIN（17 个符号）。

如果不存在 unique_id 元素，则为必需元素。
url

产品优惠页面链接。

必需元素。
images

特定车型或改装车型的图像链接。

必需元素（智能横幅）。

您可以在 images 标签内使用多个image 标签。

<images>
  <image></image>
  <image></image>
</images>

添加不同格式（水平、垂直、方形）的多个图像，每个图像位于单独的image标记中。 将使用最适合纵横比的图像。
price

购车价格。

推荐元素。
currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 price 元素，则为必需元素。
mark_id

汽车品牌名称。

如果 folder_id 元素不存在，则为必需元素。
folder_id

车型名称。

如果mark_id元素不存在，则为必需元素。
modification_id

改装车型名称。
year

汽车制造年份。
run

里程（以公里为单位）。

使用大于 0 的整数。
owners_number

按车辆所有权划分的车主数量。

限制值
  • 一位车主
  • 两位车主
  • 三位车主
  • 四位或更多车主。
  • 无车主。
body_type

汽车车身型式。

限制值
  • SUV
  • 敞篷车
  • 紧凑型多用途汽车
  • 双门小轿车
  • 硬顶跑车
  • 小型车
  • 豪华轿车
  • 揭背车
  • 微型货车
  • 小型货车
  • 皮卡车
  • 双座敞篷车
  • 轿车
  • 硬顶轿车
  • 轿跑车
  • targa
  • 旅行车
  • 斜背车
  • phaeton
  • phaeton estate
  • 厢型车
  • 掀背车
color

车辆颜色。

限制值
  • 米色
  • 白色
  • 淡蓝色
  • 黄色
  • 绿色
  • 金色
  • 棕色
  • 红色
  • 橙色
  • 紫色
  • 粉色
  • 银色
  • 灰色
  • 蓝色
  • 蓝紫色
state

车辆状况。

限制值
  • 极好
  • 良好
  • 适中
  • 需要维修。
元素 Description
unique_id

产品优惠 ID。

如果不存在 vin 元素，则为必需元素。
vin

汽车 VIN（17 个符号）。

如果不存在 unique_id 元素，则为必需元素。
url

产品优惠页面链接。

必需元素。
images

特定车型或改装车型的图像链接。

必需元素（智能横幅）。

您可以在 images 标签内使用多个image 标签。

<images>
  <image></image>
  <image></image>
</images>

添加不同格式（水平、垂直、方形）的多个图像，每个图像位于单独的image标记中。 将使用最适合纵横比的图像。
price

购车价格。

推荐元素。
currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 price 元素，则为必需元素。
mark_id

汽车品牌名称。

如果 folder_id 元素不存在，则为必需元素。
folder_id

车型名称。

如果mark_id元素不存在，则为必需元素。
modification_id

改装车型名称。
year

汽车制造年份。
run

里程（以公里为单位）。

使用大于 0 的整数。
owners_number

按车辆所有权划分的车主数量。

限制值
  • 一位车主
  • 两位车主
  • 三位车主
  • 四位或更多车主。
  • 无车主。
body_type

汽车车身型式。

限制值
  • SUV
  • 敞篷车
  • 紧凑型多用途汽车
  • 双门小轿车
  • 硬顶跑车
  • 小型车
  • 豪华轿车
  • 揭背车
  • 微型货车
  • 小型货车
  • 皮卡车
  • 双座敞篷车
  • 轿车
  • 硬顶轿车
  • 轿跑车
  • targa
  • 旅行车
  • 斜背车
  • phaeton
  • phaeton estate
  • 厢型车
  • 掀背车
color

车辆颜色。

限制值
  • 米色
  • 白色
  • 淡蓝色
  • 黄色
  • 绿色
  • 金色
  • 棕色
  • 红色
  • 橙色
  • 紫色
  • 粉色
  • 银色
  • 灰色
  • 蓝色
  • 蓝紫色
state

车辆状况。

限制值
  • 极好
  • 良好
  • 适中
  • 需要维修。
Realty: Yandex Realty feed 文件

对于"Realty"业务，您应该使用 YRL（Yandex Realty Language）格式的 Yandex Realty feed 文件。 有关 YRL 格式的更多信息，请参阅 Yandex Realty Help。

在单独的 <offer> 元素中描述每款产品。

您可以在一个 feed 文件中发送不同地产开发商开发的不同住宅的信息。 要完成此操作，请在每个 sales-agent 元素的 <offer> 子元素中输入开发商的法定信息。

示例：

<offer internal-id="15782295">
  <type>sale</type>
  <property-type>residential</property-type>
  <category>apartment</category>
  <url>http://www.developer.ru/search18</url>
  <creation-date>2015-04-02T19:00:06+03:00</creation-date>
  <location>    
    <locality-name>Saint Petersburg</locality-name>
    <sub-locality-name>Vasilyevsky island</sub-locality-name>
    <address>Line 18 V.O., 32</address>
    <metro>
      <name>Vasileostrovskaya</name>
      <time-on-foot>10</time-on-foot>
      <time-on-transport>5</time-on-transport>
   </metro>
  </location>
  <deal-status>primary sale</deal-status>
  <price>
    <value>4780000</value>
    <currency>RUB</currency>
  </price>
  <sales-agent>    
    <organization>Builders Inc</organization>    
  </sales-agent>
  <rooms>2</rooms>
  <floor>13</floor>
  <floors-total>15</floors-total>
  <area>
    <value>63.00</value>
    <unit>sq.m.</unit>
  </area>
  <building-name>Northern Fantasy</building-name>
  <building-state>unfinished</building-state>
  <ready-quarter>3</ready-quarter>
  <image>http://www.developer.ru/images/plans/000001289.jpg</image>
  <image>http://www.developer.ru/images/plans/000001290.jpg</image>
  <description>2-room apartment for sale, 13th floor, 15-minute driving distance from Vasileostrovskaya metro station. 拥有智能布局解决方案和广泛公寓选择的舒适型住宅区。 “北方幻境”的内院是根据一项独家设计方案打造的。 周围的基础设施包括学校和幼儿园、医院、药店、商店、咖啡馆和体育设施。 提供多种抵押贷款计划、折扣和以旧换新选项。</description>
</offer>

<offer> 元素的属性

属性 Description
internal-id

产品优惠 ID。

必需属性。
属性 Description
internal-id

产品优惠 ID。

必需属性。

<offer> 元素的子元素

下表描述用于创建智能横幅或动态广告的 feed 文件元素。

元素 Description
type

交易类型。

sale 是唯一可用的值。

必需元素。
category

物业类别。

可能的值：

  • "dacha"/коттедж/cottage
  • "дом"/"house"
  • "дом с участком"/"house with lot"
  • "участок"/"lot"
  • "part of a house"
  • "квартира"/"flat"
  • "комната"/"room"
  • "таунхаус"/"townhouse"
  • "duplex"/"duplex"
  • "garage"/"garage"
location

描述相关对象位置的一组元素。 嵌套标签中对位置信息进行了详细说明。

<location>     
      <locality-name></locality>
      <address></address>
      <metro></metro>
      …
 </location>

必需元素。
locality-name

区域名称。

必需元素。
sub-locality-name

区域所在的地区。

推荐元素。
address

街道和门牌号。

推荐元素。
metro

最近的地铁站。

如果有多个地铁站，则分别将每个地铁站作为单独的元素输入。 嵌套标签将列明详细信息。

<metro>           
      <name></name>
      <time-on-foot></time-on-foot>
      <time-on-transport></time-on-transport>
</metro>

推荐元素。
name

地铁站名称。

推荐元素。
time-on-transport

搭乘公共交通工具前往地铁站所需的时间。

推荐元素。
time-on-foot

步行前往地铁站所需的时间（分钟）。

推荐元素。
url

产品优惠页面链接。

必需元素。
image

图像链接。

必需元素（智能横幅）。

添加不同格式（水平、垂直、方形）的多个图像，每个图像在单独的 <image> 元素中。 将使用最适合纵横比的图像。
building-name

住宅或建筑的名称。 住宅建筑公寓已并入此元素。

建设项目优惠描述的必要元素。
sales-agent

开放商信息。 嵌套标签将列明详细信息。

<sales-agent>
  <organization></organization>  
</sales-agent>

必需元素。
organization

开发商的法定名称。

必需元素。
price

描述相关对象价格的一组元素。 嵌套标签将对总价和货币做出说明。

<price>
    <value></value>
    <currency></currency> 
</price>

推荐元素。
value

价格。

推荐元素。
currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 value 元素，则为必需元素。
area

总面积。

嵌套标签将对价值和计量单位做出说明。

<area>
  <value></value>
  <unit></unit>
</area>

推荐元素。
value

面积值，

以数值表示。

推荐元素。
unit

建筑面积单位。

可接受的值：平方米。

推荐元素。
floor

物业所在的楼层。

推荐元素。
floors-total

建筑物的楼层总数。
rooms

公寓的房间总数。

对于毛坯房，房间数量是根据房产证上的信息来指示的。

此元素不用于单间公寓。
bathroom-unit

浴室类型。

可能的值：

  • "Combined"。
  • "Separate"。
  • 数值（从 1 到 5）。
renovation

精修。

可能的值：

  • "Fine finish"。
  • "Turnkey"。
  • "Rough finish"。
description

附加信息。

任意描述（最多 10,000 个字符）。 在手动管理广告标题和文本时，如果标签在超过 70% 的 Feed 优惠中提供，那么它是唯一可以使用的标签。
building-state

施工阶段。

值是受限的：

  • "built"（施工已完成，但建筑尚未交付）
  • "hand-over"（建筑已交付）
  • "unfinished"（建筑正在施工）

如果 built-year 和 ready-quarter 值位于过去，则 building-state 元素必须具有 hand-over 值。
built-year

交付年份（施工年份）。

对于已交付不超过 5 年或将在未来交付的建筑（住宅小区），这是一个必需元素。

必须注明完整年份：例如 "1996"，而非 "96"。
ready-quarter

建筑物已交付或即将交付的季度。

值是受限的："1"、"2"、"3"、"4"。
building-type

建筑类型。

可能的值：

  • "brick"
  • "cast-in-place concrete"
  • "panel"
deal-status

交易类型。

可能的值：

  • 如果该房产由开发商出售：

    "primary sale"/"sale by developer"。
    <deal-status>primary sale</deal-status>

  • 如果开发商未拥有该房产：

    "direct sale"。

    <deal-status>direct sale</deal-status>

  • 如果房产由私人或中介机构出售，但尚未取得产权：

    """reassignment"。

    <deal-status>reassignment</deal-status>
元素 Description
type

交易类型。

sale 是唯一可用的值。

必需元素。
category

物业类别。

可能的值：

  • "dacha"/коттедж/cottage
  • "дом"/"house"
  • "дом с участком"/"house with lot"
  • "участок"/"lot"
  • "part of a house"
  • "квартира"/"flat"
  • "комната"/"room"
  • "таунхаус"/"townhouse"
  • "duplex"/"duplex"
  • "garage"/"garage"
location

描述相关对象位置的一组元素。 嵌套标签中对位置信息进行了详细说明。

<location>     
      <locality-name></locality>
      <address></address>
      <metro></metro>
      …
 </location>

必需元素。
locality-name

区域名称。

必需元素。
sub-locality-name

区域所在的地区。

推荐元素。
address

街道和门牌号。

推荐元素。
metro

最近的地铁站。

如果有多个地铁站，则分别将每个地铁站作为单独的元素输入。 嵌套标签将列明详细信息。

<metro>           
      <name></name>
      <time-on-foot></time-on-foot>
      <time-on-transport></time-on-transport>
</metro>

推荐元素。
name

地铁站名称。

推荐元素。
time-on-transport

搭乘公共交通工具前往地铁站所需的时间。

推荐元素。
time-on-foot

步行前往地铁站所需的时间（分钟）。

推荐元素。
url

产品优惠页面链接。

必需元素。
image

图像链接。

必需元素（智能横幅）。

添加不同格式（水平、垂直、方形）的多个图像，每个图像在单独的 <image> 元素中。 将使用最适合纵横比的图像。
building-name

住宅或建筑的名称。 住宅建筑公寓已并入此元素。

建设项目优惠描述的必要元素。
sales-agent

开放商信息。 嵌套标签将列明详细信息。

<sales-agent>
  <organization></organization>  
</sales-agent>

必需元素。
organization

开发商的法定名称。

必需元素。
price

描述相关对象价格的一组元素。 嵌套标签将对总价和货币做出说明。

<price>
    <value></value>
    <currency></currency> 
</price>

推荐元素。
value

价格。

推荐元素。
currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 value 元素，则为必需元素。
area

总面积。

嵌套标签将对价值和计量单位做出说明。

<area>
  <value></value>
  <unit></unit>
</area>

推荐元素。
value

面积值，

以数值表示。

推荐元素。
unit

建筑面积单位。

可接受的值：平方米。

推荐元素。
floor

物业所在的楼层。

推荐元素。
floors-total

建筑物的楼层总数。
rooms

公寓的房间总数。

对于毛坯房，房间数量是根据房产证上的信息来指示的。

此元素不用于单间公寓。
bathroom-unit

浴室类型。

可能的值：

  • "Combined"。
  • "Separate"。
  • 数值（从 1 到 5）。
renovation

精修。

可能的值：

  • "Fine finish"。
  • "Turnkey"。
  • "Rough finish"。
description

附加信息。

任意描述（最多 10,000 个字符）。 在手动管理广告标题和文本时，如果标签在超过 70% 的 Feed 优惠中提供，那么它是唯一可以使用的标签。
building-state

施工阶段。

值是受限的：

  • "built"（施工已完成，但建筑尚未交付）
  • "hand-over"（建筑已交付）
  • "unfinished"（建筑正在施工）

如果 built-year 和 ready-quarter 值位于过去，则 building-state 元素必须具有 hand-over 值。
built-year

交付年份（施工年份）。

对于已交付不超过 5 年或将在未来交付的建筑（住宅小区），这是一个必需元素。

必须注明完整年份：例如 "1996"，而非 "96"。
ready-quarter

建筑物已交付或即将交付的季度。

值是受限的："1"、"2"、"3"、"4"。
building-type

建筑类型。

可能的值：

  • "brick"
  • "cast-in-place concrete"
  • "panel"
deal-status

交易类型。

可能的值：

  • 如果该房产由开发商出售：

    "primary sale"/"sale by developer"。
    <deal-status>primary sale</deal-status>

  • 如果开发商未拥有该房产：

    "direct sale"。

    <deal-status>direct sale</deal-status>

  • 如果房产由私人或中介机构出售，但尚未取得产权：

    """reassignment"。

    <deal-status>reassignment</deal-status>

创建广告时，请使用尽可能多的可用元素（标签）填写报价，即使它们不是必需的。 这将有助于制作引人注目的广告，并以所有可能的格式显示。

根据热门商品创建的横幅示例
Google Ads"Flights" feed 文件

对于 "Flights" 业务类型，您可以使用 CSV 格式的 Google Ads "Flights" feed 文件。 首个字符串包含列名，以下字符串则包含数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例：

下载 CSV 格式的航班 feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅或动态广告的 feed 文件元素。

元素 Description

Destination ID

目的地 ID。

必需元素。
Destination name

目的地名称。

必需元素。

Destination address

目的地地址。

Origin ID

出发地 ID。

如果您在 Feed 文件中指定了Origin ID 并在 Yandex Metrica 中启用了E-commerce，请使用 E-commerce 对象中的 Origin ID 和 Destination ID（用连字符分隔）作为商品 ID。 例如， "id": "VKO-LHR"。

Origin name

出发地名称。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Flight price

优惠价格。 货币符号和代码（RUB、USD、UAH、KZT）。 使用点 (.) 作为十进制分隔符。

推荐元素。
元素 Description

Destination ID

目的地 ID。

必需元素。
Destination name

目的地名称。

必需元素。

Destination address

目的地地址。

Origin ID

出发地 ID。

如果您在 Feed 文件中指定了Origin ID 并在 Yandex Metrica 中启用了E-commerce，请使用 E-commerce 对象中的 Origin ID 和 Destination ID（用连字符分隔）作为商品 ID。 例如， "id": "VKO-LHR"。

Origin name

出发地名称。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Flight price

优惠价格。 货币符号和代码（RUB、USD、UAH、KZT）。 使用点 (.) 作为十进制分隔符。

推荐元素。
其他业务：通用 feed 文件

对于"其他业务"类型，您可以使用 CSV 格式的通用 feed 文件。 首个字符串包含列名，以下字符串则包含实际数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例

下载 CSV 格式的通用 feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅的 feed 文件元素。

元素 Description

ID

商品 ID。

必需元素。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

URL

产品推荐页面 URL。

必需元素。

Image

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Title 商品名称。
Description

产品描述

Price

商品价格，不区分货币。 使用点 (.) 作为十进制分隔符。

推荐元素。
Currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 Price 元素，则为必需元素。

Old Price

商品原价，必须高于新价格 (Price)。
元素 Description

ID

商品 ID。

必需元素。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

URL

产品推荐页面 URL。

必需元素。

Image

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Title 商品名称。
Description

产品描述

Price

商品价格，不区分货币。 使用点 (.) 作为十进制分隔符。

推荐元素。
Currency

货币代码（RUB、USD、UAH、KZT）。

如果存在 Price 元素，则为必需元素。

Old Price

商品原价，必须高于新价格 (Price)。
其他业务：Google Ads "Custom" feed 文件

对于"其他业务"类型，您可以使用 CSV 格式的 Google Ads "Custom" feed 文件。 首个字符串包含列名，以下字符串则包含实际数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例

下载 CSV 格式的 Google Ads "Custom" feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅的 feed 文件元素。

元素 Description

ID

商品 ID。

必需元素。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Item title

商品名称。
Item description

产品描述

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。
元素 Description

ID

商品 ID。

必需元素。

ID2

第二个产品 ID

如果您在 Feed 文件中指定了 ID2 并在 Yandex Metrica 中启用了电子商务，请使用 Ecommerce 对象中的 ID 和 ID2（用连字符分隔）作为 offer ID。 例如， "id": "VKO-LHR"。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。
Item title

商品名称。
Item description

产品描述

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。
其他业务：Google Ads "Travel" feed 文件

对于"其他业务"类型，您可以使用 CSV 格式的 Google Ads "Travel" feed 文件。 首个字符串包含列名，以下字符串则包含实际数据。 列内容使用逗号分隔。 Feed 文件数据必须编码为 UTF-8。

示例

下载 CSV 格式的 Google Ads "Travel" feed 文件示例

CSV 中包含的元素

下表描述用于创建智能横幅的 feed 文件元素。

元素 Description

Destination ID

目的地 ID。

必需元素。

Destination name

目的地名称。

Destination address

目的地地址。

Origin ID

出发地 ID。

如果您在 Feed 文件中指定了 Origin ID 并在 Yandex Metrica 中启用了E-commerce，请使用 E-commerce 对象中的 Origin ID 和 Destination ID（用连字符分隔）作为 offer ID。 例如， "id": "MOS-AMS"。

Origin name

出发地名称。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。

Title

商品名称。

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。
元素 Description

Destination ID

目的地 ID。

必需元素。

Destination name

目的地名称。

Destination address

目的地地址。

Origin ID

出发地 ID。

如果您在 Feed 文件中指定了 Origin ID 并在 Yandex Metrica 中启用了E-commerce，请使用 E-commerce 对象中的 Origin ID 和 Destination ID（用连字符分隔）作为 offer ID。 例如， "id": "MOS-AMS"。

Origin name

出发地名称。

Final URL

产品推荐页面 URL。

必需元素。

Image URL

图像链接。 建议图像宽度或高度至少为 500px。

必需元素（智能横幅）。

Title

商品名称。

Price

采用 ISO 4217 编码格式（RUB、USD、UAH、KZT）货币代码的商品的价格。 使用点 (.) 作为十进制分隔符。

推荐元素。

Sale price

新商品价格，必须低于新价格（价格）。