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

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

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

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

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

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

В поле не можна додавати текст та спецсимволи.

Адреса

Поле складається з таких полів:

• Адреса
• Країна
• Місто
• Область
• Поштовий індекс

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

Якщо ви імпортуєте файл, що містить дані про країну, значення мають передаватися у форматі ISO 3166-1 alpha-2 (наприклад, UA, DE, FR).

Поле Країна можна використовувати для створення умовних груп. В умовах сегментації назви країн доступні з автодоповненням.

Мова

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

Значення в імпортованому файлі прописується в загальноприйнятому міжнародному форматі мовних тегів RFC 5646.

Наприклад:

• uk, en
• uk-UA (українська, Україна), en-US (англійська, США).

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

Докладніше в статті.

Market ID

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

Поле заповнюється автоматично, якщо параметр marketId передається в одному з таких запитів:

• замовлення через API-ресурс Add orders;
• замовлення через API-ресурс Generate event (події orderCreated, orderUpdated);
• веб-трекінг подія purchasedItems через REST API веб-трекінгу.

Поле Market ID можна використовувати для створення умовних груп, наприклад, щоб таргетувати контакти з певного ринку або знайти контакти без ідентифікатора ринку.

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

Текстове поле, призначене для зовнішніх ідентифікаторів контактів. Наприклад, при перенесенні бази важливим є збереження ідентифікатора контакту з вихідної бази даних; у цьому випадку заповнюється поле Ключ контакту.

External ID

Зовнішній ID — це унікальний ідентифікатор контакту, що генерується у вашій базі контактів та допомагає уникнути дублювання контактів. На відміну від інших каналів, він ніколи не зміниться. Він дозволяє збирати всі доступні дані у єдиний профіль і отримувати якомога детальнішу інформацію про взаємодію контакту з вашою компанією.

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

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

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

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

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

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

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

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

• інформації про посаду, місце роботи;
• цілих чисел (наприклад, кількості співробітників);
• будь-яких додаткових обʼємних даних

Число

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

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

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

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

Дата

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

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

Дата з часом

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

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

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

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

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

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

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

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

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

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

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

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

Локація

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

В умовах сегментації поля адреси та локації можуть мати схожі назви: Країна, Область, Місто. Після вибору умови в сегменті буде видно уточнення в дужках, наприклад Місто (Локація) або Місто (Адреса).

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

Часовий пояс

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

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

Сontact ID

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

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

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

Імпорт

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