Импорт участников

Редактировал(а) Оксана Козловская 2026/02/04 12:43

Импорт маркетинговых списков

В Manzana Campaign есть возможность импортировать из файла маркетинговый список контактов. Функция предназначена только для импорта существующих контактов и не предоставляет функцию создания новых, поэтому из файла в список будут добавлены только те контакты, которые есть в системе на момент импорта.

Чтобы импортировать маркетинговый список необходимо войти в левом боковом меню в раздел – «ИМПОРТ». При этом откроется основная страница раздела, которая отображает перечень загруженных маркетинговых списков, тип импорта и общие статистические характеристики импорта.

Для создания нового импорта необходимо нажать на кнопку «Создать» в правом верхнем углу экрана.

1746536982263-349.png

В настоящее время можно загружать файлы размером до 300 Мб. При этом допустимое количество строк для файла будет зависеть от длины строк:

  • короткие строки (числа, латиница) можно загружать в количестве ≈ до 15-20 млн строк,
  • длинные строки (текст, кириллица, сложные символы) можно импортировать в количестве ≈ до 3-7 млн строк.

Следует также учитывать тип импорта: универсальный импорт использует больше столбцов, чем все прочие типы. Соответственно, при этом типе импорта можно загрузить меньшее количество строк.

Виды импорта

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

В Manzana Campaign существует 5 видов импорта для списков контактов и один для внешних купонов. Подробнее о функционале загрузки купонов можно узнать в документации по ссылке. В рамках этой статьи рассмотрим только импорт списков контактов. 

1759406527926-996.png

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

Виды импорта списков контактов:

  • По электронной почте: импорт осуществляется по значениям электронной почты;
  • По номеру телефона: импорт осуществляется по значениям номеров телефона;
  • По контакту: импорт осуществляется по значениям внутренних идентификаторов контактов в CRM;
  • По карте: импорт осуществляется по значениям идентификаторов карт лояльности участников;
  • Универсальный: импорт осуществляется по значениям номеров телефонов и содержит до 15 произвольных характеристик, которые можно использовать в рассылке в качестве метапеременных. Важно: в качестве фильтров эти значения использовать невозможно.

Чтобы выполнить импорт необходимо сначала подготовить импортируемый файл. Есть несколько особенностей и правил подготовки файла импорта:

Для импорта должен быть использован соответствующий шаблон в формате .csv. Скачать шаблон можно на форме импорта, для этого нажать «Скачать Шаблон»

1746537140150-883.png

Шаблоны для импорта

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

  • По электронной почте. Содержит 1 столбец с заголовком «email» и списком емейлов:

1752843201614-264.png

  • По номеру телефона. Содержит 1 столбец с заголовком «phone» и списком номеров телефонов:

1752843297140-612.png

  • По контакту. Содержит 1 столбец с заголовком «contactid» и списком идентификаторов контактов:

1752843398290-579.png

  • По карте. Содержит 1 столбец с заголовком «cardid» и списком номеров карт:

1752843450552-213.png

  • Универсальный. Содержит 16 столбцов, первый с заголовком Phone и 15 для метапеременных.

1752843510349-320.png

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

Требования к файлу:

  • Загружаемый файл должен быть строго в формате csv с кодировкой UTF-8. Советуем проверять и менять кодировку посредством программы Notepad++.
  • Структура шаблона не должна меняться. При изменении структуры документа, файл не загрузится.
  • Для импортов загружаемый файл должен обязательно иметь заполненный первый столбец в соответствии с видом импорта.
  • Для Универсального импорта:
    • Обязательным для заполнения является первый столбец Phone,      
    • Остальные со 2 по 16 столбцов могут быть заполнены не все (столбцы должны быть, но остаются пустыми) и в произвольном порядке.  
    • Для столбцов со 2 по 16 столбцы нет ограничений по формату вводимого текста, то могут быть символы, ссылки и тп.
    • Проверка и валидация значений при загрузке не выполняется.

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

Импорт файла

После того, как файл подготовлен, его можно импортировать

Для загрузки подготовленного файла необходимо:

Нажать кнопку «Выбрать файл» или перетащить нужный файл с устройства в окно загрузки. При этом наименование импорта автоматически меняется на название импортируемого файла.

1746537277447-765.png

Под отображением наименования загружаемого файла выбрать «Способ загрузки»: Cохранить или Cохранить и выгрузить в Manzana Online. По умолчанию стоит Сохранить.

  • При выборе «Cохранить» список сохраняется в CDP Manzana Campaing, и может быть использован при работе с Manzana Campaing или Manzana BI.
  • При выборе «Cохранить и выгрузить в Manzana Online» список сохраняется в CDP Manzana Campaing и дополнительно загружается в Manzana Online, поэтому будет доступен к использованию в обоих модулях.

1746537535738-935.png

Нажать кнопку «Импортировать». После этого запускается импорт. Он может занять некоторое время.

Появляется окно с результатами импорта.

  • «Успешно импортировано» –количество строк в файле.
  • «В Campaign импортировано» – количество контактов, которые были импортированы в маркетинговый список.

1746537688826-170.png

Особенности импорта

  • Дубли в файле по первому столбцу схлопываются автоматически.
  • Несуществующие в базе данных контакты не будут добавлены в новый список контактов.