Перші кроки
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування Smart-елементів
- Оформлення промовкладки для Gmail
- Додавання Rolloverʼа
- Додавання фону до листа
- Додавання анкорних посилань
- Бібліотека блоків (Модулі)
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Робота з блоком "Зображення"
- Використання ШІ в email-редакторі
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного застосунку
- Створення Google проекту для Mob Push
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Налаштування універсальних посилань (deeplinks & Universal links)
- Надсилання тестових повідомлень із налагодження запитів
- Налаштування віджетів для сайту
- Виклик віджета
- Налаштування геоданих для правил виклику віджетів
- Збереження даних із віджетів у поля контактів
- Захист від роздратування
- Дії після заповнення форми
- Заміна системного сценарію Double Opt-In
- Розширення для тестування форм в Google Chrome
- Створення pop-up-форм за допомогою Google Tag Manager або WordPress
- Надсилання подій з віджетів eSputnik до Google Analytics
Автоматизація
- Подвійне підтвердження підписки
- Вітальна серія
- Вітальна серія із сегментацією за категоріями
- Запуск сценарію після імпорту контактів
- Регулярний сценарій для групи
- Вітання з днем народження
- Привʼязка сценарію до кнопки
- Реактивація клієнтів та підписників
- Відправка розсилки непрочитавшим
- Налаштування додаткових розсилок
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням API
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду за допомогою персоналізації
- Завантаження промокодів для використання в сценарії
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
Аналітика
- Звіт щодо email-розсилки
- Звіт щодо SMS-розсилки
- Звіт щодо розсилки Web Push
- Звіт щодо Viber-розсилки
- Звіт щодо розсилки Mob Push
- Звіт щодо розсилки App Inbox
- Звіт зі взаємодії з віджетами
- Звіт щодо тригерної розсилки
- Звіт щодо AMP-розсилки
- Звіт щодо мультимовної розсилки
- Налаштування передачі UTM-міток
- Візуалізація доходу
- Відстеження ефективності розсилок у Google Analytics
Мультимовність
Відстеження подій та поведінки
- Відстеження активності на сайті за допомогою 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-опитування, історія купівель, дата останнього переходу із розсилки та ін.
Доступні набори даних для експорту:
- contactActivities;
- contacts;
- orderItems;
- orders
- revenue.
Після налаштування один раз на добу ця інформація передаватиметься до BigQuery, також вона оновлюватиме дані в таблицях.
Важливий момент!
Заздалегідь створювати таблиці у BigQuery не потрібно. Вони створюються автоматично під час першого експорту, і надалі інформація в них оновлюватиметься. Назви таблиць відповідатимуть наборам даних (contactActivities, contacts, orderItems, orders).
Список параметрів даних для експорту
ContactActivities
Параметр | Тип даних | Опис |
---|---|---|
activity | string | Статус активності:
|
workflowInstanceId | int | Ідентифікатор окремого запуску сценарію. Використовуйте його для угрупування розсилок у рамках запуску одного сценарію. |
broadcastId | int | ID розсилки |
campaignType | string |
Тип розсилки:
|
clickEventLink | string | Містить посилання, яке клікнув контакт (статус CLICKED) |
contactId | int | ID контакту в eSputnik (Внутрішній) |
errorCode | string | Помилка доставки SMTP та опис |
eventKey | string | Ключ події |
eventTypeKey | string | Ключ типу події |
externalCustomerId | string | ID контакту у вашій системі (Зовнішній) |
mediaType | string | Медіатип (SMS, Email, Web Push, Viber, Mobile Push, AppInbox, Widget) |
messageInstanceId | int | Службове поле |
messageLanguageCode | string | Код мови повідомлення |
messageName | string | Назва повідомлення в обліковому записі eSputnik |
messageTags | string | Мітки повідомлення |
messageURL | string | Містить посилання на веб-версію email |
senderName | string | Ім'я відправника у Viber |
started | timestamp | Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02') |
utmCampaign | string | UTM-мітка розсилки |
workflowId | int | 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 | Загальна кількість переглянутих повідомлень |
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 | 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 | timestamp | Дата та час відправки повідомлення (формат: '2021-10-08 11:11:02') |
totalCost | float | Загальна вартість замовлення |
utmCampaign | string | UTM-мітка розсилки |
Налаштування джерела даних для експорту
1. Перейдіть у “Налаштування” ① → “Конектори” ② і натисніть “Нове джерело” ③.
2. Завантажте файл ключа і позначте галочками ті набори даних, які бажаєте вивантажувати. Потім натисніть "Зберегти".
Підключення відобразиться в розділі “Коннектори” → “Експорт до BigQuery”; увійшовши до нього, ви зможете редагувати налаштування.
Підключення таблиць BigQuery як джерела даних для розсилки
Цей варіант є придатним, коли треба виділити сегмент користувачів і здійснити за ним розсилку — як одноразово, так і на регулярній основі. Працює таким чином:
-
у BigQuery є таблиця, де зберігаються дані про контакти, які ви передаєте туди, наприклад із CRM;
-
ви бажаєте виділити певний сегмент клієнтів і відправити їм розсилку з персоналізованим контентом;
-
у системі eSputnik ви вибираєте, за якими полями ви хочете зробити сегментацію. Наприклад, треба налаштувати регулярну розсилку для контактів, у яких сьогодні день народження. У такому випадку під час налаштування ви вибираєте з таблиці поле "День народження";
-
ви підключаєте таблицю з потрібним контентом до eSputnik у розділу Налаштування — Джерела даних і створюєте умовну групу;
-
під час редагування ви задаєте умови відбору, так само як у звичайній умовній групі (День народження → сьогодні), тільки при цьому використовуєте набори даних із таблиць BigQuery. Вони будуть знаходитись у списку умов дещо нижче стандартних полів у такому вигляді, в якому вони названі в джерелі даних;
-
тепер ви можете підключити отриману групу до регулярного сценарію, щоб автоматизувати відправлення листа до дня народження.
Пройдемося по порядку пунктами налаштування.
Налаштування джерела зовнішніх даних
Щоб сформувати групу за даними з BigQuery, треба спочатку налаштувати джерело.
Для цього перейдіть до розділу “Налаштування” → “Джерела даних”. Потім натисніть кнопку “Нове джерело” → “Зовнішні джерела даних”.
У діалоговому вікні, що відкриється, виберіть джерело даних BigQuery, яке ви налаштовували в розділі “Конектори”. У нашому прикладі це esputnik.
Налаштування даних:
- Виберіть зі списку dataset, який містить потрібну таблицю.
- Визначте таблицю з потрібним набором даних.
- Назвіть джерело будь-якою зрозумілою назвою і натисніть “Зберегти”.
Після збереження вас перекине на сторінку зі списком підключених джерел. Ви можете перейти до редагування налаштувань, натиснувши назву джерела.
Створення умовної групи за параметрами BigQuery
Для створення такої групи необхідно мати принаймні одне зовнішнє джерело даних.
1. Перейдіть до розділу “Контакти” → “Групи”. На сторінці списку груп виберіть “Нова група” → “Умовна”.
2. Додайте для групи назву (обов'язково), опис і мітку (за бажання).
3. Виберіть умови для включення до групи. У параметрах умов натисніть назву джерела, потім назву таблиці та задайте умову. Наприклад, DR → date → сьогодні.
DR – це dataset, date – таблиця з датами народження клієнтів, сьогодні – умова входження контакту до групи за цим параметром.
Наразі до групи входитимуть лише ті контакти, які вже наявні в базі eSputnik.
Наприклад, якщо у зовнішньому джерелі знаходяться 10 000 контактів, а до бази eSputnik із цих контактів додано тільки 1 000, то система задіює лише цю тисячу контактів. Щоб оперувати всіма 10 000 контактів, їх необхідно спочатку додати до бази eSputnik шляхом ручного імпорту або методом API Add/update contacts. Пізніше ми додамо можливість використовувати всі контакти із зовнішнього джерела, а також автоматично зберігати їх до бази eSputnik і оновлювати дані вже наявних контактів.