Как импортировать контакты и данные

Импорт — это загрузка контактов и персональных данных клиентов в CDP Sendsay.

Импорт можно осуществить тремя способами:

• загрузить подготовленный файл с контактами и другими данными, или добавить список контактов вручную в интерфейсе;
• настроить автоматический импорт из файла по расписанию — если вам нужно регулярно импортировать новые контакты и данные;
• через Sendsay API:
  • обычный импорт — используется по умолчанию, подходит для длительного хранения данных;
  • экспресс-импорт — предназначен для быстрой загрузки большого количества email-адресов и данных для персонализации без хранения контактов в основной базе. Импортированные данные хранятся и управляются отдельно, не становясь частью данных клиента. Используйте этот способ импорта, если вам нужно загрузить данные и сразу сделать по ним выпуск.

Ещё вы можете импортировать контакты в Telegram-бота: в этом случае контакты добавляются не в общую базу, а в конкретного подключённого бота.

Чтобы начать ручной импорт, перейдите в раздел Подписчики → Просмотр подписчиков и нажмите «Импортировать контакты». Также контакты можно загрузить сразу в список: для этого выберите нужный список и нажмите «Импортировать».

Важно

Пользуясь бесплатным тарифом «Пробный» можно импортировать в базу до 200 адресов. Для работы с большим количеством контактов необходимо выбрать подходящий тариф.

Если вы хотите загрузить контакты из файла — посмотрите статью о том, как его подготовить:

Как подготовить файл для импорта

Важно

Файлы формата XLSX имеют ограничение в 1 048 576 строк на один лист. Учитывайте это при импорте объёмных файлов.

Импорт проходит в три шага:

1. Загрузите данные для импорта

Каждый из импортируемых клиентов должен иметь в качестве основного контакта почту, телефон, CSID или Mobile push-идентификатор — без этих данных создать профиль клиента в системе не получится. Загрузить контакты и данные на странице Импорт подписчиков можно двумя способами:

• скопировать в интерфейс;
• загрузить файлом в формате CSV, XLSX, TSV, TXT или ZIP. Обратите внимание: система загружает данные из одного файла, и если данные ваших клиентов находятся в разных файлах, их необходимо объединить.

Все данные одного клиента должны находиться в одной строке. Если вы используйте Excel — вносите данные в ячейки. Во всех остальных случаях используйте разделители: запятую, точку с запятой или табуляцию. Разделитель должен быть одинаковым в каждой строке.

Как подготовить файл для загрузки контактов

Если у клиента отсутствуют какие-то данные, вместо них нужно поставить два разделителя подряд. Например, вот так будет выглядеть запись для импорта данных двух клиентов, где у первого есть все данные, а у второго имя и город неизвестны:

pochta1@gmail.com, Иван, Иванов, Москва, 1970-01-21
pochta2@gmail.com, , Фёдоров, , 1980-10-18

Даты и номера телефонов должны быть записаны в правильном формате:

• дата записывается как ГГГГ-ММ-ДД;
• номер телефона должен состоять из 10 или 11 цифр в любом виде (со скобками, пробелами или цифры подряд). Для России код страны (7, +7 или 8) писать необязательно.

Важно

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

Список ошибок можно будет увидеть в отчёте по импорту. Чтобы исключить из импорта строку с данными, добавьте символ # в начало этой строки.

После загрузки данных нажмите «Продолжить».

2. Настройте параметры импорта

Проверьте, правильно ли отображаются данные

На странице настроек вся информация о импортируемых данных отображается в таблице. Если вместо данных показываются странные значки или в одном столбце выводятся разные данные, нажмите «Изменить параметры импорта» и поменяйте соответственно кодировку или разделитель. Если в первой строке файла были указаны наименования столбцов, поставьте галочку «В первой строке указаны названия полей», и они не будут учитываться при импорте.

Выберите поля для хранения данных

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

Выберите основной контакт

Важно

Этот пункт не показывается в двух случаях — когда вы импортируете данные клиентов в список и когда у каждого клиента по одному контакту.

В базе не может быть двух клиентов с одинаковым основным контактом — если вы импортируете данные, которые уже есть в сервисе, они объединяются в один профиль клиента. Есть два варианта объединения данных:

• основной контакт уже есть в базе → все новые данные записываются в существующий профиль клиента поверх старой информации,
• совпадает не основной контакт → новые данные из строки записываются в новый профиль, туда же добавляются старые контакты с сохранением статистики.

Важно

Если вы импортируете email и телефон, но не планируете отправлять SMS — сохраните телефон в отдельном поле дополнительной анкеты, а не как дополнительный контакт: так при экспорте email-сегмента сможете выгрузить и email, и телефон клиента.

Выберите или создайте список для импорта

Важно

Этот пункт не показывается, если вы импортируете контакты в список.

Для удобства добавляйте контакты сразу в список — так с ними будет проще работать в будущем.

Подключите дополнительные настройки (опционально)

Дополнительные настройки нужны для работы с автоматизациями. Импорт по умолчанию не запускает сценарии со Стартовым событием Добавление в список при импорте. Чтобы это изменить, поставьте галочку «Учитывать импорт для запуска сценариев».

После настройки импорта нажмите «Импортировать».

3. Дождитесь окончания импорта

Время импорта зависит от размера файла — чем больше данных, тем дольше может занять загрузка. Процесс импорта отображается в Журнале заданий — там же будет доступен отчёт с результатами. Также отчёт отправим на почту, указанную в настройках аккаунта.

Чтобы проверить, как загрузились данные конкретного клиента, перейдите в раздел Подписчики → Просмотр подписчиков, откройте профиль любого импортированного клиента и перейдите во вкладку Данные.

Отчёт с результатами импорта в Журнале заданий

Отчёт об импорте можно посмотреть в Журнале заданий: для этого дождитесь окончания импорта и нажмите на появившуюся подсказку.

Чтобы открыть отчёт, нажмите «Детали»:

Откроется всплывающее окно, где во вкладке Детали выводятся данные о результатах импорта:

• Строки:

  • Количество строк с данными — это общее число строк в документе, содержащих данные для импорта.

  • Строк с повторами — число строк с повтором основного контакта.

    Например, если в файле импорта есть три строки с одним и тем же email-адресом, то все три строки будут внесены в базу. Если данные (помимо основного контакта) в строках разные, то они обновятся, а если одинаковые — останутся без изменений. В отчёте же эти три строки отобразятся как повторы.

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

  • Строк с ошибками — число строк без основного контакта, с опечатками или с данными, которые не соответствуют формату поля — например, если в числовое поле вставлен текст. Причины ошибок можно будет увидеть в отчёте. Строки с ошибками не импортируются.

  • Принятых к импорту строк — количество строк, которые будут импортированы, без учёта ошибок.

• Подписчики

  • Подписчики, у которых импортированные данные совпали с данными из базы — количество клиентов, чьи данные уже содержатся в базе.

  • Новые подписчики в базе — общее количество добавленных клиентов.

    Контакты импортируются в одном из статусов:

    • Подтвержденные — контакты, не требующие разрешения на отправку рассылок.
    • Неподтвержденные — контакты, которым нельзя отправлять рассылки, пока они не подтвердят подписку.

    Неподтвержденные контакты будут недоступны для рассылок сразу после импорта. Для включения таких адресов в рассылку их нужно активировать.

    Как активировать неподтверждённые адреса

• Подписчики, у которых обновились данные — число клиентов, чьи данные обновились благодаря импорту. Сюда же попадают повторы с обновлением данных.

• Новых + обновлённых — общее число новых и обновлённых контактов.

• В итоге добавлено в список — сколько контактов фактически внесено в список при импорте после исключения всех ошибок.

Важно

Адреса, которые добавляются в базу сверх лимита по используемому тарифу, попадут в ошибки импорта или загрузятся как неподтвержденные.

Посмотреть доступные тарифы и узнать о лимитах можно в калькуляторе тарифов.

В окне с результатами импорта можно скачать отчёт в одном из форматов: XLSX, CSV или JSON. Во вкладке Ответ API выводятся данные отчёта в виде ответа от API.

Смотрите также:
Как импортировать подписчиков (видеоурок)

Читайте также:
Как настроить автоматический импорт из файла по расписанию
Как подготовить файл для импорта
Какие бывают статусы у контактов