Перші кроки
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування smart-контейнерів
- Оформлення промовкладки для Gmail
- Додавання Ролловера
- Додавання анкорних посилань
- Бібліотека модулів
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Створення кнопки СТA
- Робота з блоком "Зображення"
- Робота з блоком “Таймер"
- Використання ШІ в email-редакторі
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного застосунку
- Створення та завантаження ключа Firebase
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Типи діплінків
- Надсилання тестових повідомлень із налагодження запитів
- Налаштування віджетів для сайту
- Виклик віджета
- Налаштування геоданих для правил виклику віджетів
- Збереження даних із віджетів у поля контактів
- Захист від роздратування
- Дії після заповнення форми
- Заміна системного сценарію Double Opt-In
- Створення pop-up-форм за допомогою Google Tag Manager або WordPress
- Надсилання подій з віджетів eSputnik до Google Analytics
- A/B-тестування віджетів
- Збір контактних даних за допомогою форм запитів
Автоматизація
- Налаштування та редагування сценаріїв
- Налаштування умов запуску та зупинки сценарію
- Блок “Старт”
- Група блоків “Популярні”
- Група блоків “Повідомлення”
- Використання блока повідомлень “Одне з багатьох”
- Група блоків “Контакт”
- Група блоків "Умови"
- Група блоків “Інше”
- Група блоків “Повідомлення на групу”
- Група блоків “Час”
- Розширені параметри блоків сценаріїв
- Дозволений час відправлення
- Вебхуки в сценаріях
- Відстеження історії запусків сценарію
- Якщо сценарій не працює
- Подвійне підтвердження підписки
- Вітальна серія
- Вітальна серія із сегментацією за категоріями
- Запуск сценарію після імпорту контактів
- Регулярний сценарій для групи
- Вітання з днем народження
- Привʼязка сценарію до кнопки
- Використання змінних із замовлення у сценарії
- Збір відгуків про замовлення
- Реактивація клієнтів та підписників
- Відправка розсилки непрочитавшим
- Налаштування додаткових розсилок
- Відправлення нагадувань в заданий користувачем час
- А/B-тестування в сценаріях
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням API
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду за допомогою персоналізації
- Завантаження промокодів для використання в сценарії
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
Аналітика
- Звіт щодо email-розсилки
- Звіт щодо SMS-розсилки
- Звіт щодо розсилки Web Push
- Звіт щодо Viber-розсилки
- Звіт щодо розсилки Mob Push
- Звіт щодо розсилки App Inbox
- Звіт щодо Telegram-розсилки
- Звіт зі взаємодії з In-App
- Звіт зі взаємодії з віджетами
- Звіт щодо тригерної розсилки
- Звіт щодо AMP-розсилки
- Звіт щодо мультимовної розсилки
- Налаштування передачі UTM-міток
- Візуалізація доходу
- Відстеження ефективності кампаній у Google Analytics 4
- Статистика повідомлень
Мультимовність
Відстеження подій та поведінки
- Події для запуску тригерних розсилок
- Найменування користувацьких подій
- Валідація параметрів подій
- Відстеження активності на сайті за допомогою Generate event
- Підстановка даних з подій в повідомлення
- Розгалуження сценарію в залежності від параметрів події
- Відстеження активності клієнтів у мобільних застосунках
- Вебхуки для відстеження активності
- Аналітика подій
Товарні рекомендації
API
- Поширені питання: Інтеграція з API
- API-ключі
- Ресурси API для додавання контактів
- Використання API-ресурсу Generate event
- Передача замовлень API-ресурсом Generate event
- Отримання рекомендацій щодо API ресурсом Contact recommendations based on web tracking
- Використання API-ресурсу Send prepared message
Зміна системи
Документи
Інтеграція
Зовнішній ID для створення та оновлення контактів
Зовнішній ID — це унікальний ідентифікатор контакту, що генерується у вашій базі контактів. Щоб уникнути дублювання контактів, збирати всі доступні дані у єдиний профіль контакту і отримувати якомога повнішу інформацію про його взаємодію з вашою компанією, ми рекомендуємо використовувати його як основний ідентифікатор у полі API-запиту externalCustomerId (у мобільному SDK — user_id).
Типи ідентифікаторів
Контактні ідентифікатори можна розділити на умовно сталі і змінювані:
- умовно сталі — email, номер телефону та інші контактні дані, отримані від клієнта під час реєстрації.
- змінювані — web cookies, мобільні, телеграм та веб-токени.
Зазвичай спершу у систему потрапляють змінювані ідентифікатори, але зовнішній ID прив’язується лише до умовно сталих ідентифікаторів.
Важливо!
Зовнішній ID повинен створюватися у вашій системі у той момент, коли ви вперше отримуєте будь-який умовно сталий ідентифікатор
Щоб краще зрозуміти, як контактні дані потрапляють у систему і як оптимізувати ідентифікацію контактів, розглянемо 2 базові приклади використання: для мобільних додатків і веб-сайтів.
Приклад 1. Створення і оновлення контакту з мобільного додатку
- Контакт встановлює додаток на мобільний пристрій з ОС Android.
- Додаток передає у eSputnik мобільний токен контакту (метод API Add/update a contact).
- У eSputnik створюється контакт з цим токеном як ідентифікатором.
- Контакт реєструється у додатку.
- У вашу систему потрапляють умовно сталі ідентифікатори, такі як email, номер телефону чи ім’я.
- Ваша система присвоює цьому контакту унікальний ID і передає його в eSputnik разом з іншими ідентифікаторами, у тому числі з мобільним токеном (метод API Add/update a contact).
- eSputnik знаходить контакт з цим мобільним токеном і оновлює його картку, записуючи в неї нові ідентифікатори.
Приклад 2. Створення і оновлення контакту для веб-сайту
- Незалогінений контакт відвідує ваш сайт.
- У eSputnik передаються і записуються відповідні cookies. Контакт не створюється (використовується скрипт веб-трекінгу).
- Контакт реєструється на сайті або підписується на розсилку.
- У вашу систему потрапляють умовно сталі ідентифікатори, такі як email, номер телефону або ім’я.
- Ваша система присвоює цьому контакту унікальний ID і передає його в eSputnik разом з іншими ідентифікаторами (Add/update a contact або Subscribe contact).
- eSputnik зберігає контакт з усіма переданими ідентифікаторами і додає його попередню історію взаємодії з вашим сайтом (файли cookies).
Після того, як контакт був створений у eSputnik з полем External ID, ми рекомендуємо проводити кожне його оновлення з унікальністю за цим полем — наприклад, при логіні (Add/update a contact), створенні замовлення (Add orders або Generate event) тощо. Таким чином ви зможете постійно підтримувати актуальність всіх контактних даних, оскільки зовнішній ID унікальний і незмінний, а інші ідентифікатори, навіть умовно сталі, можуть змінюватися.
Примітка
Якщо ваша система не присвоює контактам ID, ви можете використовувати системний ID eSputnik (contactId) і потім зберігати його на своїй стороні як ідентифікатор клієнта. Але використання External ID є кращим варіантом, адже така ідентифікація на 100% убезпечує від створення дублікатів.
Зовнішній ID в методах API для одиночних контактів
Ознайомтеся з оновленою логікою роботи методів API, що працюють з одним контактом:
Створити контакт (Add/update a contact)
Приймаючи запит, система шукає відповідний контакт за зовнішнім ID:
- якщо контакт з цим зовнішнім ID знайдено, він оновлюється даними із запиту;
- якщо контакт з цим зовнішнім ID був вилучений, його буде відновлено;
- якщо контакт не знайдено, він створюється у системі.
- якщо зовнішній ID у запиті відсутній, логіка створення залишається незмінною.
Оновити контакт (Update contact)
В URL запиту задається contactId, а в тілі передається зовнішній ID:
- якщо цей зовнішній ID вже належить контакту з іншим contactId, відбудеться помилка;
- якщо зовнішній ID не належить іншому контакту, контакт оновиться і йому буде наданий цей ID.
- якщо зовнішній ID не задано, логіка лишається без змін
Отримати контакт (Get contact)
Зовнішній ID додається до даних контакта, які повертаються запитом.
Підписати контакт (Subscribe contact)
У логіці пошуку контакту зовнішній ID має найвищій пріоритет; якщо контакт за цим ідентифікатором не знайдено, система шукає його за email-адресою, якщо email не знайдено — за номером телефону.
Зовнішній ID в методах API для роботи з масовими контактами
Оновлена логіка роботи масових методів API:
Пошук (Search contacts)
Ви можете встановити унікальність пошуку контакту за полем "externalCustomerId". У цьому випадку встановити інші параметри пошуку не можна.
Імпорт (Add/update contacts)
При імпорті контактів можна використовувати будь-яке поле для визначення їх унікальності. Наприклад, імпортувати контакти з унікальністю за email-адресою, і при цьому додавати чи оновлювати їхні зовнішні ID.
Використання в ресурсі Send prepared message
Підтримано можливість використання зовнішнього ID в ресурсі Send prepared message. Це дозволяє відправляти одиночні повідомлення через сценарій з урахуванням цього поля.
Окрім locator або contactId, вхідні параметри також можна валідувати за полем externalCustomerId.
Пріоритет перевірки полів: contactId > externalCustomerId > locator.
Експорт зовнішнього ID у BigQuery та PostgreSQL
Експортуйте зовнішні ID у BigQuery та PostgreSQL — вони з'явяться у відповідній колонці у таблиці contacts. За замовчуванням ця опція доступна для всіх нових експортів. Якщо потрібно створити її для вже існуючих експортів, напишіть у службу підтримки на support@esputnik.com.
Пошук контактів без зовнішнього ID в обліковому записі eSputnik
Створіть умовну групу, щоб перевірити, чи всі контакти мають зовнішній ID.
- Перейдіть до "Контакти" → "Групи" та створіть умовну групу.
- Додайте умову: "Поля контакту" → External ID → "не вказано" та натисніть "Готово".
Система знайде всі контакти без зовнішніх ідентифікаторів та помістить їх у цю групу. Оскільки сегмент динамічний, все нові контакти без зовнішніх ID також автоматично поміщатимуться до нього.