Содержимое раздела:

Подготовка файла с данными о продажах

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

Содержание

Основные правила

  • Ваш файл с данными о продажах должен быть простой таблицей .csv, в которой каждая строка описывает атрибуты единого линейного продукта.
  • Используйте библиотеку экспорта CSV, которая совместима со стандартным форматом CSV.
  • Используйте запятую для разделения полей в одном ряду.
  • Если в поле значение отсутствует, оставьте его пустым. Пример: value1,,value3,value4.
  • Не используйте в полях символы новой строки, как в закрытых кавычках, так и без них.
  • Используйте кодировку UTF-8.
  • Включите названия полей в первую строку (заголовок) и убедитесь, что все последующие строки содержат значения, соответствующие полям, перечисленным в заголовке. Если вы не уверены в том, как это делать, обратитесь в службу поддержки Emarsys.
  • Не используйте более 255 столбцов.
  • Не используйте значения полей больше 64 КБ.

Очень важно!

Столбцы в заголовке файла с данными о продажах должны быть в том же порядке, который был согласован во время процедуры внедрения Smart insight. Если это не так, данные не будут выгружены.

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

Обязательные поля

Поле
 Обязательная информация Тип Пример Описание
позиция Да Строка КНИГА0012
  • Уникальный идентификатор, используемый в вашем интернет-магазине для идентификации товара.
  • Введенный здесь ID должен находиться в базе данных товаров Emarsys.
  • Если заказ включает в себя несколько товаров, то каждый из них (позиция заказа) должен быть указан в отдельной строке с одним и тем же ID заказа.
цена Да Число с плавающей запятой 110,30
  • Общая цена данных позиций (цена за единицу, умноженная на количество) в валюте, указанной в разделе Сведения об учетной записи на странице Источники данных.
  • Всегда в качестве разделителя дробной части используйте точку (.) (т. е. 10.5, не 10,5).
  • НЕ используйте разделители тысяч (напр., 2000, не 2,000).
  • НЕ включайте валюту.
  • Для возвратов денежных средств всегда вводите отрицательное значение.
заказ Да Строка 111-U8
  • Уникальный идентификатор заказа.
  • Если заказ включает в себя несколько товаров, используйте один и тот же ID заказа для каждой его позиции.
метка времени Да Метка времени 2016-06-06T14:02:00Z
  • Дата и, при желании, время операции в формате часового пояса UTC.
  • Если вы вводите только дату (напр., 2016-06-06) мы автоматически добавляем время 00:00:00.
клиент Да (требуется либо email, либо customer. Неиспользуйте оба!) Строка 12343-14B
  • Анонимный уникальный идентификатор клиента, разместившего заказ.
  • Введенный здесь ID должен находиться в базе данных контактов Emarsys.
эл. почта Да (требуется либо email, либо customer. Не используйте оба!) Электронная почта sportscar_fanatic@gmail.com
  • Адрес электронной почты клиента, разместившего заказ.
  • Для защиты конфиденциальности адресов электронной почты, которые вы присылаете, Emarsys хранит их в файле с данными о продажах в зашифрованном виде, так что оригинальный адрес электронной почты восстановить невозможно.
количество Да Число с плавающей запятой 5
  • Количество (число) купленных позиций.
  • Всегда в качестве разделителя дробной части используйте точку (.).
  • НЕ используйте разделители тысяч.
  • Для возвратов денежных средств всегда вводите отрицательное значение.

Важно: Убедитесь, что вы надлежащим образом используете customer или email для идентификации пользователя во всех файлах с данными о продажах и не смешиваете эти значения.

Настраиваемые поля

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

Доступные префиксы настраиваемых полей

Префикс
 Тип Пример
i_* Целое число i_customer_age
f_* Число с плавающей запятой f_customer_height
t_* Метка времени t_date_of_manufacture
s_* Строка s_book_author
  • Настраиваемые поля проверяются по типу данных, и, если внесенные значения не соответствуют ожидаемому типу данных, файл с данными о продажах отклоняется.
  • Настраиваемые поля могут быть пустыми.

Пример данных о продажах

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

item,price,order,timestamp,customer,quantity,s_color,f_size,t_published 103-nike-1,24.95,112343,2016-06-06T14:02:00Z,093275854,1,blue,14.5,2016-09-20T15:00:00Z 105-adidas-66,99.95,112343,2016-06-06,493027334,3,black,14.5,2016-09-20T15:00:00Z 107-nike-24,50.99,66234,2016-06-06T17:00:00Z,672985375,1,pink,13.5,2016-08-01