Фиды для гостиниц поддерживаются в форматах XML и CSV/TSV. Примеры файлов представлены ниже.
Обязательные поля
| Название, тип и описание | Требования |
|---|---|
| hotel_id (строка) - уникальный идентификатор гостиницы в каталоге | Максимальное число символов: 128 ID должен быть уникальным в рамках одного товарного фида ID может включать все символы латинского алфавита в верхнем и нижнем регистре, символы нижнего подчеркивания и дефис, а также цифры Например: 322223 |
| name (строка) - название гостиницы | Максимальное число символов: 256 Например: IBIS Dynamo Moscow |
| url (строка) - ссылка на внешний сайт, на котором можно забронировать номер в гостинице | Ссылки должны быть рабочими, начинаться с http:// или https:// и размещаться на домене сайта вашей компании Они должны вести на правильную страницу услуги Например: https://example.ru/ |
| image (строка) - изображение гостиницы | |
url (строка) - URL изображения гостиницы (вложено в image) | Допустимые форматы файла изображения — JPEG, PNG, GIF, WEBP Рекомендуемый размер: 600px по большей стороне Минимальный размер: 300px по большей стороне Максимальный размер: 6000px по большей стороне Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: http://example.com/some.image_1.jpg При обновлении изображения обязательно измените ссылку на него, иначе изменения не будут распознаны
Изображение товара должно соответствовать требованиям Правил размещения рекламы. См. также Пояснения к Правилам размещения рекламы |
| location - месторасположение гостиницы | |
address (строка) - основной адрес гостиницы (вложено в location) | Максимальное число символов: 256 Например: Зеленая ул., 35 |
locality (строка) - населенный пункт, в котором находится гостиница (вложено в location) | Максимальное число символов: 256 Например: Санкт-Петербург |
region (строка) - регион, в котором находится гостиница (вложено в location) | Максимальное число символов: 256 Например: Санкт-Петербург |
(вложено в location) | Максимальное число символов: 256 Например: Россия |
| price (строка) - стоимость проживания в гостинице | Цена в виде числа с трехбуквенным кодом валюты согласно стандарту ISO 4217 через пробел В качестве десятичного разделителя необходимо использовать точку (.), а не запятую (,) Не указывайте валюту с помощью символов $, € или £ Значение поля должно быть более 0 Поддерживаемые коды валют:
Например: 1000000 RUB |
Необязательные поля
| Название, тип и описание | Требования |
|---|---|
metro (строка) - ближайшее метро (вложено в location)
| |
name (строка) - название станции метро. Может быть до 4 станций. Каждая станция в отдельном теге <metro> (вложено в metro) | Максимальное число символов: 256 Например: Удельная |
| category (строка) - тип гостиницы | Максимальное число символов: 256 Возможные значения:
Например: Отель |
| sale_price (int) - цена проживания за ночь со скидкой | Требования к содержимому поля и форматированию аналогичны полю price Например: 3000 RUB |
min_price (int) - минимальная цена предложения При добавлении минимальной цены товара в баннер перед ценой указывается предлог «от» | Требования к содержимому поля и форматированию аналогичны полю price Например: 3000 RUB |
max_price (int) - максимальная цена предложения При добавлении минимальной цены товара в баннер перед ценой указывается предлог «до» | Требования к содержимому поля и форматированию аналогичны полю price Например: 5000 RUB |
| description (строка) - краткое описание гостиницы | Максимальное число символов: 256 Например: Отель в центре Москвы |
| brand (строка) - бренд сети гостиниц | Максимальное число символов: 256 Например: Moscow Hotels |
custom_label (строка) - пользовательские поля с дополнительной информацией. Используются при создании групп продуктов Варианты: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4 | Максимальное число символов: 256 Например: Летняя распродажа |
| guest_rating (строка) - пользовательский рейтинг гостиницы | |
score (float) - значение рейтинга гостиницы (вложен в guest_rating) | Используйте положительное float-число в диапазоне от 1 до 10 включительно Например: 5.1 |
Обязательные поля для мобильных приложений
| Название, тип и описание | Требования |
|---|---|
| android_tracking_url (строка) - трекинг-ссылка для Android | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int |
| ios_tracking_url (строка) - трекинг-ссылка для iOS | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/id1154436683?pid=mail.ru_int |
android_package (строка) - идентификатор Android приложения (атрибут поля applink) | Требований нет Например: <applink property="android_package" content="myapp_package"/> |
ios_app_store_id (строка) - идентификатор iOS приложения (атрибут поля applink) | Требований нет Например: <applink property="ios_app_store_id" content="111222333"/> |
android_url (строка) - диплинк для Android (атрибут поля applink) | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например: <applink property="android_url" content="myapp://product/01.00.01.1-1.0.8-8.25.3"/> |
ios_url (строка) - диплинк для iOS (атрибут поля applink) | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например: <applink property="ios_url" content="myapp://product/01.00.01.1-1.0.8-8.25.3"/> |
Пример каталога для гостиниц — XML
<?xml version="1.0" encoding="UTF-8"?><listings> <title>My Hotel Feed</title> <listing> <hotel_id>1234</hotel_id> <name>The best hotel</name> <description>A very nice hotel</description> <brand>Premium_brand</brand> <price>1990.99 RUB</price> <phone>+61 2-96027455</phone> <location> <address>ул. Разбитых Фонарей д.1</address> <region>Самарская область</region> <country>Россия</country> <locality>Самара</locality> <metro> <name>Удельная</name> </metro> </location> <image> <url>http://example.com/image_1.jpg</url> </image> <guest_rating> <score>5.1</score> </guest_rating> <url>http://www.thebesthotel.com</url> <applink property="ios_url" content="example-ios://electronic" /> <applink property="ios_app_store_id" content="42" /> <applink property="android_url" content="example-android://electronic" /> <applink property="android_package" content="com.electronic" /> <ios_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</ios_tracking_url> <android_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</android_tracking_url> </listing></listings>