# Синхронизация фида

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

# Структура .csv файла

Каждый столбец в файле фида представляет собой атрибут продукта. Некоторые из них являются обязательными (SKU, ID группы, цена, изображение, URL, наличие или отсутствие на складе и категории), также можно добавить пользовательские столбцы для использования в таргетинге, Affinity профиле и правилах мерчендайзинга.

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

Параметр

Описание

categories

Категории, к которым принадлежит товар, от самой широкой до самой специфичной ("хлебные крошки").

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

group_id

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

image_url

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

in_stock

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

true / false

keywords (опционально)

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

Пример: дан набор ключевых слов “Верхняя одежда|Женская|Пальто|Черное” - если нет товаров с таким же набором, система будет искать товары с ключевыми словами “Верхняя одежда|Женская|Пальто” и далее, пока не останется только первый ключ

name

Название товара

price

Цена, Float

в формате Decimal128

sku

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

url

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

# Пользовательские параметры

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

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

Подробнее

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

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

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

Мультиязычность и мультирегиональность

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

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

# Создание нового товарного фида

# 1. Подготовьте .csv файл

Создайте .csv файл с информацией о всех товарах и услугах, которые планируется использовать в рекомендациях, Affinity профиле и в других кейсах. Подробнее о формате файла в разделе «Структура .csv файла»

# 2. Запустите синхронизацию фида

Перейдите в Assets > Data feeds и нажмите Add new feed

Добавьте URL где хранится файл с товарным фидом.

# 3. Опционально — сделайте парсер

Если столбцы и значения в файле фида не соответствуют требованиям, описанным в разделе «Структура .csv файла», или если требуется объединить несколько файлов в один, вы можете изменить фид с помощью функции парсера. Например, XML-файлы, можно сконвертировать в .csv с помощью функции парсера.

# 4. Проверьте статус синхронизации и содержимое товарного фида

Вы можете в любой момент проверить, успешно ли синхронизируется ваш канал:

• Перейдите в раздел Assets > Data feeds
• В столбце Last sync date дату последней синхронизации.
• В столбце Действия нажмите Preview . Убедитесь, что все необходимые столбцы и все добавленные вами пользовательские столбцы существуют и содержат правильные данные.