Войти

Добро пожаловать в Центр поддержки

Получите помощь с интеграцией и запущенными кампаниями.

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

Спецификации фида Criteo (Отели и гостиницы)

Товарный фид – это файл с данными, который содержит систематизированную информацию о всех доступных на вашем сайте отелях и номерах. Эти данные используются для создания динамической рекламы. 

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

Очень важно учитывать следующие моменты при создании товарного фида:

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

Формат

Подробная информация

Загрузка

CSV/TSV

Этот формат основан на значениях, разделенных запятой, или значениях, разделённых вкладкой. Заголовок должен быть указан в первой строке файла. Названия полей могут содержать пробелы и символы подчеркивания (например, image_link или image link)

 Пример фида

 XML

Этот формат должен соответствовать основным принципам структуры XML. Товары представлены набором XML-узлов. Список товаров должен начинаться с <?xml объявления тега. 

 Пример фида

Чтобы узнать больше о протоколах импорта фида, ознакомьтесь со следующей статьей: как Criteo импортирует ваш фид. 

1. Необходимые данные о товарах

1.1. Обязательные параметры

id

Это поле является обязательным для всех товаров фида и не может быть оставлено пустым/незаполненным.

Параметр id – это уникальный буквенно-числовой идентификатор одного отеля или курорта.

  • Требования к символам: ID может содержать только символы ASCII и не должен содержать кавычек.
  • Предельное значение: 240
  • Тип: строка
  • Пример: H12896

title

Это поле является обязательным для всех товаров фида и не может быть оставлено пустым/незаполненным.

Параметр title – это имя города и/или название отеля или курорта. Используется как основное текстовое описание данного товара в баннерах.

  • Требования к символам: Имя должно начинаться с буквы.
  • Предельное значение: 150
  • Тип: строка
  • Пример: Grand Hotel New York

link

Это поле является обязательным для всех товаров фида и не может быть оставлено пустым/незаполненным.

Параметр link – это ссылка на календарь доступных бронирований в данном отеле, либо ссылка на результаты поискового запроса, где можно найти рекламируемый вариант размещения. Вы можете передавать другие данные для более эффективной оптимизации: количество взрослых, количество детей и т.д. Обязательно указывайте протокол (http:// или https://) для каждой используемой ссылки.

  • Требования к символам: Параметр link должен начинаться с протокола (http:// или https://), за которым должен следовать URL-адрес страницы с подробной информацией о продукте. Все символы должны быть зашифрованы. Например, символ $ должен быть заменен на %24. А также все символы вне ASCII, например, буквы любого языка, кроме английского.
  • Предельное значение: 1 024
  • Тип: строка
  • Пример: http://www.travelsite.com/hotels/london.html

image_link

Это поле является обязательным для всех товаров фида и не может быть оставлено пустым/незаполненным.

Параметр bigimage – это абсолютный путь к файлу картинки данного размещения. Параметр bigimage отвечает за отображение картинки на баннерах. Изображение должно иметь разрешение не менее 800x800 пикселей, а его размер не может превышать 16 мегабайт. Для каждого изображение необходимо указать расширение, например, image/png, image/gif или image/jpeg. Если доступ к изображениям ограничен cURL, пожалуйста, внесите наш user-agent в белый список, чтобы мы могли отображать картинки на баннерах Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

  • Требования к символам: Параметр image_link должен начинаться с http:// или https://, за которым должен следовать полный URL-адрес изображения товара. Все символы должны быть зашифрованы. Например, символ $ должен быть заменен на %24. А также все символы вне ASCII, например, буквы любого языка, кроме английского.
  • Предельное значение: 2 000
  • Тип: строка
  • Пример: http://www.mysite.com/images/grandnewyork_b.jpg

price

Параметр price – это стоимость одной ночи в выбранном отеле в ближайшие 30 дней. Также можно указать цену предложения на праздники. Валюта price должна совпадать с валютой на вашем сайте. Вводите только числовые значения цены в полеprice с точкой (.) в качестве десятичного разделителя, не отделяя тысячи.

  • Требования к символам: в качестве десятичного разделителя должна использоваться точка (.), разделитель тысяч не используется.
  • Предельное значение: 14
  • Тип: строка
  • Пример: 199.99

categoryid1

Вы можете указать в параметре categoryid1 категорию для оптимизации по COS (если вы выбрали такую оптимизацию), либо категорию для оптимизации по CRO. Например, город/страна или определенное место.

  • Требования к символам: Параметр categoryid2 может начинаться с цифры или буквы, разрешены только символы ASCII.
  • Предельное значение: 500
  • Тип: строка
  • Пример: Майами, штат Флорида

1.2. Рекомендованные поля

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

звезда

Рейтинг данного отеля или курорта среди пользователей (используйте точку в качестве разделителя разрядов)

  • Требования к символам: цифра от 1 до 5 с шагом 0,5.
  • Предельное значение: N/A [не применимо]
  • Тип: цифра.
  • Пример: 4.5.

sale_price [продажная цена]

Параметр sale_price – это стоимость размещения в данном отеле/курорте до скидки. Если в отеле/курорте действуют специальные предложения, укажите более высокую цену в параметре price. Валюта в параметре должна совпадать с валютой, используемой на сайте. Вводите только числовые значения в поле price с точкой (.) в качестве десятичного разделителя, без разделителя тысяч.

  • Требования к символам: в качестве десятичного разделителя должна использоваться точка (.), разделитель тысяч не используется.
  • Предельное значение: 14
  • Тип: строка
  • Пример: 129.99

description

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

Параметр description – короткий текст-описание отеля или курорта.

  • Требования к символам: Описание должно начинаться с буквы.
  • Предельное значение: 5000
  • Тип: строка
  • Пример: Отель Гранд Нью-Йорк находится в самом сердце оживленного мегаполиса.

categoryid2

Параметр categoryid2 может указывать уникальное местоположение, такое как пригород или регион отеля/курорта.

  • Требования к символам: Параметр categoryid2 может начинаться с цифры или буквы, разрешены только символы ASCII.
  • Предельное значение: 500
  • Тип: строка
  • Пример: Эльзас

additional_image_link

Параметр additional_image_link отвечает за абсолютный путь до изображения товара. additional_image_link используется для отображения картинки товара на баннере. Изображение должно иметь разрешение не менее 800x800 пикселей, а его размер не может превышать 16 мегабайт. Для каждого изображение необходимо указать расширение, например, image/png, image/gif или image/jpeg. Если доступ к изображениям ограничен cURL, пожалуйста, внесите наш user-agent в белый список, чтобы мы могли отображать картинки на баннерах Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

  • Требования к символам: Параметр additional_image_link должен начинаться с http:// (а не https://), за которым должен следовать полный URL-адрес изображения товара. Все символы должны быть зашифрованы. Например, символ $ должен быть заменен на %24. При этом в поле additional_image_link не должно быть символов строки запроса (любые символы после ?).
  • Предельное значение: 2 000
  • Тип: строка
  • Пример: http://www.mysite.com/images/grandnewyork_s.jpg

1.3. Другие рекомендованные поля

categoryid3

Параметр categoryid3 может отвечать за тематику отдыха (семейный, активный и т.д.) или тип поездки

  • Требования к символам: The categoryid3 может начинаться с цифры или буквы, разрешены только символы ASCII.
  • Предельное значение: 500
  • Type: Круиз
  • Пример: 4

availability

Параметр availability показывает доступность товара к заказу на сайте. Вы можете указать для данного параметра три значения: предварительный заказ (в настоящее время товар не отгружается, но его можно приобрести), нет в наличии (товар не отгружается, и магазин не принимает заказы на его поставку), товар в наличии (товар отгружается, и вы можете заказать его). Товары с пометкой «Нет в наличии» не будут показываться в баннерах.

  • Требования к символам: для данного параметра должно быть указано одно из следующих трех значений:
    • preorder [предварительный заказ];
    • out of stock [нет в наличии];
    • в наличии
  • Предельное значение: 16
  • Тип: строка
  • Пример: in stock [в наличии]
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
На базе технологии Zendesk