Значення полів контактів | eSputnik Support

Дані користувача

Email

Омніканальність

Автоматизація

Відстеження подій та поведінки

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

Поля контактів використовуються для зберігання та збору інформації про ваших підписників та клієнтів, наприклад імені, дати народження, місцезнаходження і т.д. Ви можете використовувати ці дані для створення сегментів аудиторії або персоналізації вмісту повідомлень.

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

Підготовчий етап

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

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

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

  3. Усі дані мають бути розміщеними на одному листі (якщо формат файлу Excel) та розбиті по колонках. Якщо файл містить два або більше листів — імпорт даних буде здійснено тільки з першого листа.

Приклад імпортованого файлу

Докладніше про підготовку файлу >

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

Зіставлення полів

Перегляд картки контакту

Перейдіть до розділу “Контакти” → “Всі контакти” та оберіть потрібний контакт для перегляду або створіть новий натиснувши кнопку “Новий контакт”.

Перегляд картки контакту

В картці зберігаються усі дані, які завантажені через імпорт або передані через API. 

Формат базових полів 

За замовчуванням у кожному обліковому записі при створенні контакту доступні такі поля:

Ім'я

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

Спеціальні символи заборонені, винятки:

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

  • дефіси - (в середині слова або між словами без пробілів)

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

Дозволяється використовувати 3 слова, що складаються більш ніж з 3-х символів, та 3 слова, що складаються максимум із 3-х символів.

Імена, які складаються виключно з цифр та\або спецсимволів, заборонені.

Прізвище

Правила валідації такі ж, як і для поля “Ім'я”, за винятком того, що допускається будь-яка кількість слів будь-якої довжини (але сумарно не більше 40 символів).

Ім'я та прізвище

Email

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

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

Доладніше про зовнішній ID >

Формати заповнення додаткових полів 

Якщо стандартних полів недостатньо, можна додати потрібні поля самостійно.

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

Поле вміщує до 1000 символів у вигляді тексту або цифр. Наприклад, номер робочого телефону або пов'язана компанія. Заборонено використовувати такі символи: % ^ * | ~ {} '; "<>.

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

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

Це поле для великої кількості даних, вміщує до 5000 символів. Можна вводити текст і цифри, заборонені символи:% ^ * | ~ {} '; «<>.

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

Використовуйте текстові поле та область для:

  • інформації про посаду, місце роботи;

  • цілих чисел (наприклад, кількості співробітників);

  • будь-яких додаткових обʼємних даних

Число

Може містити лише цілі числа в інтервалі від −2147483648 до 2147483647. Встановіть діапазон, що дозволить валідувати значення, які ви збираєтеся передавати у поле.

Це поле можна використовувати, наприклад, для суми бонусів, накопичених клієнтом.

Число

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

Якщо для клієнтів передбачена можливість оцінювати або ранжувати їх рейтинг, рівень задоволеності або інші показники, дробові числа можуть використовуватися для точного відображення, наприклад, суми замовлення.

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

Дата

У полі “Дата” у картці контакту зазвичай записується будь-яка дата, що стосується клієнта: день народження, річниця, дата реєстрації та інше. 

Важливо

При ручному імпорті чи передаванні контакту через API формат дати має суворо відповідати формату: yyyy-MM-dd, dd/MM/yyyy, dd.MM.yy, dd.MM.yyyy.

Дата

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

Дата з часом

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

На відміну від поля “Дата” дозволяє робити запис більш точним і деталізованим.

Дата з часом

Важливо

При імпорті та передаванні контакту за API формат дати з часом має відповідати формату: YYYY-MM-DDTHH:MM.

Випадаючий список

Поле із заздалегідь прописаними значеннями для вибору. Наприклад, стать людини:

Випадаючий список

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

Список прапорців

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

Список прапорців

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

Заповнюються системою автоматично або за допомогою API.

Застосунки, Telegram, Web Push, Mob Push

Після інтеграції SDK, в цих полях відображається інформація про прив’язаний мобільний застосунок, інтегрований Telegram-бот та про налаштування для Web Push (якщо вони є).

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

Додатки, Web Push, Mob Push

Локація

Інформація про локацію контакту використовується для створення умовних груп при геотаргетингових розсилках.

Локація

Докладніше про роботу геотрекінгу в статті.

Часовий пояс

Коли користувач натискає на посилання в повідомленні, в систему потрапляє його IP. Якщо за отриманим IP можна визначити країну, регіон та місто, система робить це та записує у картку контакту відповідний часовий пояс. Наступні переходи за посиланням не оновлюють часовий пояс, оновити його можна лише за допомогою API.

Часовий пояс

Часовий пояс контакту можна використовувати, щоб надсилати тригерні повідомлення лише в дозволений час. Більше за посиланням > 

Es contact ID

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

Es contact ID

Картка контакту з заповненими полями 

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

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

Імпорт

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

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email