Товарный фид – это файл с данными, который содержит систематизированную информацию о всех доступных на вашем сайте отелях и номерах. Эти данные используются для создания динамической рекламы.
В этой статье подробно описаны параметры товаров, которые можно включить в фид, а также методы форматирования каждого поля.
Очень важно учитывать следующие моменты при создании товарного фида:
- Информация о товаре не должна содержать тегов 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 [в наличии]