Значения полей контактов

В этой статье мы расскажем вам, как работать с базой контактов, чтобы максимально эффективно импортировать все необходимые данные в ваш аккаунт.

Подготовительный этап

Поддерживаемые форматы файла, которые можно импортировать: xlsx, xls, csv и txt.

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

• Обязательными данными для импорта контактов в систему является емейл и/или номер телефона.
• Все данные должны быть размещены на одном листе (если формат файла Excel) и разделены по колонкам. Если в файле содержится 2 и более листа, система их не воспримет — импорт данных будет только с первого листа.

Когда вы импортируете контакты в eSputnik, вам нужно сопоставить каждый столбец в вашем файле с соответствующим полем:

Подготовительный этап файла очень важен, так как если в полях контакта будут допущены ошибки, эти данные не попадут в систему.

Формат полей для заполнения при ручном импорте контактов

По умолчанию, в каждом аккаунте при создании доступны следующие поля:

Es contact ID

Поле, в котором содержится внутренний id контакта в eSputnik. Присваивается каждому контакту в процессе импорта в систему, содержит только цифры.

1. Текстовые поля

Текстовые поля предназначены для заполнения известных вам данных о клиенте. Эти данные используются для персонализации писем и для сегментации базы. К текстовым полям относятся такие поля как «Имя», «Фамилия», «Адрес»

• Имя

Максимальная длина значения в поле – 40 символов. Допускаются буквы любого алфавита и до 3 цифр.
Специальные символы запрещены, исключения:

• апострофы' (в середине слова)
• дефисы – (в середине слова или между словами без пробелов)
• точка в конце короткого (до 3-х символов) слова (например, Jr.)

Разрешается использовать 3 слова, состоящие из более чем 3-х символов, и 3 слова, состоящие максимум из 3-х символов.
Имена, состоящие исключительно из цифр и спецсимволов, запрещены.

Обратите внимание, что это поле используется для персонализации сообщений, может быть подставлено как в тело письма, так и в тему. Если у вас большой объём данных и не получается исправить все имена вручную, воспользуйтесь нашей функцией «Добавить точное имя».

• Фамилия

Правила валидации такие же, как и для поля «Имя», за исключением того, что допускается любое количество слов любой длины (но суммарно не более 40 символов).

• Адрес

Поля из раздела «Адрес» текстовые и предназначены для размещения полного почтового адреса каждого контакта. Поддерживают текст, цифры, нельзя добавлять спецсимволы.

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

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

• Часовой пояс

Когда пользователь кликает по ссылке в сообщении, в систему попадает его IP. Если по полученному IP можно определить страну, регион и город, система делает это и записывает в карточку контакта соответствующий часовой пояс. Последующие переходы по ссылкам не обновляют часовой пояс, обновить его можно только по API.

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

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

2. Email

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

Для одного контакта предусмотрен один емейл. Убедитесь в том, что емейл прописан без синтаксических ошибок (gmeil.com вместо gmail.com и тд). Если необходимо указать несколько емейлов, создается дополнительное текстовое поле, но отправка осуществляется на один емейл, который был указан как основной.

3. Номер телефона

Поле для ввода номера телефона, может содержать числа и знаки + и -.

Используется для отправки SMS и Вайбер-рассылок. Номер может быть записан в формате:

0955547708
+380953369635
380956639878
+38(050)1112325
095-663-69-36
80955563636
+38(050)111-23-25
38 050 141 23 25

Эти форматы поддерживаются в том случае, если при регистрации выбрана страна Украина. Если при регистрации вы выбрали другую страну, поле sms заполняется в международном формате:

380671234567
79003779977

При заполнении поля нельзя добавлять текст и спецсимволы.

4. Дата рождения

Это поле для ввода даты в формате: yyyy-MM-dd, dd/MM/yyyy, dd.MM.yy, dd.MM.yyyy

Важно: При передаче контакта по API формат даты должен строго соответствовать формату: yyyy-MM-dd, dd/MM/yyyy, dd.MM.yyyy. Если нужно передать контакту значение для поля типа "дата со временем", тогда используйте формат вида: yyyy-MM-ddTHH:MM:SS.

5. Ключ контакта

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

6. Пол

Пол: из выпадающего списка заполняется только 2-мя значениями — м или ж. Указывать значения можно только маленькими буквами. Переменная используется для создания условных групп и персонализации писем.

7. Язык

Текстовое поле, используется для сегментации базы и отправки мультиязычных сообщений. Чтобы поле "Язык" было валидным, значение прописывается в общепринятом международном формате.

Например:

• “ru”, “en”

• “ru-RU” (русский, Россия), “en-US” (английский, США).

Формат заполнения дополнительных полей

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

Текстовое поле

Поле предназначено для заполнения информации о контактах, вмещает до 1000 символов. Может содержать как текст, так и цифры. Запрещено использовать следующие символы: % ^ * | ~ { } ’ ; "< >

Текстовая область

Это поле для большого количества данных, вмещает до 5000 символов. Можно вносить текст и цифры, запрещенные символы: % ^ * | ~ { } ’ ; «< >

Используйте текстовые поле и область для:

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

Число

Используйте числовое поле для импорта целых чисел. Может содержать только целочисленные значения в интервале от −2147483648 до 2147483647. Это поле можно использовать для персонализации писем и сегментации, например по сумме бонусов, накопленной клиентом.

Дата

Актуальные форматы для даты: yyyy-MM-dd, dd/MM/yyyy, dd.MM.yy, dd.MM.yyyy, для даты со временем: YYYY-MM-DDTHH:MM:SS.

Существует понятие «Регулярная дата», например дата регистрации, или годовщины.

Поставьте галочку, если вы хотите использовать эту дату для формирования условных групп:

Выпадающий список

Поле с заранее прописанными значениями для выбора:

При создании контакта выбирается одно из прописанных значений (можно выбрать только одно значение):

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

Список флажков

Поле с заранее прописанными значениями для выбора:

Можно проставить несколько значений:

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

Образец файла для импорта

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

Прочтите также статью о том как правильно импортировать файл в систему eSputnik. После того, как вы импортируете файл в систему вам на почту придёт письмо-уведомление о том, что группа успешно создана.

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