Как импортировать данные в личном кабинете
Загрузка заказов, клиентов, отзывов и каталога товаров через файл или по ссылке в разделе Админ → Данные → Импорт.
Загрузите заказы, клиентов, отзывы или каталог товаров через личный кабинет, если интеграции по API у вас нет или данные нужно обновить разово. Регулярный импорт заказов и клиентов надёжнее вести через Platform API.
Все импорты живут в одном месте: Админ → Данные → Импорт. Вкладка ЧЕРЕЗ ФАЙЛ загружает подготовленный файл сразу. Вкладка ПО ССЫЛКЕ настраивает ежедневное скачивание файла по URL.
Что понадобится
- Роль Менеджер или Администратор — у других ролей раздела Импорт в меню Админ нет.
- Файл в формате, который требует выбранная коллекция. Требования различаются, ссылки — ниже.
Подготовка по типам данных
- Заказы
- Клиенты
- Отзывы
- Каталог товаров
Заказы запускают email-кампании по сбору UGC и опросы. Соберите файл по требованиям к файлу с заказами.
Повторная загрузка обновляет уже существующие заказы. Так меняют статусы оплаты и доставки: поправьте значения в файле и загрузите его заново.
Клиенты нужны, чтобы проводить среди них опросы. Соберите файл по требованиям к файлу с клиентами.
Aplaut узнаёт клиента по external_id, email или телефону — достаточно любого одного из трёх. Повторная загрузка с тем же значением обновляет данные клиента, например статус.
Импорт отзывов переносит в Aplaut то, что вы уже собрали: отзывы с сайта или из предыдущей платформы. Соберите файл по требованиям к файлу с отзывами.
Кроме стандартных колонок добавьте в файл свои. Название пишите на латинице без пробелов, значение из колонки Aplaut присвоит всем отзывам файла. Такие атрибуты видны в деталях отзыва, выводятся в виджетах и включаются в формат выгрузки.
Каталог связывает отзывы с товарами. Соберите фид по требованиям к каталогу товара.
По умолчанию Aplaut ожидает YML в формате Яндекс.Маркета. Если вы переходите с BazaarVoice, переключите формат каталога на их вариант в настройках импорта.
Правила обработки включают импорт дополнительных свойств товара, например описания <description> или параметров <param>. Без них эти свойства не участвуют в процессах платформы.
Там же включается перезапись ранее импортированных свойств: изменившееся значение любого параметра, кроме offer.id, обновится при следующем импорте. Состав правил определяет, что попадёт в отчёты, виджеты и выгрузки, поэтому согласуйте его с менеджером Aplaut.
Настройка Изменять URL товаров при импорте включена по умолчанию и нужна, чтобы вычищать из адресов товаров лишние параметры, например UTM-метки: в её подформе перечисляются имена параметров, а пустое значение означает удаление.
Загрузка файла вручную
- Откройте Админ → Данные → Импорт и выберите коллекцию: Заказы, Клиенты, Отзывы или Каталог.
- На вкладке ЧЕРЕЗ ФАЙЛ в п. 3 выберите подготовленный файл. У отзывов вкладок нет — форма загрузки файла открывается сразу.
- Нажмите ИМПОРТИРОВАТЬ.
Ежедневная загрузка по ссылке
Aplaut скачивает файл по указанному URL раз в день. Так ведут импорт заказов и каталога товаров — данных, которые меняются постоянно.
- Откройте Админ → Данные → Импорт и выберите Заказы или Каталог.
- На вкладке ПО ССЫЛКЕ в п. 3 укажите настройки доступа и ссылку на файл1. Для каталога перечислите несколько URL через запятую, если фид разбит на части.
- Включите автоматическое скачивание и сохраните настройки.
- Нажмите ИМПОРТИРОВАТЬ СЕЙЧАС, чтобы загрузить данные вне очереди.
В URL работает шаблонизатор Liquid с одной переменной now — временем запуска очередного импорта. Так забирают файл, в имени которого стоит дата:
# что вы указываете в настройках
ftp://username:password@ftp.yoursite.ru:/orders/orders-{{ 'now' | date: '%Y-%m-%d' }}.csv
# что Aplaut запросит при запуске 1 сентября 2018 года
ftp://username:password@ftp.yoursite.ru:/orders/orders-2018-09-01.csv
Каталог, недоступный по публичной ссылке, можно загрузить и на вкладке ЧЕРЕЗ ФАЙЛ. Постоянно так делать не стоит: каталог устаревает между загрузками, и новые отзывы перестают связываться с товарами.
Проверка результата
Откройте Журналы действий и событий справа вверху и выберите Импорт данных — откроется журнал импорта. У каждой задачи видны статус, число обработанных записей и ошибок. Панель фильтров журнала скрыта — откройте её кнопкой Фильтр над списком. Импортированные отзывы дополнительно видны в разделе Модерация → Отзывы.
Задача импорта всегда завершается одним из статусов: Выполнен, Не выполнен или Отменен — например, если содержимое файла не изменилось с прошлой загрузки. Если файл по ссылке не скачался, задача получает статус Не выполнен сразу на шаге скачивания. Типичные причины — сервер недоступен, ответил кодом, отличным от 200, вернул пустой файл или HTML-страницу вместо фида (защита от ботов, вход в систему, страница ошибки). Подробнее — в разделе Скачивание фида по ссылке.