Войти

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

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

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

Характеристики продуктового каталога Criteo

1. Обзор

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

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

2. Форматы каталогов, поддерживаемые Criteo

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

Формат каталога Подробная информация Загрузка

TSV

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

Пример каталога

CSV

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

Пример каталога

XML

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

Пример каталога

3. Информация о товаре, которую необходимо предоставить

Все названия полей должны быть указаны на английском языке. Информация о товаре не должна содержать тегов HTML или тегов стилей.

3.1 Поля, заполнение которых необходимо для рекламирования ваших товаров

3.1.1 id [идентификатор]

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

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

Требования к символам: идентификатор должен начинаться с буквы или цифры и может содержать только символы ASCII.

Предельное значение: 250

Тип: строка

Пример: abc123-black-7.5

3.1.2 title [название]

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

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

Требования к символам: название должно начинаться с буквы или цифры и может содержать только символы ASCII.

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

Тип: строка

Пример:  Форменные ботинки, размер 7,5

3.1.3 description [описание]

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

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

Предельное значение: 5000 (рекомендуется 50)

Тип: строка

Пример: Прекрасно подходит для ежедневного использования.

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

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

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

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

Тип: строка

Пример: Женские товары > Обувь > Форменные ботинки

3.1.5 link [ссылка]

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

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

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

Предельное значение: 1024

Тип: строка

Пример: http://www.example.com/product/working-boots

3.1.6 image_link [ссылка на изображение]

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

Ссылка на изображение является URL-адресом, определяющим путь к файлу изображения данного товара. Она используется для показа изображения товара в баннерах. Оптимальным вариантом является ширина изображения от 300 до 400 пикселей, при этом размер изображения должен быть менее 1 МБ. Для изображения нужно задать заголовок Content-Type в формате image/png или image/jpeg. Если вы ограничили доступ к изображениям через сURL, внесите нашу программу-агент в белый список, чтобы ваши изображения могли быть показаны в баннерах Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Требования к символам: ссылка на изображение должна начинаться с http:// (не https://), за которым указывается полный URL-адрес изображения товара. Все символы должны быть зашифрованы. Например, символ $ должен быть заменен на %24. При этом в поле image_link не должно быть символов строки запроса (любые символы после ?).

Предельное значение: 2000

Тип: строка

Пример: http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link [дополнительная ссылка на изображение]

Дополнительная ссылка на изображение представляет собой URL-адрес, определяющий путь к файлу изображения данного товара, который отличается от пути, указанного в поле image_link. Дополнительная ссылка на изображение используется для демонстрации изображений товаров в баннерах. Оптимальным вариантом является ширина изображения от 300 до 400 пикселей, при этом размер изображения должен быть менее 1 МБ. Для изображения нужно задать заголовок Content-Type в формате image/png или image/jpeg. Если вы ограничили доступ к изображениям через сURL, внесите нашу программу-агент в белый список, чтобы ваши изображения могли быть показаны в баннерах Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

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

Предельное значение: 1024

Тип: строка

Пример: http://www.example.com/product/image/working-boots-side.png

3.1.8 availability [доступность]

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

Требования к символам: для данного параметра должно быть указано одно из следующих трех значений:

· preorder [предварительный заказ];

· out of stock [нет в наличии];

· in stock [в наличии].

Предельное значение: 25

Тип: строка

Пример: in stock [в наличии]

3.1.9 price [цена]

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

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

Предельное значение: 14

Тип: строка

Пример: 1299.99

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

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

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

Предельное значение: 14

Тип: строка

Пример: 1199.99

3.1.11 gtin [глобальный номер товара] или mpn [производственный номер детали]

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

Виды 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-значный числовой номер, используемый для идентификации элементов на различных уровнях упаковки.

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

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

Предельное значение: 50

Тип: строка

Пример: 0001234560012

3.1.12 brand [марка]

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

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

Предельное значение: 70

Тип: строка

Пример: Criteo

3.1.13 adult [для взрослых]

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

Требования к символам: должно быть указано значение да или нет.

Тип: логическое выражение

Пример: нет

3.2 Дополнительные поля

3.2.1 Основная информация о продукте

Наименование: product_type [тип продукта]

Тип продукта представляет собой категорию (или список категорий), к которой относится товар. Ограничений по вводимым в это поле категориям нет, так что поле product_type можно использовать для привязки к конкретной общей категории вашего сайта. Поле product_type чувствительно к регистру, поэтому если для одного продукта используется слово «женский», а для другого «Женский», то Criteo будет их интерпретировать как две разные категории.

Требования к символам: тип продукта должен начинаться с буквы или цифры и может содержать только символы ASCII. В качестве разделителя категорий используется знак > (> для каталогов XML).

Предельное значение: 500

Тип: строка

Пример: Женские &gt; Ботинки &gt; Форменные ботинки

3.2.2 mobile_link [ссылка для мобильных устройств]

В данное поле вносится ссылка на страницу с информацией о товарах, оптимизированная для мобильных устройств. Ее URL-адрес должен отличаться от указанного в поле link. Предлагая клиентам воспользоваться ссылкой для мобильных устройств, вы предоставляете им более оптимальный механизм взаимодействия с сайтом и сокращаете время ожидания загрузки страницы.

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

Предельное значение: 2000

Тип: строка

Пример: http://m.example.com/product/working-boots

3.2.3 condition [состояние]

Данный параметр используется для классификации товара по трем различным параметрам: new [новый товар], refurbished [отремонтированный товар] и used [бывший в употреблении товар].

Требования к символам: поддерживаются только 3 значения:

  • 'new' [новый товар];
  • 'refurbished' [отремонтированный товар];
  • 'used' [бывший в употреблении товар].

Тип: строка

Пример: new [новый]

---

Варианты товара

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

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

Требования к символам: параметр item_group_id должен начинаться с буквы или цифры и может содержать только символы ASCII.

Предельное значение: 250

Тип: строка

Пример: abc123

3.2.7 color [цвет]

Подробная информация: в данном поле указывается преобладающий цвет (цвета) товара.

Предельное значение: 100

Тип: строка

Пример: черный

3.2.8 gender [пол]

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

Требования к символам: поддерживаются только 3 значения:

  • 'male' [мужской];
  • 'female' [женский];
  • 'unisex' [унисекс].

Тип: строка

Пример: male [мужской]

3.2.9 age_group [возрастная группа]

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

Требования к символам: поддерживаются только 5 значений:

  • 'newborn' [новорожденные];
  • 'infant' [дети до 1 года];
  • 'toddler' [дети 1—4 года];
  • 'kids' [дети от 4 лет];
  • 'adult' [взрослые].

Тип: строка

Пример: adult [для взрослых]

3.2.10 material [материал]

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

Предельное значение: 200

Тип: строка

Пример: кожа

3.2.11 pattern [рисунок]

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

Предельное значение: 100

Тип: строка

Пример: полоски

3.2.12 size [размер]

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

Предельное значение: 100

Тип: строка

Пример: L

3.2.13 size_type [тип размера]

Можно указать фасон товара путем добавления типа размера.

Требования к символам: поддерживаются только 5 значений:

  • 'regular' [стандартный размер];
  • 'petite' [миниатюрный размер];
  • 'plus' [размер плюс];
  • 'big and tall' [размер для крупной и высокой фигуры];
  • 'maternity' [для беременных].

Предельное значение: N/A [не применимо]

Тип: строка

Пример: regular [стандартный размер]

3.2.13 size_system [система размеров]

Подробная информация: можно указать систему размеров страны происхождения товара.

Требования к символам: поддерживается 11 значений: US, UK, EU, DE, FR, JP, CN (Китай), IT, BR, MEX, AU

Предельное значение: N/A [не применимо]

Тип: строка

Пример: US

---

Информация о доставке

3.2.14 shipping [доставка]

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

Тип: строка

Пример:

 <shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>

3.2.15 shipping_weight [вес доставляемого товара]

Параметр shipping_weight указывает на вес доставляемого товара.

Требования к символам: поддерживаются только обозначения lb, oz, g, kg

Тип: строка

Пример: 1 kg

3.2.16 shipping_height [высота доставляемого товара]

Параметр shipping_height указывает на высоту доставляемого товара.

3.2.17 shipping_width [ширина доставляемого товара]

Параметр shipping_width указывает на ширину доставляемого товара.

3.2.18 shipping_length [длина доставляемого товара]

Подробная информация: показывает длину товара.

3.2.19 shipping_label [транспортная маркировка]

В этом поле можно назначить маркировку для конкретных товаров, используя выбранные значения, такие как perishable [скоропортящийся], bulky [крупногабаритный] или promotion [реклама товара].

Предельное значение: 100

Тип: строка

Пример: promotion [реклама товара]

---

Упаковка и количество товара

3.2.20 multipack [групповая упаковка]

Это поле указывает на упаковку идентичных товаров.

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

Пример: 2

3.2.21 is_bundle [комплект]

Это поле указывает на группу различных товаров.

Тип: логическое выражение

Пример: FALSE

3.2.22 promotion_id [идентификатор рекламной кампании]

Подробная информация: этот параметр указывает идентификатор рекламной кампании.

Предельное значение: строка

Тип: 60

Пример: 123654

---

Дополнительные поля

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

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

Требования к символам: можно использовать только 5 уровней пользовательских меток (от 0 до 4)

Предельное значение: 100

Тип: строка

3.2.24 sale_price_effective_date [дата вступления в силу продажной цены]

Это поле используется вместе с полем sale_price [цена продажи], чтобы указать диапазон дат действия цены продажи.

Требования к символам: начальная и конечные даты разделены косой чертой (/). Начальная дата указывается в формате ГГГГ-ММ-ДД, за которой следует буква T, далее время поступления товара в продажу и обозначение часового пояса в соответствии со стандартом ISO 8601. Конечная дата должна быть указана в таком же формате.

Предельное значение: 51

Пример: 2016-03-01T13:00-0800/2016-03-11T15:30-0800

3.2.25 adwords_redirect [перенаправление в adwords]

URL-адрес для отслеживания всех переходов из системы Google Покупки.

Предельное значение: 200

Тип: URL

Пример: http://www.mywebsite.com/productpage.html

3.2.26 excluded_destination [исключенный пункт назначения]

Поле excluded destination [исключенный пункт назначения] предотвращает появление позиции в определенных пунктах назначения, даже если она есть в данных о товаре.

3.2.27 expiration_date [срок действия]

Дата, после которой товар не будет рекомендоваться.

Предельное значение: 10

Тип: формат ISO 8601

Пример: 2016-07-24

3.2.28 unit_pricing_measure [мера цены за единицу товара]

Поле unit pricing measure [мера цены за единицу товара] определяет размерность и габариты элемента. Например: 25floz или 15oz.

Пример: 15oz

3.2.29 unit_pricing_base_measure [основная мера цены за единицу товара]

Поле unit pricing base measure [основная мера цены за единицу товара] определяет предпочитаемую меру цены за единицу товара. Например, 50 жидк. унций.

Пример: 50oz

Пример структуры каталога

Пример каталога в формате XML

XML

<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0">

    <channel>

        <title>Your Website</title>

        <link>http://www.yoursite.com/us/</link>

        <description>Your Website</description>

        <item>

            <g:id>abc123-black-7.5</g:id>

            <g:title>Working Boots Size 7.5</g:title>

            <g:description>Excellent for daily use</g:description>

            <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category>

            <g:link>http://www.example.com/product/working-boots</g:link>

            <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link>

            <g:availability>in stock</g:availability>

            <g:price>1299.99</g:price>

            <g:sale_price>1199.99</g:sale_price>

            <g:gtin>0001234560012</g:gtin>

            <g:brand>Criteo</g:brand>

            <g:adult>да</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; Working Boots</g:product_type>

            <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link>

            <g:condition>new</g:condition>

            <g:availability>in stock</g:availability>

            <g:availability_date>2016-06-25T13:00-0800</g:availability_date>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:item_group_id>abc123</g:item_group_id>

            <g:color>Black</g:color>

            <g:gender>male</g:gender>

            <g:age_group>adult</g:age_group>

            <g:material>leather</g:material>

            <g:pattern>Striped</g:pattern>

            <g:size>L</g:size>

            <g:size_type>regular</g:size_type>

            <g:size_system>US</g:size_system>

            <g:shipping>

                <g:country>US</g:country>

                <g:service>Standard</g:service>

                <g:price>5.5 USD</g:price>

            </g:shipping>

            <g:shipping_weight>1 kg</g:shipping_weight>

            <g:shipping_label>promotion</g:shipping_label>

            <g:multipack>2</g:multipack>

            <g:is_bundle>FALSE</g:is_bundle>

            <g:custom_label_0>custom data 0</g:custom_label_0>

            <g:custom_label_1>custom data 1</g:custom_label_1>

            <g:custom_label_2>custom data 2</g:custom_label_2>

            <g:custom_label_3>custom data 3</g:custom_label_3>

            <g:custom_label_4>custom data 4</g:custom_label_4>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect>

            <g:excluded_destination>Shopping</g:excluded_destination>

            <g:expiration_date>2016-07-24</g:expiration_date>

            <g:unit_pricing_measure>15oz</g:unit_pricing_measure>

            <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure>

        </item>

    </channel>

</rss>

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 1 из 1
На базе технологии Zendesk