Перші кроки
Дані користувача
- Огляд адаптивного 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
Зміна системи
Документи
Інтеграція
Інтеграція з Google BigQuery
BigQuery – це хмарна база даних, яка входить до складу Google Cloud Platform. Користувачі BigQuery можуть завантажувати великі обсяги даних із високою швидкістю, зберігати їх у вигляді двовимірних таблиць, звертатися до них, використовуючи SQL-запити, і вивантажувати результати обробки даних.
Інтеграція eSputnik із BigQuery буде корисною в таких ситуаціях:
- у вас є CRM, у якій зберігається велика кількість інформації про контакти;
- якщо створювати багато додаткових полів у системі eSputnik і підтримувати актуальну інформацію про контакти проблематично;
- ви бажаєте, щоб замість кількох баз дані зберігалися в одному місці і не було потреби постійно зберігати одну й ту саму інформацію в різних місцях;
- ви бажаєте будувати кастомні звіти у BQ з використанням даних із eSputnik.
eSputnik підтримує два варіанти інтеграції з Google BigQuery:
- Експорт даних із системи eSputnik до таблиці BigQuery;
- Підключення таблиць BigQuery як зовнішнього джерела даних для підстановки до повідомлень і сегментації.
Для налаштування інтеграції необхідно:
- зареєструвати акаунт у Google Cloud Platform;
- створити ключ проекту із правами адміністратора;
- створити таблиці з даними у Google BigQuery;
- налаштувати передачу даних до/із eSputnik із/до Google BigQuery.
Важливо
Зверніть увагу, що ця інтеграція платна. Зв’яжіться з нашим відділом продажів, щоб активувати функціональність.
Налаштування інтеграції eSputnik із BigQuery
Якщо ви вже маєте ключ проекту і налаштовані таблиці у BigQuery, ви можете взяти цей ключ і перейти одразу до пунктів:
- Експорт даних із системи eSputnik до таблиці BigQuery;
- Підключення таблиць BigQuery як зовнішнього джерела даних для підстановки до повідомлень і сегментації.
Створення ключа проекту
1. Авторизуйтеся в акаунті Google Cloud Platform.
2. Виберыть потрібний проект → перейдіть до розділу APIs & Services → Credentials.
3. Натисніть +Create credentials → Service account .
4. Введіть назву акаунта. Потім натисніть Create and continue.
5. Призначте роль BigQuery Admin, натисніть Continue і потім Done.
6. На головній сторінці розділу Credentials натисніть посилання Manage service accounts.
7. Навпроти щойно створеного акаунта натисніть три крапки і виберіть опцію Manage keys.
8. Ви потрапили до розділу Keys. Натисніть кнопку Add key і виберіть Create new key.
9. У діалоговому вікні, що відкриється, виберіть тип ключа JSON і натисніть CREATE.
10. Після цього браузер автоматично скачає ключ у папку для завантаження.
Потім у налаштуваннях eSputnik ви завантажите цей ключ.
Підключення BigQuery
Щоб підключити BigQuery до eSputnik, перейдіть до “Налаштувань” ① → “Конектори” ② і натисніть “Підключити BigQuery” ③.
Створіть конектор:
- Введіть назву.
- Завантажте файл ключа.
- Клікніть “Перевірити підключення”, щоб впевнитися у коректності даних авторизації. Якщо підключення не відбудеться, перевірте введені дані та за потреби зверніться до вашого системного адміністратора.
- Задайте відповідність полів, що містять ключ унікальності. Завдяки цьому ключу унікальності система eSputnik асоціюватиме поля з контактами у BigQuery. Без ключа унікальності не можна буде ані побудувати сегмент за параметрами з BigQuery, ані підставити дані до повідомлення.
- Натисніть “Зберегти”.
Після збереження налаштувань підключення відображатиметься у розділі “Налаштування” → “Конектори”. Клікнувши назву, ви зможете увійти до налаштувань і редагувати параметри. Наприклад, змінити правило співставлення унікальних полів, якщо ідентифікатор контактів у BQ змінився.
Експорт даних із системи eSputnik до таблиці BigQuery
Щоб регулярно актуалізувати у BigQuery інформацію щодо аудиторії, активності контактів у віджетах, замовлень і результатів розсилок, налаштуйте експорт даних до таблиць. Наприклад, це можуть бути відповіді на NPS-опитування, історія купівель, дата останнього переходу із розсилки та ін.
Доступні набори даних для експорту:
- broadcasts;
- contactActivities;
- contacts;
- devices;
- events;
- messages;
- orderItems;
- orders
- revenue.
Після налаштування один раз на добу ця інформація передаватиметься до BigQuery, також вона оновлюватиме дані в таблицях.
Важливий момент
Заздалегідь створювати таблиці у BigQuery не потрібно. Вони створюються автоматично під час першого експорту, і надалі інформація в них оновлюватиметься. Назви таблиць відповідатимуть наборам даних.
Список параметрів даних для експорту
Broadcasts
Параметр |
Тип даних | Опис |
---|---|---|
createdDate | timestamp |
Дата та час створення повідомлення (формат: '2021-10-08 11:11:02') |
groupId | int | ID груп, що брали участь у розсилці |
id | int | ID розсилки |
mediaType | string | Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget) |
messageId | int | ID повідомлення |
name |
string |
Назва розсилки |
startedDate |
timestamp | Дата та час відправки розсилки (формат: '2021-10-08 11:11:02') |
status | string |
Статуси розсилки:
|
updatedDate | timestamp | Дата та час оновлення розсилки (формат: '2021-10-08 11:11:02') |
ContactActivities
Параметр | Тип даних | Опис |
---|---|---|
activity (activityStatus)* | string | Статус активності:
|
workflowInstanceId | string | Ідентифікатор окремого запуску сценарію. Використовуйте його для угрупування розсилок у рамках запуску одного сценарію. |
broadcastId | int | ID розсилки |
campaignType | string |
Тип розсилки:
|
clickEventLink | string | Містить посилання, яке клікнув контакт (статус CLICKED) |
contactId | int | ID контакту в eSputnik (Внутрішній) |
errorCode (statusDescription)* | string | Помилка доставки SMTP та опис |
eventKey | string | Ключ події |
eventTypeKey | string | Ключ типу події |
eventId | string | Ідентифікатор події, яка запустила сценарій |
externalCustomerId | string | ID контакту у вашій системі (Зовнішній) |
mediaType | string | Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget, In-App, Telegram) |
messageInstanceId | int | Службове поле |
messageLanguageCode | string | Код мови повідомлення |
messageName | string | Назва повідомлення в обліковому записі eSputnik |
messageId | int | ID повідомлення |
messageTags | string | Мітки повідомлення |
messageURL | string | Містить посилання на веб-версію email |
senderName | string | Ім'я відправника у Viber |
started (activityDateTime)* | timestamp | Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02') |
utmCampaign | string | UTM-мітка розсилки |
workflowId | string | ID сценарію |
workflowBlockId | string | ID блока сценарію |
* Поле буде видалено як застаріле; використовуйте поле, вказане у дужках
Contacts
Параметр | Тип даних | Опис |
---|---|---|
contactId | int | ID контакту в eSputnik (Внутрішній) |
contactSource | string | Джерело контакту:
|
createdDate | timestamp | Дата та час створення контакту (формат: '2021-10-08 11:11:02') |
string | Email контакту | |
emailDomain | string | Домен email |
emailStatus | string | Статус email |
externalCustomerId | string | ID контакту у вашій системі (Зовнішній) |
firstName | string | Ім'я контакту |
languageCode | string | Код мови повідомлень |
lastClickedDate | timestamp | Дата та час останнього кліку (формат: '2021-10-08 11:11:02') |
lastName | string | Прізвище контакту |
lastReceivedDate | timestamp | Дата та час останньої доставки (формат: '2021-10-08 11:11:02') |
lastSentDate | timestamp | Дата та час останньої відправки (формат: '2021-10-08 11:11:02') |
lastViewedDate | timestamp | Дата та час останнього відкриття (формат: '2021-10-08 11:11:02') |
sms | string | Номер телефону |
totalClicked | int | Загальна кількість кліків |
totalReceived | int | Загальна кількість отриманих повідомлень |
totalSent | int | Загальна кількість надісланих повідомлень |
totalViewed | int | Загальна кількість переглянутих повідомлень |
Devices
Параметр | Тип даних |
Опис |
---|---|---|
appVersion | string | Версія додатку |
applicationId | int | ID додатку |
category | string | Категорія |
contactId | int | ID контакту |
deviceId | string | ID пристрою |
deviceModel | string | Модель пристрою |
externalCustomerId | string | Зовнішній ID контакту |
languageCode | string | Код мови |
osType | string | Тип ОС |
osVersion | string | Версія ОС |
pushToken | string | Пуш-токен |
timeZone | string | Часовий пояс |
Events
Параметр |
Тип даних | Опис |
---|---|---|
contactId | int |
ID контакту |
eventId | int |
ID події |
eventTypeKey | string |
Тип події |
keyValue | string |
Ключ події |
occured | timestamp |
Дата і час виникнення (формат: '2021-10-08 11:11:02') |
paramsJson |
json | 50 перших параметрів та значень події (name/value); передається до 300 символів значень. |
Messages
Параметр | Тип даних |
Опис |
---|---|---|
annoyanceLevel | int | Рівень занепокоєння повідомлення |
language | string | Мова основної версії повідомлення |
mediaType | string | Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget, In-App) |
messageId |
int | ID повідомлення |
name | string | Назва повідомлення |
replyTo | string | Адреса для відповідей |
sender | string | Відправник |
subject | string | Тема |
tags | string | Мітки |
translations | string | Мовні версії повідомлення |
updateDate | timestamp | Дата та час оновлення повідомлення (формат: '2021-10-08 11:11:02') |
OrderItems
Параметр | Тип даних | Опис |
---|---|---|
cost | float | Вартість продукту |
description | string | Опис продукту |
externalProductId | string | Зовнішній ID продукту |
imageUrl | string | Посилання на зображення продукту |
name | string | Назва продукту |
orderDate | timestamp | Дата створення замовлення (формат: '2021-10-08 11:11:02') |
orderId | int | ID замовлення в eSputnik (Внутрішній) |
quantity | int | Кількість продукту |
url | string | URL-адреса продуктуа |
Orders
Параметр | Тип даних | Опис |
---|---|---|
contactId | int | ID контакту в eSputnik (Внутрішній) |
deliveryAddress | string | Адреса доставки |
deliveryMethod | string | Спосіб доставки |
discount | float | Знижка |
string | ||
externalOrderId | string | Зовнішній ID замовлення |
firstName | string | Ім'я контакту |
lastName | string | Прізвище контакту |
orderCreatedDate | timestamp | Дата створення замовлення на eSputnik (формат: '2021-10-08 11:11:02') |
orderDate | timestamp | Дата створення замовлення (формат: '2021-10-08 11:11:02') |
orderId | int | ID замовлення в eSputnik (Внутрішній) |
paymentMethod | string | Спосіб оплати |
phone | string | Номер телефону |
status | string | Статус замовлення:
|
totalCost | float | Загальна вартість замовлення |
Revenue
Параметр | Тип даних | Опис |
---|---|---|
activity (activityStatus)* | string | Статус активності:
|
campaignType | string | Тип розсилки:
|
clickEventLink | string | Містить посилання, яке клікнув контакт (статус CLICKED) |
contactId | int | ID контакту в eSputnik (Внутрішній) |
currency | string | Валюта |
externalCustomerId | string | ID контакту у вашій системі (Зовнішній) |
externalOrderId | string | ID замовлення зовнішній |
mediaType | string | Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget) |
messageInstanceId | int | Службове поле |
messageName | string | Назва повідомлення в обліковому записі eSputnik |
messageTags | string | Мітки повідомлення |
messageUrl | string | Містить посилання на веб-версію email |
orderDate | timestamp | Дата створення замовлення (формат: '2021-10-08 11:11:02') |
senderName | string | Ім'я відправника у Viber |
started (activityDateTime)* | timestamp | Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02') |
totalCost | float | Загальна вартість замовлення |
utmCampaign | string | UTM-мітка розсилки |
eventKey | string | Ключ події |
eventTypeKey | string | Ключ типу події |
messageLanguageCode | string | Код мови повідомлення |
orderId | int | ID замовлення в eSputnik (Внутрішній) |
workflowId | int | ID сценарію |
broadcastId | int | ID розсилки |
* Поле буде видалено як застаріле; використовуйте поле, вказане у дужках
Примітка
Існуючі записи в таблиці Revenue (для замовлень, зроблених після 08.03.2024) можна оновлювати разом з вивантаженням нових замовлень. Оновлення може знадобитися, наприклад, якщо змінилася загальна вартість замовлення.
Налаштування джерела даних для експорту
1. Перейдіть у “Налаштування” ① → “Конектори” ② і натисніть “Нове джерело” ③.
2. Завантажте файл ключа і позначте галочками ті набори даних, які бажаєте вивантажувати. Потім натисніть "Зберегти".
Підключення відобразиться в розділі “Коннектори” → “Експорт до BigQuery”; увійшовши до нього, ви зможете редагувати налаштування.
Підключення таблиць BigQuery як джерела даних для розсилки
Цей варіант є придатним, коли треба виділити сегмент користувачів і здійснити за ним розсилку — як одноразово, так і на регулярній основі. Працює таким чином:
-
у BigQuery є таблиця, де зберігаються дані про контакти, які ви передаєте туди, наприклад із CRM;
-
ви бажаєте виділити певний сегмент клієнтів і відправити їм розсилку з персоналізованим контентом;
-
у системі eSputnik ви вибираєте, за якими полями ви хочете зробити сегментацію. Наприклад, треба налаштувати регулярну розсилку для контактів, у яких сьогодні день народження. У такому випадку під час налаштування ви вибираєте з таблиці поле "День народження";
-
ви підключаєте таблицю з потрібним контентом до eSputnik у розділу Налаштування — Джерела даних і створюєте умовну групу;
-
під час редагування ви задаєте умови відбору, так само як у звичайній умовній групі (День народження → сьогодні), тільки при цьому використовуєте набори даних із таблиць BigQuery. Вони будуть знаходитись у списку умов дещо нижче стандартних полів у такому вигляді, в якому вони названі в джерелі даних;
-
тепер ви можете підключити отриману групу до регулярного сценарію, щоб автоматизувати відправлення листа до дня народження.
Пройдемося по порядку пунктами налаштування.
Налаштування джерела зовнішніх даних
Щоб сформувати групу за даними з BigQuery, треба спочатку налаштувати джерело.
Для цього перейдіть до розділу “Налаштування” → “Джерела даних”. Потім натисніть кнопку “Нове джерело” → “Зовнішні джерела даних”.
У діалоговому вікні, що відкриється, виберіть джерело даних BigQuery, яке ви налаштовували в розділі “Конектори”. У нашому прикладі це esputnik.
Налаштування даних:
- Виберіть зі списку dataset, який містить потрібну таблицю.
- Визначте таблицю з потрібним набором даних.
- Назвіть джерело будь-якою зрозумілою назвою.
- Натисніть “Зберегти”.
Після збереження вас перекине на сторінку зі списком підключених джерел. Ви можете перейти до редагування налаштувань, натиснувши назву джерела.
Створення умовної групи за параметрами BigQuery
Для створення такої групи необхідно мати принаймні одне зовнішнє джерело даних.
1. Перейдіть до розділу “Контакти” → “Групи”. На сторінці списку груп виберіть “Нова група” → “Умовна”.
2. Додайте для групи назву (обов'язково), опис і мітку (за бажання).
3. Виберіть умови для включення до групи. У параметрах умов натисніть назву джерела, потім назву таблиці та задайте умову. Наприклад, DR → date → сьогодні.
DR – це назва джерела, date – стовбчик з таблиці з датами народження клієнтів, сьогодні – умова входження контакту до групи за цим параметром.
Наразі до групи входитимуть лише ті контакти, які вже наявні в базі eSputnik.
Наприклад, якщо у зовнішньому джерелі знаходяться 10 000 контактів, а до бази eSputnik із цих контактів додано тільки 1 000, то система задіює лише цю тисячу контактів. Щоб оперувати всіма 10 000 контактів, їх необхідно спочатку додати до бази eSputnik шляхом ручного імпорту або методом API Add/update contacts. Пізніше ми додамо можливість використовувати всі контакти із зовнішнього джерела, а також автоматично зберігати їх до бази eSputnik і оновлювати дані вже наявних контактів.