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

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

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

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

Розничная торговля

Для типа бизнеса Розничная торговля фид должен быть предоставлен в формате YML. Этот формат разработан в Яндексе и рекомендован для размещения информации в Яндекс.Маркете. Подробнее о формате YML в Помощи Яндекс.Маркета.

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

Список товарных предложений рекламодателя содержится в элементе <offers>. Каждое товарное предложение описывается отдельным элементом <offer>. Элемент может использоваться с атрибутом available, обозначающим товары в наличии.

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

Пример:

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


Элемент	Описание
name	Название товарного предложения. В названии упрощенного предложения рекомендуется указывать наименование и код производителя. Обязательный элемент.
model	Модель.
vendor	Производитель.
vendorCode	Код товара (указывается код производителя).
id	Идентификатор товара. Обязательный элемент.
url	URL страницы товара. Обязательный элемент.
price	Цена, по которой данный товар можно приобрести. Обязательный элемент.
oldprice	Старая цена на товар, которая обязательно должна быть выше новой цены (`price`).
currencyId	Валюта (RUR, USD, UAH, KZT). Обязательный элемент.
categoryId	Идентификатор категории товара, присвоенный рекламодателем (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории. Обязательный элемент. Элемент `<offer>` может содержать только один элемент `<categoryId>`.
market_category	Категория товара, в которой он должен быть размещен на Яндекс.Маркете.
picture	Ссылка на картинку. Обязательный элемент.
store	Возможность купить товар в розничном магазине: `true` — товар можно купить в розничном магазине; `false` — возможность покупки в розничном магазине отсутствует.
pickup	Возможность самовывоза из пунктов выдачи: `true` — товар можно забрать самостоятельно; `false` — возможность самовывоза отсутствует.
delivery	Возможность курьерской доставки товара: `true` — возможна курьерская доставка; `false` — товар не может быть доставлен курьером.
description	Описание товарного предложения.
sales_notes	Информация о заказе: минимальной сумме заказа, минимальной партии товара, необходимости предоплаты; вариантах оплаты, описания акций и распродаж.
manufacturer_warranty	Наличие гарантии: `true` — товар имеет официальную гарантию; `false` — товар не имеет официальной гарантии.
country_of_origin	Страна производства товара.
adult	Товар относиться к категории «для взрослых»: `true` — да; `false` — нет.
age	Возрастная категория товара.
downloadable	Возможность скачать товар: `true` — товар можно скачать; `false` — товар нельзя скачать.

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

Пример:

<offer id="1234567" type="vendor.model" available="true"> 
<url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&amp;utm_source=ya_market&amp;utm_medium=cpc&amp</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> 
<store>false</store> 
<pickup>false</pickup> 
<delivery>true</delivery> 
<typePrefix>Принтер</typePrefix> 
<vendor>НP</vendor> 
<model>Deskjet D2663</model> 
<description>Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати...</description> 
<sales_notes>Необходима предоплата.</sales_notes> 
<manufacturer_warranty>true</manufacturer_warranty> 
<country_of_origin>Япония</country_of_origin> 
</offer>

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


Элемент	Описание
type	Тип описания предложения. Значение должно быть `vendor.model`. Обязательный элемент.
model	Модель. Обязательный элемент.
vendor	Производитель. Обязательный элемент.
vendorCode	Код товара (указывается код производителя).
typePrefix	Тип / категория товара (например, «мобильный телефон», «стиральная машина», «угловой диван»).
id	Идентификатор товара. Обязательный элемент.
url	URL страницы товара. Обязательный элемент.
price	Цена, по которой данный товар можно приобрести. Обязательный элемент.
oldprice	Старая цена на товар, которая обязательно должна быть выше новой цены (`price`).
currencyId	Валюта (RUR, USD, UAH, KZT). Обязательный элемент.
categoryId	Идентификатор категории товара, присвоенный рекламодателем (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории. Обязательный элемент. Элемент `<offer>` может содержать только один элемент `<categoryId>`.
market_category	Категория товара, в которой он должен быть размещен на Яндекс.Маркете.
picture	Ссылка на картинку. Обязательный элемент.
store	Возможность купить товар в розничном магазине: `true` — товар можно купить в розничном магазине; `false` — возможность покупки в розничном магазине отсутствует.
pickup	Возможность самовывоза из пунктов выдачи: `true` — товар можно забрать самостоятельно; `false` — возможность самовывоза отсутствует.
delivery	Возможность курьерской доставки товара: `true` — возможна курьерская доставка; `false` — товар не может быть доставлен курьером.
description	Описание товарного предложения.
sales_notes	Информация о заказе: минимальной сумме заказа, минимальной партии товара, необходимости предоплаты; вариантах оплаты, описания акций и распродаж.
manufacturer_warranty	Наличие гарантии: `true` — товар имеет официальную гарантию; `false` — товар не имеет официальной гарантии.
country_of_origin	Страна производства товара.
adult	Товар относиться к категории «для взрослых»: `true` — да; `false` — нет.
age	Возрастная категория товара.
downloadable	Возможность скачать товар: `true` — товар можно скачать; `false` — товар нельзя скачать.

Отели

Для типа бизнеса Отели вы можете использовать фид «Отели и аренда жилья» Google AdWords (формат CSV).

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

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

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

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


Элемент	Описание
Property ID	Идентификатор отеля. Обязательный элемент.
Property name	Название отеля. Обязательный элемент.
Final URL	URL страницы предложения. Обязательный элемент.
Destination name	Местоположение отеля (не более 25 символов). Обязательный элемент.
Image URL	Ссылка на изображение. Рекомендуемый размер изображения – минимум 500px по одной из сторон. Обязательный элемент (для смарт-баннеров).
Price	Цена предложения. Число и код валюты в кодировке ISO 4217. Используйте точку (.) в качестве десятичного разделителя. Рекомендуемый элемент.
Star rating	Количество звезд. Целое число от 1 до 5.
Score	Пользовательская оценка, число. Используйте точку (.) в качестве десятичного разделителя.
Max score	Максимально возможная оценка, целое число. По умолчанию 5.
Facilities	Услуги отеля. Укажите значения через точку с запятой: бар;бассейн; бесплатный Wi-Fi

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

Недвижимость

Для типа бизнеса Недвижимость фид должен быть представлен в формате 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	Идентификатор товарного предложения. Обязательный элемент.
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	Время до метро в минутах пешком. Рекомендуемый элемент.
image	Ссылка на изображение. Если в фиде указано несколько изображений, будет использовано первое. Обязательный элемент.
url	Ссылка на страницу товарного предложения. Обязательный элемент.
price	Набор элементов, описывающих стоимость объекта. Во вложенных тегах указывается цена и валюта, в которой указана стоимость: `<price> <value></value> <currency></currency> </price>` Рекомендуемый элемент.
value	Цена. Рекомендуемый элемент.
currency	Валюта, в которой указана цена. Рекомендуемый элемент.
building-name	Название жилого комплекса. По этому элементу квартиры объединяют в ЖК. Если название ЖК неизвестно, укажите улицу и номер дома (Ленина, 25) Обязательный элемент.
sales-agent	Информация о застройщике. Во вложенных тегах указывается подробная информация: `<sales-agent> <organization></organization> </sales-agent>` Обязательный элемент.
organization	Наименование юридического лица застройщика. Обязательный элемент.
area	Общая площадь. Значение и единица измерения площади передаются во вложенных тэгах: `<area> <value></value> <unit></unit> </area>` Рекомендуемый элемент.
value	Площадь. Указывается числовое значение. Рекомендуемый элемент.
unit	Единица площади помещения. Элемент используется, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m». Рекомендуемый элемент.
floor	Этаж. Рекомендуемый элемент.

Автомобили

Для типа бизнеса Автомобили вы можете использовать фид для Авто.ру (формат 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`.
mark_id	Наименование марки автомобиля. Обязательный элемент.
folder_id	Наименование модели. Обязательный элемент.
modification_id	Наименование модификации. Обязательный элемент.
url	Ссылка на страницу товарного предложения. Обязательный элемент.
images	Ссылка на изображение конкретной модели/модификации модели. Обязательный элемент.
body_type	Тип кузова. Обязательный элемент.
year	Год выпуска. Обязательный элемент.
price	Цена, по которой автомобиль можно приобрести. Обязательный элемент.
currency	Валюта, в которой указана цена. Обязательный элемент.
vin	VIN номер (17 символов).

Авиабилеты

Для типа бизнеса Авиабилеты вы можете использовать фид «Авиабилеты» Google AdWords (формат CSV).

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

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


Элемент	Описание
Final URL	URL страницы предложения. Обязательный элемент.
Image URL	Ссылка на изображение. Рекомендуемый размер изображения – минимум 500px по одной из сторон. Обязательный элемент (для смарт-баннеров).
Flight price	Цена предложения. Число и код валюты в кодировке ISO 4217. Используйте точку (.) в качестве десятичного разделителя. Рекомендуемый элемент.
Destination ID	Идентификатор пункта назначения. Обязательный элемент.
Origin ID	Идентификатор пункта отправления.
Destination name	Название пункта назначения. Обязательный элемент.
Origin name	Название пункта отправления.

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

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

Выберите тип бизнеса, для которого надо добавить фид: Розничная торговля, Отели, Автомобили, Недвижимость, Авиабилеты.

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

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

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

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

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

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

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

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

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

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

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

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