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

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

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

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

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

Для типа бизнеса Розничная торговля фид должен быть предоставлен в формате 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 — товар нельзя скачать.

Отели

Для типа бизнеса Отели вы можете использовать фид «Отели и аренда жилья» 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 ― это текстовый формат, предназначенный для представления табличных данных. Первая строка содержит названия столбцов, а следующие строки ― сами данные. Содержимое столбцов отделяется друг от друга запятой. Данные в фиде должны быть в кодировке UTF-8.

Пример:

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

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

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

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

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

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

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

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