Skip to end of metadata
Go to start of metadata

В этой статье:

Способы импорта данных 

Импорт и обновление данных клиентов в базы профилей Альткрафт Маркетинг можно организовать в зависимости от объёма базы клиентов, принципа обработки новых подписчиков (напрямую или из CRM), технических возможностей компании. Доступно 5 способов загрузки данных:

  • Вручную - по одному с помощью формы редактирования профиля.

  • Буфер - импорт нескольких профилей списком, в том числе из буфера обмена (Ctrl+V).

  • Из файла - импорт файла-таблицы с данными клиентов.
  • Через API - настраиваемый импорт профилей - по одному или нескольким - средствами API.

  • Расписание - импорт профилей клиентов из внешней SQL базы данных по расписанию.

Помимо перечисленных способов получения клиентских данных, в Altcraft Platform есть готовые интеграции с внешними сервисами:

Создание профиля клиента вручную

Чтобы создать новый профиль, в меню импорта выберите Вручную. Или откройте базу данных и в верхней части нажмите кнопку + Вручную. Можно воспользоваться и контекстным меню импорта.

Откроется форма создания/редактирования профиля. На этапе создания профиля в ней доступно только 2 вкладки: Профиль и Подписки:

  • На вкладке Профиль введите данные клиента в стандартные и дополнительные поля. Обязательные поля отмечены красной звёздочкой. Создать дополнительные поля, а также установить обязательные вы можете на странице редактирования базы данных.
  • На вкладке Подписки вы можете сразу при создании подписать клиента на тот или иной ресурс

Поля Email и Телефоны на вкладке Профиль не используются для коммуникации с клиентом. В них вы можете записать базовые контакты, чтобы использовать их потом в подписках на ресурсы. Или можете оставить поля пустыми, а контактные данные записать напрямую в подписки.

Поле Email используется по умолчанию для идентификации профиля наряду с profile_id. Создать профиль вручную без этого поля нельзя. 

В деталях импорта можно отключить для нового профиля триггерные оповещения при импорте в базу данных, а также включить автоматическое определение геолокации клиента по данным в полях Reg IP (IP адрес регистрации) и IP (последний известный IP адрес):

Импорт нескольких профилей из буфера обмена

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

Откроется форма ввода, в которую вы можете ввести любые данные клиентов. При нажатии на кнопку Импортировать эти данные будут преобразованы в CSV таблицу

CSV (Comma-Separated Values — значения, разделённые запятыми) — текстовый формат, предназначенный для представления табличных данных.

В первой строке сформируйте шапку таблицы - названия полей данных, которые будут импортироваться. Названия колонок разделите запятой. Можете использовать любые удобные названия. Каждую новую запись начинайте с новой строки, разделяя запятой значения колонок, как на этом примере: 

При нажатии на кнопку Импортировать на основе данных будет создан файл import.csv - и откроется форма импорта из файла (которая описана тут же в следующем пункте).

Форма импорта из файла

Для загрузки большого количества профилей, а также для обновления существующих данных используется импорт из файла. Это могут быть .csv таблицы и .txt файлы в CSV формате, .xls и .xlsx таблицы данных. Файл может быть помещён в архив .zip или .tar.gz.

При вводе данных списком или из буфера обмена (предыдущий пункт статьи) создаётся временный файл import.csv - и также открывается форма импорта из файла.

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

Режим поиска профиля

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

  • По email адресу из профиля или подписок - по полю профиля Email или по email адресам из подписок.
  • По email адресу из профиля - только по полю профиля Email.
  • По email адресу из подписок
  • По телефону из полей данных или подписок - по полю профиля Телефоны или по телефонам из SMS подписок.
  • По телефону из SMS подписок
  • По Push данным из подписок - по идентификатору Push подписки (токену устройства).
  • По идентификатору профиля - по системному идентификатору profile_id.
  • По кастомному полю - по пользовательскому полю базы данных. Например, ID клиента в CRM компании.
  • По кастомному полю из подписок
  • Мультиматчинг - по Email или телефону из профиля и подписок (email_phone), или по email или телефону из подписок (email_phone_sub)

Подписка при импорте из файла

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

Для каждой подписки выберите  Ресурс Канал связи  и  Статус подписки. Для подписок на push уведомления дополнительно укажите провайдера push сервиса:


Соответствие колонок

Контактные данные профиля передавайте подписками на ресурсы Альткрафт (пункт выше). В поля профиля можно записывать эти данные в целях поиска профилей. Если идентификация клиентов настроена по данным CRM или другим идентификаторам, email и телефоны можно в принципе не записывать в поля профиля.

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

  • Колонка в базе данных - выберите поле профиля клиента, в которое нужно записать данные. Можно выбрать стандартные и кастомные (дополнительные) поля базы профилей. Если данные не нужно добавлять, выберите вариант Пропустить или удалите колонку, нажав на Х в правой части таблицы.
  • Колонка источника - выберите колонку вашего файла для получения данных. По каждой колонке будет отображаться первая запись - так вы можете точнее определить тип данных.

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


В колонке Действие необходимо указать, как именно вы хотите изменить значение в поле профиля: 

ДействиеТип поляОписание
Установить из

все типы: целое число, число с точкой, строка, дата, boolean, список, IP, теги, объект, массив объектов

Устанавливает значение, указанное в поле колонки источника.
Установить своёвсе типы: целое число, число с точкой, строка, дата, boolean, список, IP, теги, объект, массив объектовУстанавливает значение, введенное в поле вручную.
Удалить значениевсе типы: целое число, число с точкой, строка, дата, boolean, список, IP, теги, объект, массив объектовУдаляет поле из профиля.
Увеличить на значение в колонкецелое число, число с точкойУвеличивает значение на число, указанное в поле источника. Можно уменьшать значение, используя отрицательное число.
Увеличить на значение в полецелое число, число с точкойУвеличивает значение на число, введенное в поле вручную. Можно уменьшать значение, используя отрицательное число.
Добавить элементтегиДобавляет тег, указанный в поле источника.
Удалить элементтегиУдаляет тег, указанный в поле источника.
Добавить или изменить свойство полямассив объектовДобавляет или обновляет элемент, указанный в поле источника. Укажите путь к свойству поля, которое хотите изменить.
Удалить свойство полямассив объектовУдаляет элемент из поля, указанного в источнике. Укажите путь к свойству поля.
Установить свойство на значение в колонкеобъектУстанавливает значение указанного свойства на значение из поля источника. Укажите путь к свойству поля, которое хотите изменить.


Детали импорта

В деталях импорта выберите Способ импорта - он будет зависеть от того, добавляете вы новые записи или обновляете уже существующие в базах профилей Altcraft:

  • Добавить новых и обновить существующих

  • Только добавить новых, не обновлять существующих

  • Только обновлять существующих, не добавлять новых

Помимо этого в блоке Детали импорта включаются дополнительные опции:

  • Не запускать связанные с этим действием триггеры - не запускать сценарии и триггерные кампании, настроенные на импорт в выбранную базу данных.
  • Определить геолокацию по Reg IP/ IP - при передаче данных в поля Reg IP или IP в формате IPv4 Альткрафт автоматически определит геолокацию, заполняя такие поля профиля, как Страна, Город - или Страна рег. и Город рег. также будет отмечено положение профиля на виджете карты.
  • Переподписать пользователей независимо от их текущего статуса подписки - изменить глобальный статус всех импортируемых профилей на "Подписан".
  • Создать статический сегмент по результатам этого импорта - при импорте профилей автоматически создается статический сегмент.

Поле status при импорте


При импорте из файла и базы данных можно указать глобальный статус профиля в виде поля _status. Глобальный статус профиля может быть указан как в текстовом, так и в числовом виде.

Возможные значения поля:

  • 0, "subscribed" - "Подписан" (доступен для коммуникации по всем каналам связи)
  • 1, "unsubscribed" - "Отписан" (отписался от получения сообщений по всем каналам)
  • 2, "complained" - "Жалобщик" (пожаловался на спам, коммуникация остановлена)
  • 3, "hardbounced" - "Hard bounced" (провайдер полность отказался принимать сообщения на этот адрес)
  • 4, "unconfirmed" - "Не подтвержден" (подписчик зарегистрировался, но не подтвердил согласие на получение рассылок)
  • 5, "suspended - "Приостановлен" (подписка приостановлена на некоторое время)
  • 6, "invalid" - "Не валиден" (исключен из маркетинговых кампаний по любым другим причинам)

API импорт

API используется для интеграции с внешними системами - сайтами, приложениями, сервисами управления клиентскими данными (CRM), формами сбора данных.

  • Для импорта или обновления одного профиля используйте этот запрос.
  • Другие запросы к API импорта описаны в разделе Профили.
  • Управление подписками профиля описано в разделе Подписки.

Импорт из внешних SQL баз данных по расписанию

Альткрафт может автоматически забирать данные для импорта новых профилей клиентов и обновления существующих из внешней таблицы данных MySQL, MSSQL, PostgreSQL или Oracle RDBMS.

Инструкция по настройке импорта по расписанию вынесена в отдельную статью.

  • No labels