# Импорт транзакций

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

Уточнение популярности товаров — в ранжировании по популярности будут принимать участие и данные из событий и загруженные данные.
Данные для алгоритма “Purchased Together” — в расчёте скоров для товаров, покупаемых в рамках одного чека будут учитываться и данные из событий и загруженные данные.
Персональные рекомендации в рамках алгоритма “Affinity” — при формировании рекомендаций для пользователя будут использоваться как его поведение на сайте / в приложении, так и покупки, загруженные в платформу (требуются идентификаторы пользователя).
Исключение товаров, купленных пользователем в офлайн магазинах или до интеграции платформы, если загружаются исторические данные (требуются идентификаторы пользователя).
Создание пользовательских сегментов на основании данных о покупках пользователей (требуются идентификаторы пользователя).

При загрузке идентификаторы в событиях “Login” / “Signup”, должны совпадать с идентификаторами в загружаемых данных. В расчётах участвуют только товары, присутствующие в фиде на момент загрузки данных. Также к загруженным данным применяются все правила применяемые к исходным стратегиям (например диапазон данных). Описание рекомендательных стратегий

# Процедура загрузки данных

Процедура состоит из следующих шагов:

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

# Структура данных

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

Десятичный разделитель - точка

Разделитель в csv файле обязательно ","

Параметры со звёздочкой (*) обязательны для заполнения

Field	Type	Value Example	Description
*cuidType	string	hashedEmail, cuid, custom_id	Тип идентификатора пользователя. Должен совпадать с передаваемым в событиях идентификации с сайта / из приложения
*cuid	string	b642b4217b34b1e8d3bd915fc65c4452	Идентификатор пользователя
*transactionId	string	344778231777174	Идентификатор транзакции
transactionSource	string	Store 1521	Идентификатор канала для оффлайн покупок
*transactionDatetime	date, ISO 8601	2019-08-05T09:45:23+03:00	Дата и время транзакции в формате dateTtime+offset
*value	float	4583.18	Общая стоимость корзины в фактической валюте платежа
*currency	sting, ISO 4217	KZT	Буквенный код валюты в соответствии со стандартом ISO 4217
*productId	string	124350	Идентификатор товара
*quantity	integer, positive only	2	Количество единиц productId купленных в рамках транзакции
*itemPrice	float	548.20	Ценность одной единицы товара до применения акций и скидок

# Проверка корректности загрузки данных

Логи каждой загрузки доступны в выделенной папке на нашем сервере с парольным доступом (доступ предоставляется по запросу). Формат имени файла лога: offline_purchase_upload_log_YYYY-MM-DD-HH-MM-SS.csv.
После первичной загрузки данных рекомендуется проверить, что данные появились в аудиториях при выборе условия “Products purchased offline”.

# Образец файла

offline_purchases_data_example.csv