Feed 文件要求。 其他类别

元素

描述

Property ID

酒店 ID。 必需元素。

Property name

酒店名称。 必需元素。

Final URL

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

Destination name

酒店位置（不超过 25 个字符）。 必需元素。

Image URL

图像链接。 建议使用宽度或高度至少为 500px 的图像。 此元素是在 Yandex 网盟中投放广告所必需的

价格

产品价格。 货币符号和代码（RUB、USD、UAH、KZT）。 使用点 (.) 作为十进制分隔符。 推荐元素。

Star rating

星级。 从 1 到 5 的整数。

Score

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

Max score

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

Facilities

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

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

custom_score

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

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

元素

描述

必需元素。

unique_id

产品 ID。

如果省略 vin 元素

vin

汽车 VIN（17 个符号）。

如果省略 unique_id 元素

url

产品页面链接。

是

images

特定车型或改装车型的图像链接。 您可以在 images 标签内使用多个image 标签。

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

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

在 Yandex 网盟中的展示量

价格

购车价格。

推荐

currency

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

如果存在 price 元素

mark_id

汽车品牌名称。

如果省略 folder_id 元素

folder_id

车型名称。

如果省略 mark_id 元素

modification_id

改装车型名称。

无

year

汽车制造年份。

无

run

里程（以公里为单位）。 使用大于 0 的整数。

无

owners_number

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

无

body_type

汽车车身型式。

无

color

车辆颜色。

无

state

车辆状况。

无

collectionId

要以组合格式（目录页面广告和产品广告）投放广告，请传输汽车描述与目录之间的链接。 该值等于 <collections> 元素中的 <collection id>。

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

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

如果使用 <collections>，则推荐

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

无

custom_score

自定义元素。 数值：零或正整数。

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

无

元素

描述

必需元素。

collection id

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

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

是

url

目录页面 URL。

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

URL 必须指定 http 或 https 协议。

是

picture

图像链接。

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

针对 YAN 中的展示

名称

目录名称。

是

description

目录描述。

无

属性

描述

internal-id

产品优惠 ID。 必需属性。

属性

描述

必需元素。

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>

推荐

名称

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

推荐

time-on-transport

地铁站名称。

推荐

time-on-foot

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

推荐

url

产品页面链接。

是

image

图像链接。

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

在 Yandex 网盟中的展示量

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

建筑面积单位。 可能的值：кв. м 或 sq. m。

推荐

floor

物业所在的楼层。

推荐

floors-total

建筑物的楼层总数。

无

rooms

公寓的房间总数。 对于自由组合格局的住宅，房间数量是根据房产证上的信息来指示的。 此元素不用于单间公寓。

无

bathroom-unit

浴室类型。 可能的值：

• “Combined”。
• “Separate”.
• 数值（从 1 到 5）。

无

renovation

精修。 可能的值：

• “精装修”。
• “交钥匙”.
• “初装修”。

无

description

附加信息。 您可以将其用作手动管理广告标题和广告文案的标签。

无

building-state

施工阶段。 值是受限的：

• “built” （施工已完成，但建筑尚未交付）
• “hand-over” （建筑已交付）
• “未完成”（正在施工） 如果 built-year 和 ready-quarter 的值为过去时间，则 building-state 元素必须具有 hand-over 值。

无

built-year

交付年份（施工年份）。 必须注明完整年份：例如 “1996”，而非 “96”。

对于已交付不超过 5 年或将在未来交付的建筑（住宅小区）

ready-quarter

建筑物已交付或即将交付的季度。 限制值：“1”、“2”、“3”、“4”。

无

building-type

建筑类型。 可能的值：

• “brick”
• “cast-in-place concrete”
• “panel”

无

deal-status

交易类型。 可能的值：

• 如果该房产由开发商出售： “一手房销售”/“开发商销售”。 <deal-status>primary sale</deal-status>

• 如果开发商未拥有该房产： “直接销售”。 <deal-status>direct sale</deal-status>

• 如果房产由私人或中介机构出售，但尚未取得产权： “转让”。 <deal-status>reassignment</deal-status>

无

collectionId

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

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

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

如果使用 <collections>，则推荐

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

确保该元素未嵌套在其他标签中：location、metro、price、sales-agent和 area。

您只能使用自定义 feed 文件元素在整合效果广告系列中创建筛选条件。 它们不会影响创意的生成方式。 这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。 例如，您可以按住宅建筑名称设置筛选条件。

无

custom_score

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

确保该元素未嵌套在其他标签中：location、metro、price、sales-agent和 area。

您只能使用自定义 feed 文件元素在整合效果广告系列中创建筛选条件。 它们不会影响创意的生成方式。 这些筛选条建用于按特定参数细分产品，没有可用的标准筛选条件。 例如，您可以按房间数量设置筛选条件。

无

元素

描述

必需元素。

collection id

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

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

是

url

目录页面 URL。

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

URL 必须指定 http 或 https 协议。

是

picture

图像链接。

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

针对 YAN 中的展示

名称

目录名称。

是

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 的图像。 此元素是在 Yandex 网盟中投放广告所必需的

Flight price

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

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

custom_score

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

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

元素

描述

ID

商品 ID。 必需元素。

ID2

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

URL

产品推荐页面 URL。 必需元素。

Image

图像链接。 建议使用宽度或高度至少为 500px 的图像。 此元素是在 Yandex 网盟中投放广告所必需的。

Title

产品名称。

Description

产品描述。

价格

产品价格，不区分货币。 使用点 (.) 作为十进制分隔符。 推荐元素。

Currency

货币代码（RUB、USD、UAH、KZT）。 如果存在 Price 元素，则为必需元素。

Old Price

旧产品价格必须高于新价格（价格）。

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

custom_score

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

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

元素

描述

ID

商品 ID。 必需元素。

ID2

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

Final URL

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

Image URL

图像链接。 建议使用宽度或高度至少为 500px 的图像。 此元素是在 Yandex 网盟中投放广告所必需的

Item title

商品名称。

Item description

产品描述。

价格

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

Sale price

产品新价格，必须低于原价 (Price)。

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

custom_score

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

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

元素

描述

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": "MOS-AMS"。

Origin name

出发地名称。

Final URL

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

Image URL

图像链接。 建议使用宽度或高度至少为 500px 的图像。 此元素是在 Yandex 网盟中投放广告所必需的。

Title

商品名称。

价格

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

Sale price

产品新价格，必须低于原价 (Price)。

• custom_label_0
• custom_label_1
• custom_label_2
• custom_label_3
• custom_label_4

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

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

custom_score

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

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