Реклама отелей: расценки в зависимости от дат

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

Чтобы предоставить Facebook сведения о ценах, используйте пакетную загрузку типов номеров и расценок.

Подробное описание всех параметров см. в разделе Параметры номеров и расценок.

Пакетная загрузка типов номеров и расценок

Пакетная загрузка состоит из двух частей:

  1. Загрузка типов номеров.
  2. Загрузка расценок.

Размер файла при пакетной загрузке должен составлять не более 50 МБ, что означает примерно 50 000 элементов в одном файле. Обновления для переменных расценок рекомендуется загружать чаще и небольшими порциями.


Загрузка типов номеров

Для загрузки одного или нескольких файлов с типами номеров используйте API Hotel Rooms Batch.

Примечание. Если все номера у вас имеют один тип, этот шаг можно пропустить.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

Формат файла с типами номеров

Указывать типы номеров нужно в формате XML. См. пример.

Нужно идентифицировать каждый отель по <property> в узле XML <PropertyDataSet> и указать тип номера в <RoomData>. Файл должен начинаться с тега объявления <?xml.

Сведения о пакетном обновлении и удалении типов номеров с помощью API см. в этом разделе.


Загрузка расценок

Для загрузки одного или нескольких файлов с расценками используйте API Pricing Variable Batch. Вы можете загрузить сведения о расценках с типами номеров или без них.

Примечание. Если у вас очень мало номеров, то создать их типы и указать расценки также можно с помощью API Hotel Room.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

Формат файла с расценками

Прежде чем загружать типы номеров, убедитесь, что соответствующие отели уже существуют в каталоге. Переменные расценок можно указывать в следующем формате:

Формат файла и примерОписание

Файл XML с типами номеров | Пример XML

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


Укажите расценки (<Baserate>) в каждом типе номера (<RoomBundle>) в зависимости от сочетания даты регистрации (<Checkin>) и срока пребывания (<Nights>).


Файл должен начинаться с тега объявления <?xml.

Файл XML без типов номеров | Пример XML

Укажите расценки (<Baserate>) для каждого сочетания ID отеля (<Property>), даты регистрации (<Checkin>) и срока пребывания (<Nights>).


Файл должен начинаться с тега объявления <?xml.

Сведения о пакетном обновлении и удалении переменных расценок см. в этом разделе.

Параметры номеров и расценок

Имя и тип поляОписание

Property

Тип: строка

Обязательный параметр. Уникальный идентификатор отеля, предоставленный рекламодателем в качестве hotel_id в ленте отелей.

RoomID

Тип: строка

Обязательный параметр. Уникальный идентификатор типа номера, предоставленный рекламодателем.

Name

Тип: строка

Обязательный параметр. Название типа номера.

Description

Тип: строка

Обязательный параметр. Описание типа номера.

BasePrice

Тип: число с плавающей запятой

Обязательный параметр. Самая низкая цена за номер. Необходимо также указать валюту.

Пример: 159 USD.

URL

Тип: строка

Ссылка на страницу номера отеля.

CheckinDate

Тип: дата

Обязательный параметр. Дата регистрации, которой соответствует цена в поле price. Мы поддерживаем даты в пределах 180 дней от даты загрузки ленты. Дата должна быть в формате ISO-8601 (ГГГГ-ММ-ДД).

Nights

Тип: целое число

Обязательный параметр. Количество ночей проживания в отеле, соответствующее цене в поле price. Максимальное значение: 14

Baserate

Тип: число с плавающей запятой

Обязательный параметр. Цена в зависимости от значений полей checkin_date и length_of_stay.

Пример: 180.

Tax

Тип: число с плавающей запятой

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

OtherFees

Тип: число с плавающей запятой

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

SalePrice

Тип: число с плавающей запятой

Цена со скидкой (если есть).

Пример: 159.

SalePriceTax

Тип: число с плавающей запятой

Сумма налога для цены со скидкой.