Войти

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

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

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

Спецификации фида Criteo

Criteo принимает спецификации фида Google. 

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

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

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

id

Идентификатор — это уникальный идентификатор товара, которым представлен один-единственный товар. Присвоенный продукту и импортированный идентификатор нельзя использовать с другим товаром или с какой-либо версией данного товара. Если поле item_group_id заполнено, необходимо также заполнить поле идентификатора, указав в нем дочерний идентификатор/код товара.

Необходимые параметры Google

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

title

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

Необходимые параметры Google

Если вы хотите повторно использовать продуктовый каталог из системы Google Shopping, рекомендуется ставить самое длинное наименование в title [название], а более короткое и удобное для отображения — в display_ads_title [отображать заголовок объявлений].

  • Требования к символам: значение name должно начинаться с буквы или цифры.
  • Предельное значение: 150
  • Тип: строка
  • Пример: форменные ботинки, размер 39

link

Ссылка ведет на страницу подробной информации об определенном товаре. Ссылка, как правило, хотя и не всегда, является уникальной для определенного товара. Информация о товаре по этому URL-адресу должна совпадать с соответствующей информацией в продуктовом фиде. Укажите протокол (http:// или https://) для всех URL.

Необходимые параметры Google

  • Требования к символам: значение link должно начинаться с указания протокола (http:// или https://), за которым должен следовать полный URL-адрес страницы с подробной информацией о товаре. Все символы должны быть закодированы. Например, символ $ должен быть заменен на %24.
  • Предельное значение: 1024
  • Тип: строка
  • Пример: http://www.example.com/product/working-boots

image_link

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

Необходимые параметры Google

  • Требования к символам: значение image_link должно начинаться с http:// или https://, за которым указывается полный адрес URL изображения товара. Все символы должны быть закодированы. Например, символ $ должен быть заменен на %24. 
  • Предельное значение: 2000
  • Тип: строка
  • Пример: http://www.example.com/product/image/working-boots.png

1.2. Рекомендованные параметры

price

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

Необходимые параметры Google

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

description

Описание представляет собой короткий текст, содержащий дополнительные сведения о товаре, помимо названия. Из-за особенностей дизайна баннеров предпочтительно использовать в форматах и макетах Criteo более короткие описания (менее 50 символов), однако описания предусмотрены не всеми форматами и макетами.

  • Требования к символам: значение description должно начинаться с буквы или цифры. Удалите из этого поля все теги HTML, включая теги стиля, встраивания, объекта и закрепления.
  • Предельное значение: 5000 
  • Тип: строка
  • Пример: прекрасно подходит для ежедневного использования.

item_group_id [идентификатор группы элементов]

Параметр item_group_id – это уникальный идентификатор группы товаров. Этот буквенно-числовой идентификатор отвечает за один товар, который является набором группы товаров. Как только item_group_id присвоен группе товаров и фид импортирован, item_group_id нельзя использовать для другого товара. Также невозможно будет изменить item_group_id для данной группы товаров. Так как item_group_id представляет собой группу товаров, параметр item_group_id может иметь одинаковое значение для нескольких товаров одновременно.

Необходимые параметры Google (в зависимости от страны)

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

При импорте фида инструмент импортасоздает новый товар, так называемый «Основной товар» на основе данных поля item_group_id в фиде. Все товары из данной группы (то есть товары с одинаковым item_group_id) будут связаны с данным товаром. Данные об основном товаре, которых нет в товарном фиде, будут скопированы из информации о товаре из данной группы с самой низкой ценой в фиде. Выбор производится только среди рекомендованных к показу товаров .

GTIN (UPC, EAN) / MPN

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

Производственный номер детали (MPN) — уникальный номер, который идентифицирует товар по его производителю.

Виды GTIN

  • GTIN-12 (UPC-A), который представляет собой 12-значный числовой номер, используемый, главным образом, в Северной Америке.
  • GTIN-8 (EAN/UCC-8), который представляет собой 8-значный числовой номер, используемый, главным образом, за пределами Северной Америки.
  • GTIN-13 (EAN/UCC-13), который представляет собой 13-значный числовой номер, используемый, главным образом, за пределами Северной Америки.
  • GTIN-14 (EAN/UCC-14 или ITF-14), который представляет собой 14-значный числовой номер, используемый для идентификации элементов на различных уровнях упаковки.

Необходимые параметры Google

  • Требования к символам: в поле должен содержаться 8-, 12-, 13- или 14-значный числовой номер (UPC, EAN, JAN или ISBN).
  • Предельное значение: 50 / 70 для MPN
  • Тип: строка
  • Пример: 0001234560012

google_product_category [категория продукта для google]

Характеристики уровня категории указывают категорию продукта в соответствии с систематической классификацией товаров Google.

Если ваш товар можно отнести к нескольким категориям, необходимо указать одну наиболее релевантную.

Необходимые параметры Google

  • Требования к символам: система поддерживает оба идентификатора и полный путь к категории.
  • Тип: строка
  • Пример: женские товары > обувь > форменные ботинки ИЛИ 2271

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

product_type [тип товара]

Product_type представляет собой категорию (или список категорий), к которой относится товар. В поле product_type указывается торговая категория или список торговых категорий товара. Эти категории должны соответствовать указанным на вашем веб-сайте. Уровни иерархии отделяются друг от друга значком >. Если товар можно отнести к нескольким категориям, укажите эти категории, разделив их запятой (,). Укажите основную категорию первой. Поле product_type чувствительно к регистру, поэтому если для одного продукта используется слово «женский», а для другого «Женский», то Criteo будет их интерпретировать, как две разные категории.

  • Требования к символам: значение product_type [тип продукта] должно начинаться с буквы или цифры и может содержать только символы ASCII. В качестве разделителя категорий используется знак > (&gt для фидов XML). Система поддерживает только полный путь к категории. Если товар можно отнести к нескольким категориям, укажите эти категории, разделив их запятыми (,). Укажите основную категорию первой. Идентификаторы категорий в качестве пути приниматься не будут. Идентификаторы следует указывать в поле product_type_key [ключ типа товара]. 
  • Предельное значение: 500
  • Тип: строка
  • Пример.
    • Одна категория: Компьютеры > Клавиатуры и мыши > Мыши > Беспроводные мыши
    • Несколько категорий: Компьютеры > Клавиатуры и мыши > Мыши > Беспроводные мыши, подарки > для папы > Мыши

availability

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

Необходимые параметры Google

  • Требования к символам: для параметра availability должно быть указано одно из следующих трех значений.
    • preorder [предварительный заказ];
    • out of stock [нет в наличии];
    • в наличии
  • Предельное значение: 16
  • Тип: строка
  • Пример: в наличии

adult

Параметр adult указывает, что продукт является безопасным для демонстрации всем аудиториям и пользователям. Товары для взрослых нельзя показывать на баннерах Criteo. Если такие товары присутствуют в вашем фиде, ваша компания может быть заблокирована нашими паблишерами. Вы можете вписать значение “yes” в поле данного параметра, чтобы исключить данные товары из рекомендованных к отображению на баннерах.

Необходимые параметры Google (в зависимости от страны)

  • Требования к символам: необходимо указать значение yes или no.
  • Тип: логическое выражение
  • Пример: no

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 не должно быть символов строки запроса (любые символы после вопросительного знака [?]).
  • Предельное значение: 2000
  • Тип: строка
  • Пример: http://www.example.com/product/image/working-boots-side.png

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

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

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

brand [марка]

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

Необходимые параметры Google

  • Предельное значение: 70
  • Требования к символам: Имя должно начинаться с буквы или числа и может содержать только символы ASCII. Удалите из этого поля все теги HTML, включая теги стиля.
  • Тип: строка
  • Пример: Criteo

1.4. Необязательные параметры

display_ads_title [отображать заголовок объявлений]

Данное поле может использоваться для отображения другого заголовка в рекламных объявлениях (отличного от указанного в поле title).

Чем короче название, тем больше вероятность, что оно впишется во все форматы наших баннеров. В то же время более подробные названия обеспечивают более высокую эффективность Criteo Search. Мы рекомендуем указывать полное название в параметре title, а короткое – в параметре display_ads_title.

  • Предельное значение: 150 (рекомендуется 25)
  • Тип: строка

display_ads_value

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

  • Предельное значение: в 10 раз превышающее цену товара.
  • Тип: строка
  • Пример: 299.99

custom_label_0 [пользовательская метка 0]

Добавьте дополнительную специализированную информацию о товаре.

  • Требования к символам: можно использовать только 5 уровней пользовательских меток (от 0 до 4).
  • Предельное значение: 100
  • Тип: строка
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
На базе технологии Zendesk