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

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

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

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

Тип фида Тип бизнеса Для чего
Фид Яндекс.Маркета (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

Тип сделки.

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

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