Обязательные, необязательные и недопустимые элементы. Использование тэга HTML5 picture для адаптивных изображений

Продолжаем серию статей про настройку динамических поисковых кампаний (Dynamic Search Ads). Ранее я писал про DSA для Google Рекламы . Сегодня рассмотрим элементы и примеры фидов для Яндекс.Директ.

Товарный фид — файл с данными о всех товарах на сайте и их атрибутах (уникальные идентификаторы, ссылки на товары и их изображения).

Категории фидов в Яндекс.Директ

В сервисе доступны такие категории фидов:

«Розничная торговля».
«Отели».
«Недвижимость».
«Автомобили».
«Авиабилеты».

Как подготовить фид для «Розничной торговли»

Сформируйте фид в формате YML. Любой XML-документ может содержать только один корневой элемент.

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

http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc& 889.00 17000.00 UAH 1111 http://89.123.45.678/catalog/photo/19/6.JPG false false true Принтер НP Deskjet D2663 Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати... Необходима предоплата. true Япония

Как составить фид для «Отелей»

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

Элемент	Описание
	Идентификатор отеля. Обязательный элемент.
	Название отеля. Обязательный элемент.
	URL страницы предложения. Обязательный элемент.
Destination name	Местоположение отеля (не более 25 символов). Обязательный элемент.

	Цена предложения. Число и код валюты в кодировке ISO 4217. Используйте точку (.) в качестве десятичного разделителя. Рекомендуемый элемент.
	Количество звезд. Целое число от 1 до 5.
	Пользовательская оценка, число. Используйте точку (.) в качестве десятичного разделителя.
	Максимально возможная оценка, целое число. По умолчанию 5.
	Услуги отеля. Укажите значения через точку с запятой: бар; бассейн; бесплатный Wi-Fi.

Значения с запятой заключите в кавычки ("").

Как подготовить фид для «Недвижимости»

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

В одном фиде можно передавать информацию о жилых комплексах разных застройщиков. Для этого укажите в каждом правовую информацию о застройщике в элементе .

Элемент	Описание
	Обязательный элемент.
	Тип сделки. Значение — только «продажа». Обязательный элемент.
	Набор элементов, описывающих местоположение объекта. Во вложенных тегах — детали информации об адресе объекта. Обязательный элемент.
	Название населенного пункта. Обязательный элемент.
sub-locality-name

	Ближайшая станция метро. Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах укажите подробную информацию. Рекомендуемый элемент.

time-on-transport	Время до метро в минутах на транспорте.

	Обязательный элемент.
	Обязательный элемент.
	Набор элементов, описывающих стоимость объекта. Во вложенных тегах — цена и валюта, в которой указана стоимость: Рекомендуемый элемент.


	Название жилого комплекса. По этому элементу квартиры объединяют в ЖК. Если название ЖК неизвестно, укажите улицу и номер дома (например, Пушкинская, 25). Обязательный элемент.
	Информация о застройщике. Во вложенных тегах укажите подробную информацию. Обязательный элемент.
	Полное название юридического лица застройщика. Обязательный элемент.
	Общая площадь. Значение и единица измерения площади передаются во вложенных тегах.

	Единица площади помещения. Элемент используется, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m».

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

продажа жилая квартира http://www.developer.ru/search18 2015-04-02T19:00:06+03:00 Санкт-Петербург о. Васильевский

18-я линия В.О., 32

Василеостровская

4780000 UAH

ЗАО "Застройщик"

63.00 кв. м

Северная фантазия

http://www.developer.ru/images/plans/000001289.jpg

Как сформировать фид для «Автомобилей»

Элемент	Описание
	Идентификатор товарного предложения. Обязательный элемент, если нет элемента vin.
	Марка автомобиля. Обязательный элемент.
	Наименование модели. Обязательный элемент.
	Наименование модификации. Обязательный элемент.
	Обязательный элемент.
	Обязательный элемент.
	Тип кузова. Обязательный элемент.
	Год выпуска. Обязательный элемент.
	Цена автомобиля. Обязательный элемент.
	Валюта, в которой указана цена. Обязательный элемент.
	VIN-номер (17 символов).

Пример фида:

Ford Fusion 1.4d AT (68 л.с.) http://www.auto.ru/1 http://picture.auto.ru/1.jpg Хэтчбек 5 дв. красный в наличии растаможен 2015 575000 UAH XWBCA41ZXDK259205

Как подготовить фид для «Авиабилетов»

Элемент	Описание
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент (для смарт-баннеров).
	Цена предложения. Число и код валюты в кодировке ISO 4217. Используйте точку (.) в качестве десятичного разделителя.
	Идентификатор пункта назначения. Обязательный элемент.
	Идентификатор пункта отправления.
Destination name	Название пункта назначения. Обязательный элемент.
	Название пункта отправления.

Как добавить фид

Для добавления фида в Яндекс.Директ перейдите в интерфейсе по ссылке «Фиды» внизу под кампаниями.

Затем нажмите «Добавить фид».

Как добавить фид по ссылке

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

Файл должен быть доступен по протоколу HTTP, HTTPS или FTP. Для доступа используйте авторизацию.

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

Как добавить файл с фидом

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

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

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

Как происходит валидация фида

Валидация — комплексная проверка соблюдения требований.

Условия проверки при чтении файла:

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

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

Вывод

Мы рассмотрели все варианты и форматы фидов для настройки динамических кампаний в Яндекс Директ.

Напомню, для правильного создания фида:

Определите ваш тип бизнеса.
Настройте фид в зависимости от типа бизнеса.
Совет: чем больше полей заполнено в фиде, тем лучше система сможет определить нужного пользователя.
Загрузите фид в аккаунт Яндекс.Директ.

В следующей статье я расскажу, как настроить кампании с таргетингом на содержание сайта и на фид страниц.

Самый простой вариант "адаптировать" картинку - задать ширину 100% а высоту рассчитывать автоматически. Наше изображение никогда не будет шире родительского блока, при этом браузер будет ресайзить его с сохранением пропорций. Недостаток этого способа в том что и мобилке и дэсктопу отдаётся одна и таже, большая картинка. Будет лучше если на смартфон будет отправлена картинка меньшего размера. Таким образом мы экономим трафик посетителю и ускоряем загрузку страницы.

Тег

Adaptive Images

Adaptive Images интересное решение учитывая простоту установки и отсутствие заморочек с изменением разметки. Определяет размер экрана посетителя и вставляет на страницу нужное изображение.

В установке нет ничего сложного. Скачиваем дистрибутив с сайта http://adaptive-images.com/. Копируем файлы adaptive-images.php и.htaccess в корень сайта. Скорее всего в корне уже лежит файл.htaccess. В этом случае отредактируйте его но прежде сделайте копию на всякий случай. Если в вашем.htaccess файле есть раздел который начинается с

вставьте в этот раздел то, что содержится между # Adaptive-Images и # END Adaptive-Images. Если же такого раздела нет, то скопируйте содержимое целиком.
В раздел нужно вставить следующий JS код

< script> document.cookie = "resolution=" + Math .max (screen.width , screen.height ) + "; path=/" ;

Этот код должен загружаться раньше других скриптов.
Последний шаг - конфигурация файла adaptive-images.php. В переменной $resolution - указывается ширина экранов. Как правило задаются размеры указанные в медиа-запросах в CSS. $cashe_path путь к папке куда будут складываться изменённые изображения.

Теперь о том как всё это работает. Размер окна посетителя определяется JavaScript размещённом в разделе . Эта информация записывается в куки. Когда браузер встречает на странице тег и отправляет запрос на сервер чтобы получить изображение он отправляет куки. Веб-сервер Apache получив запрос на изображение смотрит есть ли у него какие нибудь специальные инструкции для файлов. В.htaccess у нас есть правило по которому сервер любой запрос на jpg, png или gif отправляет в adaptive-images.php. PHP файл ищет куки и узнаёт какой размер экрана. Дальше происходит сравнение значения из куки со значениями прописанными в переменной $resolution и выбирается лучшее значение. Предположим было выбрано значение 480px. Отресайзенная картинка должна находиться в папке /ai-cashe/480/. Если её там нет то будет запрошен исходный файл и если его ширина будет меньше ширины экрана то по посетителю отдадут исходный файл. Если размер больше, то файл уменьшается до нужного размера и посылается пользователю. Изменённая копия сохраняется, чтобы в следующий раз не ресайзить.

Ещё пара способов сделать адаптивные изображения

Просматривая возможные решения я обратил внимание что все они были предложены до элемента Этот новый элемент предлагает лучший вариант решения проблемы адаптивных картинок.

Adaptive Image - простой в настройке. Это хорошая альтернатива если нет желания заморачиваться с кучей файлов, создавая по три файла на каждую картинку. Хотя этот плюс может обратиться в минус. Часто уменьшая большие фотографии в конечном итоге лучше вырезать какую-то часть чем просто отресайзить. Ещё один минус Adaptive Image - нагрузка на сервер.

Кстати, если ваш на сайт работает на Drupal в следующей статье попробуем внедрить И максимально автоматизировать процесс ресайза картинок.

Особенностью гибких документов является непостоянный состав полей на различных изображениях. Поэтому при создании элемента следует иметь в виду, что объект(ы), описываемый данным элементом может отсутствовать на некотором изображении, поэтому найти его не удастся. Также возможно повреждение изображения при сканировании, такое как зачернение или, наоборот, осветление отдельных участков изображения, приводящее к утере информации. В таком случае объект, соответствующий элементу, также не будет найден. Программа FlexiLayout Studio позволяет при отсутствии элемента на изображении продолжить поиск других элементов. Для того, чтобы разрешить наложение описания на изображение в случае, если некоторый объект не найден, нужно сделать его необязательным.

Объекты изображения, описанные с помощью обязательных элементов, должны присутствовать на изображении, и программа должна найти их при наложении гибкого описания . Если же такой объект не будет найден на изображении, процесс наложения описания прекращается.

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

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

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

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

Замечание. В отличие от простых элементов все групповые элементы по умолчанию обязательны.

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

Таким образом, элементы могут использоваться для идентификации документа (обязательные), поиска блоков (обязательные и необязательные) и для отбрасывания неверных гипотез (недопустимые элементы).

Выбор варианта использования элемента осуществляется в диалоге свойств элемента (вкладка General ).

Изображения обязательных и недопустимых элементов выделяются следующим образом.

В девелоперских сборках браузеров Chrome, Firefox и Opera появилась поддержка нового элемета picture , призванного решить ряд проблем возникающих при разработке адаптивных дизайнов. Давайте рассмотрим его подробнее.

Новый элемент picture , решает следующие задачи, встающие перед разработчиком адаптивных веб-приложений (я воспользуюсь классификацией, предложенной pepelsbey на одной из недавних конференций по фронтенду):

Р етина, т.е. экраны с плотностью точек на дюйм 150 и выше, на которых обычное изображение выглядит размыто
А даптивность, задача изменения размеров изображения согласно вашим правилам, прописанным в дизайне в зависимости от размера вьюпорта.
Ф ормат, возможность использовать современные форматы, такие как WebP, если они поддерживаются браузером
К адрирование или Художественные цели. Обрезка маловажных частей изображения, при показе на устройствах с меньшим экраном.

Сложив первые буквы, получаем мнемонику РАФК

Синтаксис

Условно, расширенный синтаксис нового элемента выглядит так

Элемент picture не рендерит никакой контент, а лишь является справочным контейнером для вложенного в него тега img .

Поэтому для большинства задач хватит сокращенной записи, совсем без использования picture

Давайте рассмотрим как решаются вышеозначенные проблемы с помощью нового элемента. Все файлы примеров можно найти в этом репозитории github.com/fetis/picture

Для тестирования примеров из данной статьи на десктопе вам понадобятся либо Firefox Nighlty (поддержка picture включается настройкой dom.image.picture.enable в about:config), либо Chrome Canary , либо Opera Developer . На мобильном устройстве новый элемент можно протестировать в Chrome Beta

Ретина

У нас есть изображение 400х300 пкс, которое мы хотим также красиво показывать при двукратной и трехкратной плотности пикселей. Для этого готовим еще 2 картинки, размерами 800x600 и 1200х900 и пишем следующий код

2x и 3x это дескрипторы плотностей пикселей , они говорят браузеру, что вот эти картинки были подготовлены для вот этой плотности, если хочешь, можешь использовать. Обратите внимание, они не заставляют бразуер использовать эти картинки, а только подсказывают ему. Окончательное решение остается за ним в зависимости от других условий, например, текущего соединения.

Атрибут src в данном случае служит источником картинки для плотности < 2 и фолбеком на случай, если браузер не поддерживает новый элемент.

Адаптивность

Представим раскладку, в которой есть единственная контрольная точка (breakpoint) 700пкс. При размере вьюпорта более 700 пкс мы показываем справа сайдбар и размер нашего изображения должен быть 75% от ширины экрана. В противном случае сайдбар располагается в конце страницы и изображение должно быть растянуто на всю ширину. Это реализуется следующим кодом

400w, 800w, 1200w - это дескрипторы ширины , они подсказывают браузеру картинка какой ширины находится по данному URL и на основе этой информации браузер принимает решение какое изображение лучше всего подойдет в текущей ситуации. Как и в случае с ретиной информация носит рекомендательный характер и окончательное решение какое изображение грузить остается за браузером.

Одновременное использование дескрипторов плотности и ширины недопустимо.

В атрибуте sizes перечисляются размеры изображения для всех контрольных точек в нашем дизайне. Контрольные точки задаются в виде обычного медиавыражения, браузер берет первое, которое возвращает Истину и дальше цепочку не рассматривает. Для значения ширины используется новая единица длины vw , которая возвращает значение в процентах от ширины вьюпорта.

Если для картинки нет необходимости использовать контрольные точки, то запись можно сократить до такой sizes="100vw" . А для более сложных дизайнов можно использовать CSS-функцию calc() , например
sizes="(max-width: 30em) 100vw, (max-width: 50em) 50vw, calc(33vw - 100px)"

Самый сложный в поведении атрибут на мой взгляд. Если не указывать sizes , то браузер всегда выбирал самую большую картинку. В сочетании с width не работает, хотя казалось бы логичное сочетание и ряд других глюков. Возможно это особенности ранней реализации.

Как видите, мы уже покрыли 80% потребностей адаптивной верстки, а еще ни разу не использовали picture , настало время ему тоже вступить в игру.

Формат

Использование различных форматов для изображений мало отличается от способов используемых для тегов video или audio

Мы указываем список источников и mime/type для каждого, а браузер уже выбирает первый, который знает. В качестве фолбека используется изображения из атрибута src .

Кадрирование

Когда мы показываем фото на меньшем экране иногда имеет смысл обрезать лишние детали, оставив только основную часть. С этой задачей нам поможет справиться атрибут media

В каждом атрибуте media мы задаем медиавыражение, при котором у нас будет меняться исходное изображение и, в отличие от предыдущих примеров, браузер будет обязан ему следовать. Обратите также внимание как кадрирование здесь сочетается с адаптивностью, чтобы растянуть изображение на всю ширину.

РАФК

А теперь все 4 метода в одном флаконе:) Возможно так будет выглядеть вставка картинок через пару лет (пример из блога Оперы)

Здесь используются 2 формата JPEG и WebP. При ширине экрана более 1280 пкс показывается полноразмерная картинка в половину вьюпорта. При ширине от 640 до 1279 показывается обрезанное фото на 60% ширины вьюпорта. При ширине экрана меньше 640пкс показывается обрезанная фотография на 100% ширины. Выбор под текущее DPI экрана производится на основе ширины исходных файлов.

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

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

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

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

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

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

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

Упрощенный тип описания
Произвольный тип описания (vendor.model)

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

Пример: \n \n 1620.00\n 1800.00\n RUB\n 19\n \n false\n true\n false\n Антивирус ESET NOD32 Platinum Edition\n Eset\n NOD32-ENA-NS(BOX)-2-1\n Антивирус ESET NOD32 Platinum Edition - лицензия на 2 года NOD32-ENA-NS(BOX)-2-1\n Оплата: Наличные, Б/Н, пластиковые карты, кредит\n true\n Россия\n 18\n

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

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

Элемент	Описание
name	Название товарного предложения. В названии упрощенного предложения рекомендуется указывать наименование и код производителя. Обязательный элемент.
url	URL страницы товара. Обязательный элемент.
picture
price
currencyId
model
vendor	Производитель.
vendorCode
description
categoryId	.
market_category
store
pickup
delivery
oldprice
sales_notes	Информация о заказе:
manufacturer_warranty	Наличие гарантии:
country_of_origin	Страна производства товара.
adult
age
downloadable	Возможность скачать товар: true - товар можно скачать; false - товар нельзя скачать.

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

Пример: \nhttp://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc& \n889.00 \n17000.00 \nRUR \n1111 \n \nfalse \nfalse \ntrue \nПринтер \nНP \nDeskjet D2663 \nСерия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати... \nНеобходима предоплата. \ntrue \nЯпония \n

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

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

Атрибут

Описание

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

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

type

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

available

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

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

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

Атрибут

Описание

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

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

type

Тип описания предложения. Значение должно быть vendor.model .

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

available

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

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

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

Элемент	Описание
url	URL страницы товара. Обязательный элемент.
picture	Обязательный элемент для смарт-баннеров.
price	Цена, по которой данный товар можно приобрести.
currencyId	Код валюты (RUB , USD , UAH , KZT). Обязательный элемент, если есть элемент price .
model	Обязательный элемент.
vendor	Производитель. Обязательный элемент.
vendorCode	Код товара (указывается код производителя).
description	Описание товарного предложения.
typePrefix
categoryId	Обязательный элемент. Элемент может содержать только один элемент .
market_category
store	Возможность купить товар в розничном магазине: true - товар можно купить в розничном магазине; false - возможность покупки в розничном магазине отсутствует.
pickup	Возможность самовывоза из пунктов выдачи: true - товар можно забрать самостоятельно; false - возможность самовывоза отсутствует.
delivery	Возможность курьерской доставки товара: true - возможна курьерская доставка; false - товар не может быть доставлен курьером.
oldprice	Старая цена на товар, которая обязательно должна быть выше новой цены (price).
sales_notes	Информация о заказе: минимальной сумме заказа, минимальной партии товара, необходимости предоплаты; вариантах оплаты, описания акций и распродаж.
manufacturer_warranty	Наличие гарантии: true - товар имеет официальную гарантию; false - товар не имеет официальной гарантии.
country_of_origin	Страна производства товара.
adult
age
downloadable	Возможность скачать товар: true - товар можно скачать; false - товар нельзя скачать.

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

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

Элемент	Описание
	Идентификатор отеля. Обязательный элемент.
	Название отеля. Обязательный элемент.
	URL страницы предложения. Обязательный элемент.
Destination name	Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Price

Элемент	Описание
	Идентификатор отеля. Обязательный элемент.
	Название отеля. Обязательный элемент.
	URL страницы предложения. Обязательный элемент.
Destination name	Местоположение отеля (не более 25 символов). Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Price	Цена предложения. Число и код валюты (RUB , USD , UAH , KZT). Используйте точку (.) в качестве десятичного разделителя.
	Количество звезд. Целое число от 1 до 5.
	Пользовательская оценка, число. Используйте точку (.) в качестве десятичного разделителя.
	Максимально возможная оценка, целое число. По умолчанию 5.
	Услуги отеля. Укажите значения через точку с запятой: бар;бассейн;бесплатный Wi-Fi

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

Автомобили: фид Авто.ру

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

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

Внимание.

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

Пример: \n продажа\n жилая\n квартира\n http://www.developer.ru/search18\n 2015-04-02T19:00:06+03:00\n \n Санкт-Петербург\n о. Васильевский\n

18-я линия В.О., 32

\n \n Василеостровская\n 10\n 5\n \n \n \n 4780000\n RUR\n \n \n ЗАО \"Застройщик\" \n \n 13\n 15\n \n 63.00\n кв. м\n \n Северная фантазия\n http://www.developer.ru/images/plans/000001289.jpg\n

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

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

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

Элемент	Описание
type	Тип сделки. Значение - только продажа. Обязательный элемент.
location	\n \n \n \n …\n Обязательный элемент.
locality-name	Название населенного пункта. Обязательный элемент.
sub-locality-name
address
metro	Ближайшая станция метро. \n \n \n \n
name
time-on-transport
time-on-foot
url	Обязательный элемент.
image	Обязательный элемент для смарт-баннеров.
building-name	Обязательный элемент.
sales-agent	\n \n Обязательный элемент.
organization	Обязательный элемент.
price	\n \n \n
value
currency	Код валюты (RUB , USD , UAH , KZT).
area	Общая площадь. \n \n \n
value
unit	Единица площади помещения.
floor

Элемент	Описание
type	Тип сделки. Значение - только продажа. Обязательный элемент.
location	Набор элементов, описывающих местоположение объекта. Во вложенных тегах детализируется информация об адресе объекта. \n \n \n \n …\n Обязательный элемент.
locality-name	Название населенного пункта. Обязательный элемент.
sub-locality-name
address
metro	Ближайшая станция метро. Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация. \n \n \n \n
name
time-on-transport	Время до метро в минутах на транспорте.
time-on-foot
url	Обязательный элемент.
image	Обязательный элемент для смарт-баннеров.
building-name	Название жилого комплекса. По этому элементу квартиры объединяют в ЖК. Если название ЖК неизвестно, укажите улицу и номер дома (Ленина, 25) Обязательный элемент.
sales-agent	Информация о застройщике. Во вложенных тегах указывается подробная информация: \n \n Обязательный элемент.
organization	Наименование юридического лица застройщика. Обязательный элемент.
price	Набор элементов, описывающих стоимость объекта. Во вложенных тегах указывается цена и валюта, в которой указана стоимость: \n \n \n
value
currency	Код валюты (RUB , USD , UAH , KZT). Обязательный элемент, если есть элемент value .
area	Общая площадь. Значение и единица измерения площади передаются во вложенных тэгах: \n \n \n
value
unit	Единица площади помещения. Элемент используется, если цена указана за единицу площади. Возможные значения: кв. м / sq. m .
floor

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

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

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

Элемент	Описание
	Обязательный элемент.
Destination name	Название пункта назначения. Обязательный элемент.
	электронную коммерцию
	Название пункта отправления.
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Flight price	Цена предложения. Число и код валюты (RUB , USD , UAH , KZT). Используйте точку (.) в качестве десятичного разделителя.

Элемент	Описание
	Идентификатор пункта назначения. Обязательный элемент.
Destination name	Название пункта назначения. Обязательный элемент.
	Идентификатор пункта отправления. Если вы указываете в фиде Origin ID и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте Origin ID и Destination ID через дефис. Например, \"id\": \"VKO-LHR\" .
	Название пункта отправления.
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Flight price	Цена предложения. Число и код валюты (RUB , USD , UAH , KZT). Используйте точку (.) в качестве десятичного разделителя.

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

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

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

Элемент	Описание
	Идентификатор предложения. Обязательный элемент.
	электронную коммерцию
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Title	Название предложения.
Description	Описание предложения.

Currency Идентификатор предложения. Обязательный элемент.
	Второй идентификатор предложения. Если вы указываете в фиде ID2 и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте ID и ID2 через дефис. Например, \"id\": \"VKO-LHR\" .
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Title	Название предложения.
Description	Описание предложения.
	Цена предложения без валюты. Используйте точку (.) в качестве десятичного разделителя.
Currency	Код валюты (RUB , USD , UAH , KZT). Обязательный элемент, если есть элемент Price .
	Старая цена предложения, которая обязательно должна быть выше новой цены (Price).	Описание
	Идентификатор предложения. Обязательный элемент.
	Второй идентификатор предложения. Если вы указываете в фиде ID2 и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте ID и ID2 через дефис. Например, \"id\": \"VKO-LHR\" .
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Item title	Название предложения.
Item description	Описание предложения.

	В Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекте ID и ID2 через дефис. Например, \"id\": \"VKO-LHR\" .
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
Item title	Название предложения.
Item description	Описание предложения.
	Цена предложения с кодом валюты в кодировке ISO 4217 (RUB, USD, UAH, KZT). Используйте точку (.) в качестве десятичного разделителя.
	Новая цена предложения, которая обязательно должна быть ниже старой цены (Price).

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

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

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

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

Элемент	Описание
	Идентификатор пункта назначения. Обязательный элемент.
Destination name	Название пункта назначения.
	Идентификатор пункта отправления. Если вы указываете в фиде Origin ID и подключили электронную коммерцию
	Название пункта отправления.
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
	Название предложения.
	Идентификатор пункта назначения. Обязательный элемент.
Destination name	Название пункта назначения.
	Идентификатор пункта отправления. Если вы указываете в фиде Origin ID и подключили электронную коммерцию в Яндекс.Метрике, используйте в качестве идентификатора предложения в Ecommerce-объекта Origin ID и Destination ID через дефис. Например, \"id\": \"MOS-AMS\" .
	Название пункта отправления.
	URL страницы предложения. Обязательный элемент.
	Обязательный элемент для смарт-баннеров.
	Название предложения.
	Цена предложения с кодом валюты в кодировке ISO 4217 (RUB , USD , UAH , KZT). Используйте точку (.) в качестве десятичного разделителя.
	Новая цена предложения, которая обязательно должна быть ниже старой цены (Price).

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

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

Ссылка на файл
Загрузить файл

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

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

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

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

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

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