Ідентифікатори клієнтів і відповідність

Дії відвідувачів сайту та користувачів мобільного застосунку надходять до eSputnik у вигляді подій. Щоб співвідносити події з конкретними контактами, використовується кілька типів ідентифікаторів. Оскільки один контакт може мати кілька ідентифікаторів (email, номер телефону тощо), під час передачі події вам потрібно вибрати головний ідентифікатор, навколо якого збиратимуться інші дані.

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

Історії змін контакту акаунт не зберігає. У профілі видно лише поточні значення й дату останнього оновлення, але не те, який запит і яке поле їх змінили.

Контактні ідентифікатори в eSputnik

• Зовнішній ID – унікальний ідентифікатор контакту у вашій системі; повинен передаватися у поле контакту External ID.
• Email-адресу можна використовувати як головний ідентифікатор, якщо ви акцентуєтеся на email-маркетингу.
• Номер телефону — використовується для Viber- та SMS-кампаній.
• Псевдо-ID користувача – унікальний ідентифікатор, який генерується мобільним застосунком у момент, коли користувач встановлює його; user_pseudo_id залишається незмінним при оновленні застосунку, але змінюється при його перевстановленні.
• Мобільний push-токен — ідентифікатор, який генерується моб-пуш-провайдерами і використовується для надсилання push-повідомлень застосункам, встановленим на певних пристроях.
• Веб push-токен — ідентифікатор, який генерується веб-пуш-провайдерами і використовується для надсилання push-повідомлень до веб-браузеру.
• Telegram токен — ідентифікатор, що додається до кожного підписника telegram-бота або створюється разом з контактом при передачі через API. Використовується для відправлення Telegram-повідомлень.
• Системний ID – унікальний ідентифікатор контакту в eSputnik.
• Cookies — невеликі файли з блоками даних, які створюються та використовуються веб-серверами для зберігання інформації про пристрій користувача та для відстеження його онлайн-активності. 
• IDFA/AAID – ідентифікатори, що використовуються на пристроях iOS та Android; IDFA/AAID дозволяють розробникам та маркетологам застосовувати активність користувачів у рекламних цілях.
• Device ID — ідентифікатор пристрою користувача мобільного застосунку, який передається до eSputnik через SDK. Користувачам з Device ID можна відправити розсилку App Inbox. Щоб виокремити всі контакти у вашій базі, які мають Device ID, створіть умовну групу і включіть до неї умову “Усі контакти з девайсом”.

Унікальним ключем подій, надісланих мобільним SDK, завжди є deviceId — однаково на iOS і на Android. External User Id ідентифікує контакт, але шукати за ним події SDK у Тригери → Історія подій не можна: пошук іде за Device ID.

Щоб відстежувати в eSputnik дії анонімних користувачів у інтернеті, використовуються файли cookie; дії анонімних користувачів у застосунку — user_pseudo_id.
Для зареєстрованих користувачів використовуються такі ідентифікатори:

• email
• номер телефону
• push токен
• user ID

Детальну інформацію про те, як встановити ID користувача, ви знайдете в документації за цим посиланням.

Джерелом відстеження даних є BigQuery.

Процес зіставлення ідентифікаторів

Зіставлення (об'єднання) контактів дозволяє ідентифікувати одну людину на кількох пристроях та в різних браузерах.

Коли анонімний користувач відвідує ваш сайт, а потім вашу програму, він розпізнається як два контакти з різними ідентифікаторами (user_pseudo_id і файли cookie).

Але коли користувач реєструється та входить у систему на мобільному та десктопному пристроях, контактні дані об'єднуються в один профіль.

Мобільний SDK до входу користувача створює анонімний контакт із Device ID. Коли після входу застосунок передає зовнішній ID методом setUserAttributes, система оновлює контакт із цим ID: Device ID і push-токен переходять до нього, а анонімний контакт видаляється.

Ви повинні визначити унікальний ідентифікатор, який не може використовуватися іншими контактами, наприклад ваш зовнішній ідентифікатор (рекомендовано).

📘

Ідентифікатори й канали

Ідентифікатор пристрою та мобільний токен можуть належати лише одному контакту. Коли дані контакту оновлюються через SDK за зовнішнім ID і система знаходить ідентифікатор пристрою та мобільний токен, що належать іншому контакту, вони переходять до оновленого. Один контакт може мати кілька ідентифікаторів пристроїв і мобільних токенів.

Унікальність контакта визначає його ідентифікатор, а не канал: ресурсом Add/update a contact той самий номер або адресу можна записати кільком контактам — для платформи це різні профілі. Якщо в запиті є і email, і телефон, контакт шукається за email, а переданий канал замінює наявний канал того самого типу.

Під час підписки через віджет діє інше правило: контакт шукається за ланцюжком «зовнішній ID → email і телефон разом → email → телефон → токен», а канал, який уже є в акаунті — на активному чи видаленому контакті, — не записується, щоб не створити дубля.

Дублікати не об'єднуються під час надсилання. Записи з різними ID контакту — це для платформи різні контакти, тож розсилка піде на обидва навіть за однакової адреси, і механізму, який об'єднав би їх під час надсилання, немає.

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