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

Директ

Директ Объявления и форматы Смарт-баннеры

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

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

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

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


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


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


Атрибут	Описание
`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` — товар нельзя скачать.


Элемент	Описание
`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` — товар нельзя скачать.

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

Пример:

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


Атрибут	Описание
`id`	Идентификатор товара. Обязательный атрибут.
`type`	Тип описания предложения. Значение должно быть `vendor.model`. Обязательный атрибут.
`available`	Возможность купить товар: `true` — товар есть в наличии; `false` — товара нет в наличии.


Атрибут	Описание
`id`	Идентификатор товара. Обязательный атрибут.
`type`	Тип описания предложения. Значение должно быть `vendor.model`. Обязательный атрибут.
`available`	Возможность купить товар: `true` — товар есть в наличии; `false` — товара нет в наличии.

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


Элемент	Описание
`url`	URL страницы товара. Обязательный элемент.
`picture`	Ссылка на картинку. Обязательный элемент для смарт-баннеров.
`price`	Цена, по которой данный товар можно приобрести. Рекомендуемый элемент.
`currencyId`	Код валюты (`RUB`, `USD`, `UAH`, `KZT`). Обязательный элемент, если есть элемент `price`.
`model`	Модель. Обязательный элемент.
`vendor`	Производитель. Обязательный элемент.
`vendorCode`	Код товара (указывается код производителя).
`description`	Описание товарного предложения.
`typePrefix`	Тип / категория товара (например, «мобильный телефон», «стиральная машина», «угловой диван»).
`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` — товар нельзя скачать.


Элемент	Описание
`url`	URL страницы товара. Обязательный элемент.
`picture`	Ссылка на картинку. Обязательный элемент для смарт-баннеров.
`price`	Цена, по которой данный товар можно приобрести. Рекомендуемый элемент.
`currencyId`	Код валюты (`RUB`, `USD`, `UAH`, `KZT`). Обязательный элемент, если есть элемент `price`.
`model`	Модель. Обязательный элемент.
`vendor`	Производитель. Обязательный элемент.
`vendorCode`	Код товара (указывается код производителя).
`description`	Описание товарного предложения.
`typePrefix`	Тип / категория товара (например, «мобильный телефон», «стиральная машина», «угловой диван»).
`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` — товар нельзя скачать.

Отели: фид «Отели и аренда жилья» AdWords

Фид «Отели и аренда жилья» Google AdWords в формате 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`


Элемент	Описание
`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`	Год выпуска.


Элемент	Описание
`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`	Этаж. Рекомендуемый элемент.


Элемент	Описание
`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`	Этаж. Рекомендуемый элемент.

Авиабилеты: фид «Авиабилеты» AdWords

Фид «Авиабилеты» Google AdWords в формате 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`). Используйте точку (.) в качестве десятичного разделителя. Рекомендуемый элемент.


Элемент	Описание
`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`).


Элемент	Описание
`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`).

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

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

Пример

Скачать пример фида «Специальный» AdWords в формате 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`).


Элемент	Описание
`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`).

Другой бизнес: фид «Путешествия» AdWords

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

Пример

Скачать пример фида «Путешествия» AdWords в формате 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`).


Элемент	Описание
`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-метки можно на странице редактирования группы объявлений (кнопка +Добавить параметры к ссылкам).

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

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

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