Импорт профилей клиентов и обновление данных

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

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

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

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

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

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

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

подсказка

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

• Tilda — интеграция с формами сбора данных конструктора сайтов Tilda.
• LPGenerator —интеграция с формами сбора данных конструктора лэндингов LPGenerator.
• Yandex AppMetrica — интеграция с метрикой приложений от Яндекса.

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

Чтобы создать новый профиль вручную, перейдите в окно редактирования базы или откройте список профилей, а затем в верхней части нажмите кнопку     и выберите способ импорта — "Вручную". Также можно воспользоваться контекстным меню БД.

Откроется форма создания/редактирования профиля. На этапе создания профиля вы можете добавить личные, контактные, регистрационные и отслеженные данные. Эти данные записываются в стандартные поля базы. Значение дополнительных (кастомных) полей указываются на вкладке "Доп. поля". Обязательные поля отмечены красной звёздочкой. Создать дополнительные поля, а также установить обязательные вы можете на странице редактирования базы данных. Ниже на вкладке Подписки вы можете сразу при создании подписать клиента на тот или иной ресурс.

предупреждение

Поля 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 и телефоны можно в принципе не записывать в поля профиля.

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

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

Опция "Игнорировать пустые" используется при обновлении данных профилей, которые уже есть в базе. Например, в поле профиля "vendor" уже записано значение "test.com", но сейчас вы импортируете файл, где поле "vendor" у этого клиента пустое. Платформа перезапишет поле, подставив пустое значение. Чтобы избежать этого, включите опцию "Игнорировать пустые" для соответствующей колонки. Тогда значение в поле "vendor" останется прежним.

Если в вашем файле-источнике неизвестные о клиенте данные записаны с помощью таких значений, как null, nil, none или undefined, платформа также может обработать эти значения как пустые. Для этого вам необходимо одновременно актировать поля "Считать нулевое значение пустым" и "Игнорировать пустые значения" рядом с той колонкой, где указано неизвестное значение. В таком случае платформа не обновит поле. При этом регистр null, nil, none и undefined неважен. Значения "0001-01-01 00:00:00 +0000 UTC" и "0001-01-01T00:00:00Z" тоже могут быть обработаны как пустые.

Если в вашей таблице есть шапка с именами колонок, в параметре "Пропустить строк" выберите количество строк, занятое шапкой.

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

Действие	Тип поля	Описание
Установить из	все типы: целое число, число с точкой, строка, дата, 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.

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