Товарный фид: общие требования

PreviousКаталог товаров NextМультирегиональность

Last updated 6 months ago

Товарный фид: общие требования

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

Платформа способна загружать форматы YML (XML), CSV и JSON, в том числе группы фидов, где свойства раскиданы по разным фидам. CSV формат предпочтителен, так как наиболее компактен. Убедитесь в наличии всех обязательных полей (названия полей могут не совпадать)

Ограничения CSV

Разделитель CSV файла - запятая;
Разделитель цены в CSV файле - только точка (тип значения - float);
Для каждого значения в каждой колонке максимальное число символов равно 1000;
Фид ограничен 1000 колонками;
Названия колонок должны быть прописаны в нижнем регистре, из специальных символов допустим только “_”;
Если в значении есть запятая, все значение должно быть заключено в двойные кавычки (”значение”);
В свойстве image_url изображение должно быть в стандартном размере как на страницах категорий (именно это изображение будет выводиться в рекомендательных виджетах);
image_url не должен содержать пустого значения. Если для конкретного продукта нет изображения, необходимо указать ссылку на изображение-заглушку;
Все поля с булевыми значениями, кроме in_stock должны быть заполнены в формате true/[пусто] для корректного расчета аффинитивности.
Поля с параметром “lng” (используется для мультиязычности / мультирегиональности) не могут использоваться для расчёта аффинитивности.

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

Формат фида должен соответствовать стандарту . В частности, формату экранирования значений, оговоренному в стандарте.

Обязательные колонки в фиде

Описание обязательных полей:

Поле

Описание

Тип

Пример

sku*

Уникальный идентификатор

string (до 256 символов)

12378

group_id*

Идентификатор группы продуктов (вариантов одного продукта), отличающихся друг от друга некоторыми атрибутами

string (до 256 символов)

124578

name*

Название продукта

string (до 1000 символов)

Женские брюки

url*

Ссылка на товар

string (до 1000 символов)

https://site.com/clothes/women/trousers/12447

price*

Цена

float

50.00

in_stock*

Идентификатор наличия продукта

boolean

true / false

image_url*

Ссылка на изображение товара

string (до 1000 символов)

https://site.com/image.jpg

categories*

Категории, к которым принадлежит продукт, от самой широкой до самой специфичной

string (до 1000 символов)

Одежда|Женщины|Брюки

keywords (опционально, но очень рекомендуется)

Дополнительная информация о продукте, разделяется с помощью “|”. Заполнение данного свойства нужно для расчета похожести товаров (только для стратегии Similarity) Ключевые слова необходимо указывать от общего к частному, так как при проверке совпадения система отсекает последнее слово, если не совпадает весь набор. Пример: дан набор ключевых слов “Верхняя одежда|Женская|Пальто|Черное” - если нет товаров с таким же набором, система будет искать товары с ключевыми словами “Верхняя одежда|Женская|Пальто” и далее, пока не останется только первый ключ.

string (до 1000 символов)

Бренд|Тип посадки|Сезон

Общее описание дополнительных типов колонок

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

Данные, необходимые для визуализации рекомендаций: рейтинг продукта, количество обзоров или предыдущая цена продукта (до скидки, например);
Данные, необходимые для корректной работы рекомендаций: если, например, метод добавления в корзину работает с идентификатором, отличным от SKU, этот идентификатор должен быть добавлен в фид;
Данные, необходимые для дополнительной логики в рекомендательных алгоритмах, например, если необходимо выводить только товары, которые можно приобрести в кредит, признак возможности приобретения данного товара в кредит должен быть добавлен в фид;
Данные, необходимые для расчета аффинитивности. Рекомендуется подбирать такие свойства товаров, которые будут влиять на покупательское поведение пользователей, заполнены для большинства товаров (или хотя бы для ключевых категорий) и содержат ограниченное количество возможных значений. Например, что стоит добавить в интернет-магазине одежды: “сезон”, “стиль”, “цвет”, “бренд”; НЕ стоит добавлять: “размер” (если размеры не унифицированы в рамках всего сайта), “страна производства”, “тип застёжки”. Ограничение - 10 колонок с данными для аффинитивности в одном фиде.

Работа с наличием товара в фиде

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

Вместе с тем, в случаях, когда пользователям потенциально доступны все исторические товары, в т.ч. те, которых ушли из продажи много лет назад, рекомендуется ограничивать объём вышедших из продажи товаров в фиде 6-ю месяцами после того, как они ушли из наличия.

Дополнительные параметры фида и примеры по вертикалям

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

Поле

Описание

Тип

Пример

old_price

Перечеркнутое значение цены для товаров со скидкой, заполняется только для тех товаров, где есть цена со скидкой. Важно: 'price' ≠ 'old_price'.

float

75.00

review_count

Число обзоров данного товара.

string

rating

Рейтинг продукта (обычно от 0 до 10, эквивалентно шкале от 0 до 5 звезд с шагом в 1/2 звезды).

string

is_sale

Если товар участвует в распродаже.

boolean

true

sale_badge_url

В случае, если на сайте присутствуют бейджи, необходимо прописать адрес изображения бейджа.

string

https://site.com/img.png

is_bestseller

Если товар - бестселлер.

boolean

true

bestseller_badge_url

В случае, если на сайте есть бейджи для бестселлеров, необходимо указать URL изображения для бейджа.

string

https://site.com/badge_img.png

is_new

Если товар является новинкой.

boolean

true

new_badge_url

Ссылка на изображение бейджа, если на сайте для товара выводится изображение бейджа.

string

https://site.com/badge_img.png

in_stock_status

Относительное количество складских остатков по товару.

string

low/medium/high

margin_group

Группа маржинальности товара.

string

low/medium/high

product_accessory

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

string

product/accessory/service

brand

Торговая марка производителя товара.

string

Samsung

Цикл работы с фидом в рамках стандартной интеграции

В рамках стандартного подхода к интеграции работа с фидом строится на итеративной основе и состоит из следующих этапов:

Мы готовим краткое ТЗ на фид, где указываем информацию, которую мы ожидаем увидеть в фиде. Список ожидаемых колонок строится из обязательных колонок, колонок, рекомендуемых для вертикали клиента, а также колонок, рекомендуемых для конкретного клиента. Список колонок включает максимально возможное количество данных на основании наших знаний о клиенте и списке согласованных кейсов. В большинстве случаев, допустимо начинать работу с фида, в котором не будут присутствовать все ожидаемые колонки и добавлять дополнительные данные позже в ходе работы.
Мы получаем подготовленный фид и валидируем его на соответствие общим требованиям по документации выше, а также ТЗ из п. 1. В результате валидации составляется документ со списком рекомендуемых изменений. В некоторых случаях данный этап может повторяться несколько циклов: во-первых, в случае, если фид не соответствует базовым требованиям, во вторых, в случаях, когда мы получаем неожиданные значения в ряде колонок (например 10.000 различных значений в поле color за счёт различных вариантов написания, использования разных языков или кодировок для обозначения одного и того же цвета).
Как только мы получаем фид технически пригодный к заливке в платформу, мы загружаем его в интерфейс и ставим задачу на разработку на создание тестового виджета. В этот момент могут обнаружиться какие-то дополнительные нюансы, которые, в свою очередь, могут привести к необходимости добавления / изменения ряда колонок в фиде.
Когда фид загружен в платформу мы готовы запускать кампании с рекомендациями спонсорских товаров.

Фид переключается из статуса ‘Active’ в статус ‘Paused’ после трёх неудачных попыток синхронизации из-за недоступности фида или после одной неудачной попытки синхронизации в случае некорректной структуры фида.

PreviousКаталог товаров NextМультирегиональность

Last updated 6 months ago

Ограничения CSV

Разделитель CSV файла - запятая;
Разделитель цены в CSV файле - только точка (тип значения - float);
Для каждого значения в каждой колонке максимальное число символов равно 1000;
Фид ограничен 1000 колонками;
Названия колонок должны быть прописаны в нижнем регистре, из специальных символов допустим только “_”;
Если в значении есть запятая, все значение должно быть заключено в двойные кавычки (”значение”);
В свойстве image_url изображение должно быть в стандартном размере как на страницах категорий (именно это изображение будет выводиться в рекомендательных виджетах);
image_url не должен содержать пустого значения. Если для конкретного продукта нет изображения, необходимо указать ссылку на изображение-заглушку;
Все поля с булевыми значениями, кроме in_stock должны быть заполнены в формате true/[пусто] для корректного расчета аффинитивности.
Поля с параметром “lng” (используется для мультиязычности / мультирегиональности) не могут использоваться для расчёта аффинитивности.

Обязательные колонки в фиде

Описание обязательных полей:

Поле

Описание

Тип

Пример

sku*

Уникальный идентификатор

string (до 256 символов)

12378

group_id*

string (до 256 символов)

124578

name*

Название продукта

string (до 1000 символов)

Женские брюки

url*

Ссылка на товар

string (до 1000 символов)

https://site.com/clothes/women/trousers/12447

price*

Цена

float

50.00

in_stock*

Идентификатор наличия продукта

boolean

true / false

image_url*

Ссылка на изображение товара

string (до 1000 символов)

https://site.com/image.jpg

categories*

Категории, к которым принадлежит продукт, от самой широкой до самой специфичной

string (до 1000 символов)

Одежда|Женщины|Брюки

keywords (опционально, но очень рекомендуется)

string (до 1000 символов)

Бренд|Тип посадки|Сезон

Общее описание дополнительных типов колонок

Данные, необходимые для визуализации рекомендаций: рейтинг продукта, количество обзоров или предыдущая цена продукта (до скидки, например);
Данные, необходимые для корректной работы рекомендаций: если, например, метод добавления в корзину работает с идентификатором, отличным от SKU, этот идентификатор должен быть добавлен в фид;
Данные, необходимые для дополнительной логики в рекомендательных алгоритмах, например, если необходимо выводить только товары, которые можно приобрести в кредит, признак возможности приобретения данного товара в кредит должен быть добавлен в фид;
Данные, необходимые для расчета аффинитивности. Рекомендуется подбирать такие свойства товаров, которые будут влиять на покупательское поведение пользователей, заполнены для большинства товаров (или хотя бы для ключевых категорий) и содержат ограниченное количество возможных значений. Например, что стоит добавить в интернет-магазине одежды: “сезон”, “стиль”, “цвет”, “бренд”; НЕ стоит добавлять: “размер” (если размеры не унифицированы в рамках всего сайта), “страна производства”, “тип застёжки”. Ограничение - 10 колонок с данными для аффинитивности в одном фиде.

Работа с наличием товара в фиде

Дополнительные параметры фида и примеры по вертикалям

Поле

Описание

Тип

Пример

old_price

float

75.00

review_count

Число обзоров данного товара.

string

rating

Рейтинг продукта (обычно от 0 до 10, эквивалентно шкале от 0 до 5 звезд с шагом в 1/2 звезды).

string

is_sale

Если товар участвует в распродаже.

boolean

true

sale_badge_url

В случае, если на сайте присутствуют бейджи, необходимо прописать адрес изображения бейджа.

string

https://site.com/img.png

is_bestseller

Если товар - бестселлер.

boolean

true

bestseller_badge_url

В случае, если на сайте есть бейджи для бестселлеров, необходимо указать URL изображения для бейджа.

string

https://site.com/badge_img.png

is_new

Если товар является новинкой.

boolean

true

new_badge_url

Ссылка на изображение бейджа, если на сайте для товара выводится изображение бейджа.

string

https://site.com/badge_img.png

in_stock_status

Относительное количество складских остатков по товару.

string

low/medium/high

margin_group

Группа маржинальности товара.

string

low/medium/high

product_accessory

string

product/accessory/service

brand

Торговая марка производителя товара.

string

Samsung

Цикл работы с фидом в рамках стандартной интеграции

Мы готовим краткое ТЗ на фид, где указываем информацию, которую мы ожидаем увидеть в фиде. Список ожидаемых колонок строится из обязательных колонок, колонок, рекомендуемых для вертикали клиента, а также колонок, рекомендуемых для конкретного клиента. Список колонок включает максимально возможное количество данных на основании наших знаний о клиенте и списке согласованных кейсов. В большинстве случаев, допустимо начинать работу с фида, в котором не будут присутствовать все ожидаемые колонки и добавлять дополнительные данные позже в ходе работы.
Мы получаем подготовленный фид и валидируем его на соответствие общим требованиям по документации выше, а также ТЗ из п. 1. В результате валидации составляется документ со списком рекомендуемых изменений. В некоторых случаях данный этап может повторяться несколько циклов: во-первых, в случае, если фид не соответствует базовым требованиям, во вторых, в случаях, когда мы получаем неожиданные значения в ряде колонок (например 10.000 различных значений в поле color за счёт различных вариантов написания, использования разных языков или кодировок для обозначения одного и того же цвета).
Как только мы получаем фид технически пригодный к заливке в платформу, мы загружаем его в интерфейс и ставим задачу на разработку на создание тестового виджета. В этот момент могут обнаружиться какие-то дополнительные нюансы, которые, в свою очередь, могут привести к необходимости добавления / изменения ряда колонок в фиде.
Когда фид загружен в платформу мы готовы запускать кампании с рекомендациями спонсорских товаров.