Импорт пользователей
Импортировать пользователей в Carrot quest можно двумя способами:
Импорт позволит не только добавить в базу новых лидов, но и обновить информацию об уже существующих пользователях.
💡 Что нужно сделать перед импортом пользователей
1. Проверить квоту пользователей
Пользователи, созданные при импорте, учтутся в квоте пользователей вашего тарифа. Убедитесь, что после импорта вы не превысите квоту.
Сделать это можно в разделе Оплата:
Узнайте, что случится при превышении числа пользователей, в статье на эту тему.
2. Сделать валидацию email
Если вы планируете делать рассылку по загруженным пользователям, проведите валидацию емейлов.
❗ Мы бережём вашу базу и не отправим письма по невалидным емейлам (мы писали о том, как определяем невалидные емейлы, в блоге). При этом загруженные пользователи всё равно учтутся в вашей квоте, т.к. валидация в сервисе проводится непосредственно при отправке писем. Чтобы не загружать заведомо невалидные адреса, проверьте базу на валидность.
В нашем сервисе нет встроенного инструмента для валидации адресов почт, но вы можете использовать любой внешний сервис, например, Emaillistverify. За время его применения процент возвратов не превышал 3%.
Если во время импорта что-то пошло не так, вы можете удалить пользователей.
Импорт через интерфейс
В раздел импорта можно попасть из раздела "База лидов":
Вы можете импортировать базу с вашими User ID, подписчиками Telegram-бота, или просто с емейлами.
Важно: импортировать базу только с номерами телефонов не получится, как минимум дополнительно потребуется указать User ID.
Для каждого варианта есть файл-шаблон для импорта. Рекомендуем скачать его и заполнить по образцу. Также можно скопировать нашу таблицу в Excel или Google Docs и заполнить самостоятельно. Не обязательно оставлять в таблице все указанные в примере столбцы — оставьте только нужные вам.
📝 Пример таблицы для импорта списка контактов с Email
📝 Пример таблицы для импорта списка контактов Telegram
📝 Пример таблицы для импорта пользователей с User ID
Для примера рассмотрим два варианта импорта:
1. Импорт со свойством Почта. Здесь имеется в виду импорт только почтовых адресов: создаём таблицу со столбцом с названием $email и указываем почты.
2. Импорт со свойствами Почта, Имя, Телефон, Любимый товар. В этом случае в базу лидов загружаются стандартные свойства $email, $name, $phone и ваше свойство Любимый товар.
Важно: Столбцы со свойствами должны иметь правильные названия. Стандартные свойства должны начинаться со знака $ (например $email, $name, $phone). Список стандартных свойств есть в этой статье, остальные свойства будут являться пользовательскими и их название не регламентировано (перед пользовательским названием не должен стоять знак $).
❗ На что стоит обратить внимание при импорте:
- Импортируемый файл должен быть в формате CSV
- Вес файла не должен превышать 30 Мб
- Столбцы со свойствами должны иметь правильные названия. Стандартные свойства начинаются со знака $. Остальные свойства — без знака $.
- В таблице нет столбцов с названием, но без содержания (например, если в таблице есть столбец $phone, но он пуст — уберите его).
- При импорте почт и телефонов строки не содержат дублей.
- В названии свойств и в их значениях них не должно содержаться лишних символов (пробелов, запятых и др.).
- Импортированные лиды учитываются в квоте пользователей. При этом, если вы импортируете данные в уже существующую карточку лида (импортируемый лид склеивается с существующим активным лидом), он не будет считаться новым.
🧐Какой вариант импорта выбрать?
- Если вы знаете User ID ваших пользователей, то выберите первый вариант — импорт зарегистрированных пользователей. Если в базе лидов Carrot quest уже есть пользователи с таким User ID, то отдельная карточка не создастся, а информация запишется в существующего пользователя.
- Если у вас есть база пользователей с емейлами, но без User ID, выберите второй вариант: импорт контактов с Email.
Заполните обязательный столбец с email и добавьте свои свойства. Важно, чтобы в импортируемом файле не было указано User ID. Так как в Carrot quest может быть несколько карточек лида с одинаковым емейлом, если мы найдём совпадение, информация запишется в последнюю активную карточку.
- Если у вас есть база подписчиков на Telegram-бота, собранного в другом сервисе, выберите третий вариант. Если у вас подключен модуль для чат-бота и триггерных сообщений в Telegram, вы сможете делать триггерные рассылки этим пользователям.
Загрузите файл с лидами и проверьте правильность определения свойств. Нажмите на «Импортировать лиды».
💡Совет: Чтобы потом легко найти всех импортированных лидов, добавьте им свойство с датой импорта или тег. Если вы импортируете через интерфейс, добавьте в таблицу для импорта столбец со своим свойством (к примеру, "Импорт") и запишите в ячейки дату. Тогда у всех импортированных пользователей появится свойство "Импорт", в котором будет записана дата.
Добавить тег к импортируемой базе можно на странице предпросмотра файла:
Это поможет легко настроить сегментацию и выделить только нужных лидов.
Импорт происходит в фоновом режиме, вы можете закрыть вкладку или перейти в другой раздел в Carrot quest без потери данных. Когда импорт будет закончен, вам придёт сообщение в колокольчик в правой верхней панели
В этом же сообщении будет указано, сколько лидов было добавлено, обновлено и сколько не было загружено из-за ошибок.
⚠️Почему не получается сделать импорт?
При импорте вы можете получить подобную ошибку:
Проверьте, есть ли при предпросмотре файла указание на лидов с ошибкой. Оно выглядит вот так, при наведении на надпись будет показано, в каких строках есть ошибки:
Возможные причины ошибки:
- неправильно оформленные названия столбцов
- дубликаты карточек (одинаковые User ID / емейлы)
- невалидные емейлы - с запятой вместо точки, без знака @
- несколько емейлов в одной строке через запятую - разбейте такую ячейку на две
Предпросмотр не указывает на ошибки в лидах, но при этом ошибка импорта все равно появляется? Проверьте следующие моменты:
☑ Данные точно разбиты на столбцы
☑ Системные свойства имеют названия, и эти названия верные
☑ Файл при открытии имеет читаемую кодировку без заменяющих символов �
☑ Файл весит менее 30 Мб
☑ Файл не имеет пустых столбцов
☑ Файл имеет кодировку UTF-8 BOM (можно изменить ее, например, в Notepad++)
Если импорт все равно не получается выполнить, обратитесь в поддержку.
Импорт через Rest API
Загрузить свою базу пользователей в нашу систему можно также через Rest API. Подробнее ознакомиться с API можно по этой ссылке.
❗ Важно: При загрузке пользователей нужно воздержаться от синхронного вызова API, т.к это может вызвать значительные нагрузки на нашу систему и ваш токен заблокируется. Оптимальное количество обращении — 2-3 в секунду.
Пример кода импорта пользователей на PHP:
💡 Если требуется обновить данные об уже существующих лидах, это также можно сделать при помощи импорта. При этом нужно обращать внимание на то, есть ли у нужных пользователей User ID либо только емейл.
Выгрузите из базы лидов нужный сегмент лидов для обогащения их данными. Это можно сделать при помощи экспорта. Разделите лидов на тех, кто имеет User ID и тех, кто его не имеет и обладает только емейлом. Далее отредактируйте получившуюся таблицу по инструкции выше, добавив в нее столбец с новыми данными.
Импортировать обогащенную базу в проект нужно также с сохранением User ID (если он есть) и емейла, чтобы не создавать новые карточки, а добавить данные в уже существующие.