Товарный фид: общие требования
Товарный фид — один из ключевых элементов интеграции платформы для показа рекламных кампаний с товарами. В ходе интеграции мы поможем собрать оптимальный набор полей.
Платформа способна загружать форматы 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
15
rating
Рейтинг продукта (обычно от 0 до 10, эквивалентно шкале от 0 до 5 звезд с шагом в 1/2 звезды).
string
4
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 за счёт различных вариантов написания, использования разных языков или кодировок для обозначения одного и того же цвета).
Как только мы получаем фид технически пригодный к заливке в платформу, мы загружаем его в интерфейс и ставим задачу на разработку на создание тестового виджета. В этот момент могут обнаружиться какие-то дополнительные нюансы, которые, в свою очередь, могут привести к необходимости добавления / изменения ряда колонок в фиде.
Когда фид загружен в платформу мы готовы запускать кампании с рекомендациями спонсорских товаров.
Last updated