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

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

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

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

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

1. Импортируемый файл должен быть в одном из таких форматов: xlsx, xls, csv или txt и размером до 300 Мб.

2. Обязательными данными для импорта контактов в систему является email и/или номер телефона.

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

Подробнее про  подготовку файла >

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

Просмотр карточки контакта

Перейдите в раздел “Контакты” → “Все контакты” и выберите нужный контакт для просмотра,

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

Формат базовых полей 

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

Имя

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

Специальные символы запрещены, исключения:

• апострофы ' (в середине слова)

• дефисы – (в середине слова или между словами без пробелов)

• точка в конце короткого (до 3-х символов) слова (например, Jr.)

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

Имена, состоящие исключительно из цифр и спецсимволов, запрещены.

Фамилия

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

Email

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

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

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

Используется для отправки SMS и Viber-сообщений

При импорте контактов поле номера телефона может содержать числа и знаки “+” и “-”, круглые скобки и записываться в следующих форматах:

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

+380671234567

+489003779977

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

Адрес

Поле состоит из таких полей::

• Адрес

• Город

• Область

• Почтовый индекс

• Описание

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

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

Язык

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

Значения в импортируемом файле прописываются в общепринятом международном формате языковых тегов RFC 5646.

Например:

• “uk”, “en”

• “uk-UA” (украинская, Украина), “en-US” (английская, США).

Подробнее в статье.

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

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

External ID

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

Подробнее про внешний ID >

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

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

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

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

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

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

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

• информации о должности, месте работы;

• целых чисел (например, количество сотрудников);

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

Число

Может содержать только целые числа в интервале от -2147483648 до 2147483647. Установите диапазон, который позволит валидировать значения, которые вы собираетесь передавать в поле.

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

Дробное число

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

Дата

В поле “Дата” в карточке контакта обычно записывается любая дата, касающаяся клиента: день рождения, годовщина, дата регистрации и так далее.

При создании этого типа дополнительного поля активируйте опцию “Регулярная дата”, если хотите использовать эту дату для формирования условных групп:

Дата со временем

Поле “Дата со временем” используется для записи точной даты и времени событий или действий. К примеру, изменение статуса заказа.

В отличие от поля “Дата” позволяет делать запись более точной и детализированной.

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

Поле с заранее прописанными значениями для выбора. К примеру, пол человека:

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

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

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

Системные поля

Заполняются системой автоматически или с помощью API.

Приложения, Telegram, Web Push, Mob Push

В этих полях отображается информация о привязанном мобильном приложении, интегрированном Telegram-боте и настройках Web Push (если они есть).

Когда контакт устанавливает ваше мобильное приложение, SDK собирает данные об устройствах пользователя, связанных с приложением. Список мобильных устройств будет отображаться при наведении курсора на поле “Приложения”. Данные из поля “Приложения”  используются для создания App Inbox и In-App сообщений даже если у контакта нет мобильных токенов. 

Локация

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

Подробнее о работе геотрекинга в статье.

Часовой пояс

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

Часовой пояс контакта можно использовать для передачи триггерных сообщений только в разрешенное время. Подробнее в статье >

Es contact ID

Поле, содержащее внутренний ID контакта в eSputnik. Автоматически присваивается каждому контакту в процессе импорта в систему или при создании через API, содержит только цифры. Возле ID указывается источник попадания контакта в базу.

Карточка контакта з заполненными полями 

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

Импорт

При импорте следуйте рекомендациям по форматированию для различных типов полей, чтобы правильно обновить список контактов. Загрузите пример импортируемого файла в разделе “Импорт” в качестве образца. Пример файла содержит столбцы для базового импорта: email-адрес, имя и фамилию. Вы также можете включить в файл дополнительные столбцы, например телефонные номера или адреса.