Управление фидами

Для создания динамических объявлений вам нужно добавить фид — файл с информацией о товарах и услугах. Директ проанализирует содержание фида и автоматически сформирует динамические объявления с товарными предложениями для показа на поиске. Вы можете использовать фид, загруженный при создании смарт-баннеров.

Типы бизнеса и фидов

Для загрузки фида нужно выбрать тип бизнеса, который вы рекламируете.

Тип фидаТип бизнесаДля чего
Фид Яндекс.Маркета (XML)Розничная торговляПродажа электроники и аксессуаров, бытовой техники, промышленного оборудования, одежды, мебели, товаров для сада и огорода, спортивных товаров, строительных материалов, детских товаров, шин и дисков, косметики, парфюмерии и т. д.
Фид «Отели и аренда жилья» Google Рекламы (CSV)ОтелиБронирование отелей
Фид Авто.ру (XML)АвтомобилиПродажа новых и подержанных автомобилей
Фид Яндекс.Недвижимости (XML)НедвижимостьПродажа жилой недвижимости
Фид «Авиабилеты» Google Рекламы (CSV)АвиабилетыПродажа авиабилетов
Универсальный фид (CSV)Другой бизнесТовары и услуги, не подходящие другим типам бизнеса
Фид Яндекс.Маркета (XML)
Фид «Специальный» Google Рекламы (CSV)
Фид «Путешествия» Google Рекламы (CSV)Продажа туров, билетов на поезда, паромы и т. д.

Товарные предложения, описанные не в соответствии со своим типом, отклоняются.

Внимание. Смарт-баннеры и динамические объявления не генерируются для рекламы, в которой должны присутствовать предупреждения и возрастные ограничения.

Требования к фиду

Розничная торговля, другой бизнес: фид Яндекс.Маркета

Фид Яндекс.Маркета в формате YML (Yandex Market Language) может использоваться для типов бизнеса «Розничная торговля» и «Другой бизнес». Подробнее о формате YML в Помощи Яндекс.Маркета.

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне рекламодателя. Дата должна иметь формат YYYY-MM-DD hh:mm.

Список товарных предложений рекламодателя содержится в элементе <offers>. Каждое товарное предложение описывается отдельным элементом <offer>.

Базовый, более простой тип описания.

Пример:
<offer id="0123456" available="true">
  <url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&amp;utm_source=ya_market&amp;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>
  <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>
  <sales_notes>Оплата: Наличные, Б/Н, пластиковые карты, кредит</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Россия</country_of_origin>
  <age unit="year">18</age>
</offer>

Атрибуты элемента <offer>

АтрибутОписание
id

Идентификатор товара.

Обязательный атрибут.

available

Возможность купить товар:

  • true — товар есть в наличии;
  • false — товара нет в наличии.

Элементы, входящие в <offer>

ЭлементОписание
name

Название товарного предложения. В названии упрощенного предложения рекомендуется указывать наименование и код производителя.

Обязательный элемент.

url

URL страницы товара.

Обязательный элемент.

picture

Ссылка на картинку.

Обязательный элемент для смарт-баннеров.

price

Цена, по которой данный товар можно приобрести.

Рекомендуемый элемент.

currencyId

Код валюты (RUB, USD, UAH, KZT).

Обязательный элемент, если есть элемент price.

model

Модель.

vendor

Производитель.

vendorCode

Код товара (указывается код производителя).

description

Описание товарного предложения.

categoryId

Идентификатор категории товара, присвоенный рекламодателем (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории.

Обязательный элемент. Элемент <offer> может содержать только один элемент <categoryId>.

market_category

Категория товара, в которой он должен быть размещен на Яндекс.Маркете.

store

Возможность купить товар в розничном магазине:

  • true — товар можно купить в розничном магазине;

  • false — возможность покупки в розничном магазине отсутствует.

pickup

Возможность самовывоза из пунктов выдачи:

  • true — товар можно забрать самостоятельно;

  • false — возможность самовывоза отсутствует.

delivery

Возможность курьерской доставки товара:

  • true — возможна курьерская доставка;

  • false — товар не может быть доставлен курьером.

oldprice

Старая цена на товар, которая обязательно должна быть выше новой цены (price).

sales_notes

Информация о заказе:

  • минимальной сумме заказа, минимальной партии товара, необходимости предоплаты;

  • вариантах оплаты, описания акций и распродаж.

manufacturer_warranty

Наличие гарантии:

  • true — товар имеет официальную гарантию;

  • false — товар не имеет официальной гарантии.

country_of_origin

Страна производства товара.

adult

Товар относиться к категории «для взрослых»:

  • true — да;

  • false — нет.

age

Возрастная категория товара.

downloadable

Возможность скачать товар:

  • true — товар можно скачать;

  • false — товар нельзя скачать.

Отели: фид «Отели и аренда жилья» Google Рекламы

Фид «Отели и аренда жилья» Google Рекламы в формате CSV должен использоваться для типа бизнеса «Отели». Первая строка содержит названия столбцов, а следующие строки ― сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример:

Скачать пример фида для отелей в формате CSV

Элементы, входящие в CSV

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров или динамических объявлений.

ЭлементОписание

Property ID

Идентификатор отеля.

Обязательный элемент.

Property name

Название отеля.

Обязательный элемент.

Final URL

URL страницы предложения.

Обязательный элемент.

Destination name

Местоположение отеля (не более 25 символов).

Обязательный элемент.

Image URL

Ссылка на изображение. Рекомендуемый размер изображения — минимум 500 пикселей по одной из сторон.

Обязательный элемент для смарт-баннеров.

Price

Цена предложения. Число и код валюты (RUB, USD, UAH, KZT). Используйте точку (.) в качестве десятичного разделителя.

Рекомендуемый элемент.

Star rating

Количество звезд. Целое число от 1 до 5.

Score

Пользовательская оценка, число. Используйте точку (.) в качестве десятичного разделителя.

Max score

Максимально возможная оценка, целое число. По умолчанию 5.

Facilities

Услуги отеля. Укажите значения через точку с запятой: бар;бассейн;бесплатный Wi-Fi

Примечание. Значения, содержащие запятую, нужно заключить в кавычки (""). Например, "Москва, центр".
Автомобили: фид Авто.ру

Фид Авто.ру в формате XML должен использоваться для типа бизнеса «Автомобили». Данные в фиде должны быть в кодировке UTF-8.

Полное описание формата XML легковых авто (zip-архив, 897 КБ)

Список предложений рекламодателя содержится в элементе <cars>. Каждый автомобиль описывается отдельным элементом <car>.

Пример:
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Ford</mark_id>
            <folder_id>Fusion</folder_id>
            <modification_id>1.4d AT (68 л.с.)</modification_id>
            <url>http://www.auto.ru/1</url>
            <images>http://picture.auto.ru/1.jpg</images>
            <body_type>Хэтчбек 5 дв.</body_type>
            <color>красный</color>
            <availability>в наличии</availability>
            <custom>растаможен</custom>
            <year>2015</year>
            <price>575000</price>
            <currency>RUR</currency>
            <vin>XWBCA41ZXDK259205</vin>
         </car>
     </cars>
</data>

Элементы, входящие в <car>

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров или динамических объявлений.

ЭлементОписание
unique_id

Идентификатор товарного предложения.

Обязательный элемент, если нет элемента vin.

vin

VIN автомобиля (17 символов).

Обязательный элемент, если нет элемента unique_id

url

Ссылка на страницу товарного предложения.

Обязательный элемент.

images

Ссылка на изображение конкретной модели/модификации модели.

Обязательный элемент для смарт-баннеров.

price

Цена, по которой автомобиль можно приобрести.

Рекомендуемый элемент.

currency

Код валюты (RUB, USD, UAH, KZT).

Обязательный элемент, если есть элемент price.

mark_id

Наименование марки автомобиля.

folder_id

Наименование модели.

modification_id

Наименование модификации.

body_type

Тип кузова.

year

Год выпуска.

Недвижимость: фид Яндекс.Недвижимости

Фид Яндекс.Недвижимости в формате YRL (Yandex Realty Language) должен использоваться для типа бизнеса «Недвижимость». Подробнее о формате YRL в Помощи Яндекс.Недвижимости.

Список предложений о продаже недвижимости рекламодателя содержится в элементе <offers>. Каждое товарное предложение (квартира) описывается отдельным элементом <offer>.

В одном фиде можно передавать информацию о разных ЖК разных застройщиков. Для этого укажите в каждом <offer> правовую информацию о застройщике в элементе <sales-agent>.

Внимание.

Мы не принимаем фиды с предложениями об аренде недвижимости.

Пример:
<offer internal-id="15782295">
  <type>продажа</type>
  <property-type>жилая</property-type>
  <category>квартира</category>
  <url>http://www.developer.ru/search18</url>
  <creation-date>2015-04-02T19:00:06+03:00</creation-date>
  <location>    
    <locality-name>Санкт-Петербург</locality-name>
    <sub-locality-name>о. Васильевский</sub-locality-name>
    <address>18-я линия В.О., 32</address>
    <metro>
      <name>Василеостровская</name>
      <time-on-foot>10</time-on-foot>
      <time-on-transport>5</time-on-transport>
   </metro>
  </location>
  <price>
    <value>4780000</value>
    <currency>RUR</currency>
  </price>
  <sales-agent>    
    <organization>ЗАО "Застройщик"</organization>    
  </sales-agent>
  <floor>13</floor>
  <floors-total>15</floors-total>
  <area>
    <value>63.00</value>
    <unit>кв. м</unit>
  </area>
  <building-name>Северная фантазия</building-name>
  <image>http://www.developer.ru/images/plans/000001289.jpg</image>
</offer>

Атрибуты элемента <offer>

АтрибутОписание
internal-id

Идентификатор товарного предложения.

Обязательный атрибут.

Элементы, входящие в <offer>

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров или динамических объявлений.

ЭлементОписание
type

Тип сделки.

Значение — только продажа.

Обязательный элемент.

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

Ссылка на изображение. Если в фиде указано несколько изображений, будет использовано первое.

Обязательный элемент для смарт-баннеров.

building-name

Название жилого комплекса. По этому элементу квартиры объединяют в ЖК.

Если название ЖК неизвестно, укажите улицу и номер дома (Ленина, 25)

Обязательный элемент.

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

Этаж.

Рекомендуемый элемент.

Авиабилеты: фид «Авиабилеты» Google Рекламы

Фид «Авиабилеты» Google Рекламы в формате CSV должен использоваться для типа бизнеса «Авиабилеты». Первая строка содержит названия столбцов, а следующие строки ― сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример:

Скачать пример фида для авиабилетов в формате CSV

Элементы, входящие в CSV

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров или динамических объявлений.

ЭлементОписание

Destination ID

Идентификатор пункта назначения.

Обязательный элемент.

Destination name

Название пункта назначения.

Обязательный элемент.

Origin ID

Идентификатор пункта отправления.

Если вы указываете в фиде Origin ID и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте Origin ID и Destination ID через дефис. Например, "id": "VKO-LHR".

Origin name

Название пункта отправления.

Final URL

URL страницы предложения.

Обязательный элемент.

Image URL

Ссылка на изображение. Рекомендуемый размер изображения — минимум 500 пикселей по одной из сторон.

Обязательный элемент для смарт-баннеров.

Flight price

Цена предложения. Число и код валюты (RUB, USD, UAH, KZT). Используйте точку (.) в качестве десятичного разделителя.

Рекомендуемый элемент.

Другой бизнес: универсальный фид

Универсальный фид в формате CSV может использоваться в типе «Другой бизнес». Первая строка содержит названия столбцов, а следующие строки — сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример

Скачать пример универсального фида в формате CSV

Элементы, входящие в CSV

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров.

ЭлементОписание

ID

Идентификатор предложения.

Обязательный элемент.

ID2

Второй идентификатор предложения.

Если вы указываете в фиде ID2 и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте ID и ID2 через дефис. Например, "id": "VKO-LHR".

URL

URL страницы предложения.

Обязательный элемент.

Image

Ссылка на изображение. Рекомендуемый размер изображения — минимум 500 пикселей по одной из сторон.

Обязательный элемент для смарт-баннеров.

TitleНазвание предложения.
Description

Описание предложения.

Price

Цена предложения без валюты. Используйте точку (.) в качестве десятичного разделителя.

Рекомендуемый элемент.

Currency

Код валюты (RUB, USD, UAH, KZT).

Обязательный элемент, если есть элемент Price.

Old Price

Старая цена предложения, которая обязательно должна быть выше новой цены (Price).

Другой бизнес: фид «Специальный» Google Рекламы

Фид «Специальный» Google Рекламы в формате CSV может использоваться в типе «Другой бизнес». Первая строка содержит названия столбцов, а следующие строки — сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример

Скачать пример фида «Специальный» Google Рекламы в формате CSV

Элементы, входящие в CSV

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров.

ЭлементОписание

ID

Идентификатор предложения.

Обязательный элемент.

ID2

Второй идентификатор предложения.

Если вы указываете в фиде ID2 и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте ID и ID2 через дефис. Например, "id": "VKO-LHR".

Final URL

URL страницы предложения.

Обязательный элемент.

Image URL

Ссылка на изображение. Рекомендуемый размер изображения — минимум 500 пикселей по одной из сторон.

Обязательный элемент для смарт-баннеров.

Item title

Название предложения.

Item description

Описание предложения.

Price

Цена предложения с кодом валюты в кодировке ISO 4217 (RUB, USD, UAH, KZT). Используйте точку (.) в качестве десятичного разделителя.

Рекомендуемый элемент.

Sale price

Новая цена предложения, которая обязательно должна быть ниже старой цены (Price).

Другой бизнес: фид «Путешествия» Google Рекламы

Фид «Путешествия» Google Рекламы в формате CSV может использоваться в типе «Другой бизнес». Первая строка содержит названия столбцов, а следующие строки — сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример

Скачать пример фида «Путешествия» Google Рекламы в формате CSV

Элементы, входящие в CSV

В таблице ниже описаны элементы фида, которые используются для создания смарт-баннеров.

ЭлементОписание

Destination ID

Идентификатор пункта назначения.

Обязательный элемент.

Destination name

Название пункта назначения.

Origin ID

Идентификатор пункта отправления.

Если вы указываете в фиде Origin ID и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекта Origin ID и Destination ID через дефис. Например, "id": "MOS-AMS".

Origin name

Название пункта отправления.

Final URL

URL страницы предложения.

Обязательный элемент.

Image URL

Ссылка на изображение. Рекомендуемый размер изображения — минимум 500 пикселей по одной из сторон.

Обязательный элемент для смарт-баннеров.

Title

Название предложения.

Price

Цена предложения с кодом валюты в кодировке ISO 4217 (RUB, USD, UAH, KZT). Используйте точку (.) в качестве десятичного разделителя.

Рекомендуемый элемент.

Sale price

Новая цена предложения, которая обязательно должна быть ниже старой цены (Price).

Добавление фида

Чтобы добавить фид, на странице со списком кампаний перейдите по ссылке Фиды. На странице Управление фидами нажмите кнопку +Добавить фид и выберите тип вашего бизнеса.

Для передачи фида в Директ добавьте ссылку на файл или загрузите файл. Можно добавить до 20 фидов.

Разместите фид на сайте вашего магазина. Размер фида не должен превышать 512 Мб. Файл один раз в сутки скачивается роботом, и обновленные данные импортируются в Директ. Для генерации смарт-баннеров или динамических объявлений робот проверяет фид дополнительно для отбора товарных предложений по заданным фильтрам один раз в сутки или чаще, если это возможно. Для больших фидов время между проверками может быть увеличено.

Файл должен быть доступен по протоколу HTTP, HTTPS или FTP. Для доступа к нему вы можете использовать авторизацию. В этом случае во время загрузки фида укажите логин и пароль. При изменении URL или авторизационных данных вам необходимо внести соответствующие изменения в параметры фида в интерфейсе Директа.

Если в ссылках в фиде указаны UTM-метки, которые не подходят для отслеживания рекламной кампании, мы рекомендуем удалить их. Для этого установите флажок Автоматически удалять UTM-метки. Добавить новые UTM-метки можно на странице редактирования группы объявлений (кнопка +Добавить параметры к ссылкам).

Вы можете разместить фид в архиве, созданном с помощью алгоритма сжатия ZIP (расширение .zip) или GNU ZIP (расширение .gz).

Если произошла ошибка при добавлении фида (например, размер, формат фида или ссылка на него не соответствуют требованиям), вы увидите статус «Ошибка загрузки» и ссылку на отчет об ошибках.

Валидация файла

При чтении файла проверяются следующие условия:

  • присутствуют все обязательные элементы;
  • все названия элементов являются корректными;
  • каждый элемент присутствует не более одного раза.

При невыполнении любого из этих условий файл отклоняется.

Если вы измените ссылку или параметры авторизации, файл автоматически отправится на повторную валидацию.