Импорт пользователей

Вы можете загрузить в Carrot quest базу пользователей, чтобы продолжить работать с ними через наш сервис

Импортировать пользователей в Carrot quest можно двумя способами:

  • Через интерфейс
  • Rest API

💡 Что нужно сделать перед импортом пользователей

1. Проверить квоту пользователей

Импортированные пользователи входят в квоту Carrot quest. Убедитесь, что после импорта вы не превысите квоту.

Сделать это можно в разделе Оплата:

2017-09-22_10-13-35.png

О том, что произойдёт при повышении квоты пользователей, читайте в соответствующей статье.

2. Сделать валидацию email

Если вы планируете делать рассылку по загруженным пользователям, проведите валидацию емейлов.

Мы бережём вашу базу и не отправим письма по невалидным емейлам (мы писали о том, как определяем невалидные емейлы в блоге). При этом, загруженные пользователи всё равно учтутся в вашей квоте. Чтобы не загружать пользователей, которые будут лежать мёртвым грузом, проверьте базу на валидность.

Вы можете воспользоваться любым инструментом. Мы предпочитаем https://www.emaillistverify.com/
За время нашего использования этого сервиса bounced не превышал 3%.

Если во время импорта что-то пошло не так, вы можете удалить пользователей.

Импорт через интерфейс

В раздел импорта можно попасть из раздела Лиды.

Вы можете импортировать базу с вашими User ID или просто с емейлами.


К каждому варианту прилагается файл-шаблон для импорта. Мы рекомендуем скачать его и заполнить по шаблону. Импортируемый файл должен быть в формате CSV и не превышать 30 Мб.

Список стандартных свойств есть в этой статье, остальные свойства будут являться пользовательскими и их название не регламентировано (кроме того, что перед названием не должен стоять знак $).

Если вы знаете User ID ваших пользователей, то выберите первый вариант — импорт зарегистрированных пользователей. Если в базе лидов Carrot quest уже есть пользователи с таким User ID, то отдельная карточка не создастся, а информация запишется в существующего пользователя.


Важно: импортированные лиды учитываются в квоте пользователей. При этом, если вы импортируете данные в уже существующую карточку лида (импортируемый лид склеивается с существующим активным лидом), он не будет считаться новым.

Если у вас есть база пользователей с емейлами, но без User ID, выберите второй вариант: импорт контактов с Email. Заполните обязательный столбец с email и добавьте свои свойства. Важно, чтобы в импортируемом файле не было указано User ID. Так как в Carrot quest может быть несколько карточек лида с одинаковым емейлом, если мы найдём совпадение, информация запишется в последнюю активную карточку.


Например вы хотите загрузить базу пользователей, но разделить её на категории. Клиенты: текущие, новые, потенциальные. Где "Клиенты" - название свойства, "текущие", "новые", "потенциальные" - значения свойства.

Сегментируя в разделе лиды по значению свойства, вы можете отправлять персонализированные e-mail необходимой аудитории.

В любом из вариантов импорта (с User ID или по емейлу) мы не ограничиваем количество импортируемых лидов и/или свойств, но импортируемый файл должен быть не больше 30 Мб.

Загрузите файл с лидами и проверьте правильность определения свойств: в них не должно содержаться лишних символов (пробелов, запятых и др.), а кодировка имен и свойств должна быть корректной. Нажмите на "Импортировать лиды".

Совет: Чтобы потом легко найти всех импортированных лидов, добавьте им свойство с датой импорта. Если вы импортируете через интерфейс, добавьте в таблицу для импорта столбец "Импорт" и запишите в ячейки дату. Тогда у всех импортированных пользователей появится свойство Импорт, в котором будет записана дата. Это поможет легко настроить сегментацию и выделить только нужных лидов. Также вы можете присвоить любое другое свойство импортированным лидам, если есть необходимость.

Импорт происходит в фоновом режиме, вы можете закрыть вкладку или перейти в другой раздел в Carrot quest без потери данных. Когда импорт будет закончен, вам придёт сообщение в колокольчик в верхней панелиimage2.png

В этом же сообщении будет указано, сколько лидов было добавлено, обновлено и сколько не было загружено из-за ошибок.

image1.png

Импорт через Rest API

Загрузить свою базу пользователей в нашу систему можно также через Rest API. Подробнее ознакомиться с API можно по этой ссылке.

❗Важно: При загрузке пользователей нужно воздержатся от синхронного вызова API, т.к это может вызвать значительные нагрузки на нашу систему и ваш токен заблокируется. Оптимальное количество обращении — 2-3 в секунду.

Пример кода импорта пользователей на PHP:

 

Работает на