Перші кроки
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування Smart-елементів
- Оформлення промовкладки для Gmail
- Додавання Rolloverʼа
- Додавання фону до листа
- Додавання анкорних посилань
- Бібліотека блоків (Модулі)
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Робота з блоком "Зображення"
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного застосунку
- Створення Google проекту для Mob Push
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Налаштування універсальних посилань (deeplinks & Universal links)
- Надсилання тестових повідомлень із налагодження запитів
- Налаштування віджетів для сайту
- Виклик віджета
- Збереження даних із віджетів у поля контактів
- Захист від роздратування
- Дії після заповнення форми
- Розширення для тестування форм в Google Chrome
- Створення pop-up-форм за допомогою Google Tag Manager або WordPress
- Надсилання подій з віджетів eSputnik до Google Analytics
- Заміна системного сценарію Double Opt-In
- Налаштування геоданих для правил виклику віджетів
Автоматизація
- Подвійне підтвердження підписки
- Вітальна серія
- Вітальна серія із сегментацією за категоріями
- Запуск сценарію після імпорту контактів
- Регулярний сценарій для групи
- Вітання з днем народження
- Привʼязка сценарію до кнопки
- Реактивація клієнтів та підписників
- Відправка розсилки непрочитавшим
- Налаштування додаткових розсилок
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням 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 проекту для Mob Push
Для роботи з мобільними пушами треба створити акаунт у Google Firebase, де збиратимуться і зберігатимуться дані про підписників. Налаштування потребуватиме не більше 10 хвилин, оскільки механіка підключення є доволі простою. Якщо акаунт уже існує — завантажте його ключ до системи eSputnik.
Крок 1: Зареєструйте проект на FireBase і додайте ключ проекту до eSputnik
Якщо у вас уже є проект, переходьте одразу до пункту 4
1. Увійдіть на сторінку сервісу Google Firebase і натисніть кнопку Get started.
2. Потім натисніть кнопку «Додати проект».
3. Заповніть форму створення нового проекту. У діалозі, що з'явиться, надайте проекту назву, вкажіть регіон.
Після цього прийміть угоду про безпеку.
4. На екрані з'явиться сповіщення, що новий проект готовий.
5. Натисніть “Продовжити”, щоб потрапити до створеного акаунта Firebase.
6. Увійдіть до налаштувань проекту.
Після того, як проект буде створено, на панелі ліворуч натисніть коліщатко поруч із пунктом «Project Overview» і перейдіть до пункту меню «Налаштування проекту».
7. Виберіть вкладку “Сервісні акаунти”.
У вікні, що відкриється, натисніть кнопку «Створення закритого ключа».
8. Після цього в діалозі натисніть "Створити ключ".
9. Після того, як ключ буде скачаний, завантажте його до eSputnik у "Налаштуваннях" нового проекту для Mob Push.
Готово! Не забудьте надати назву вашому проекту. Пізніше назву буде видно у контактів та у групах. Наприклад, на списку груп кількість контактів із токенами цієї програми буде показано окремою цифрою:
Крок 2: Інтегруйте Firebase із вашим мобільним додатком
Цей пункт призначений для розробників вашого додатка, яким необхідно зробити додаткові налаштування для запуску мобільних пуш-сповіщень:
Крок 3: Завантажте базу контактів із мобільними токенами за допомогою доступних методів Public API
-
Add/update contacts — Одиночне/масове додавання/оновлення контактів
-
Update contact — Оновлення контакту (одиночно по id)
У структурі channel для вищезазначених методів, підтримується параметр device, для якого доступні такі вкладені поля:
-
appId — ідентифікатор додатка (UUID), який видається під час реєстрації програми в eSputnik. Виводиться користувачеві в налаштуваннях. У тому разі, якщо в акаунті зареєстрований лише один додаток, передавати це поле в запиті не обов'язково.
-
deviceModel — модель пристрою (довільне значення — до 50 символів).
-
os — операційна система девайсу (до 15 символів, наприклад: ios або android).
-
locale — локаль (наприклад en_UK, ru_UA, uk_UA).
-
clientVersion — версія SDK, що використовується в додатку (native or esputnik-1). native — для використання пуш-сповіщень типу Notification, esputnik-1 — для використання пуш-сповіщень типу Data (за замовчуванням).
-
appVersion — версія мобільного додатка.
-
active — прапорець активності токена.
Приклад POST запиту до ресурсу v1/contacts для імпорту контакту з номером телефону і токеном:
{
"contacts": [
{
"channels": [
{
"type": "mobilepush",
"value": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
"device": {
"appId": "123e4567-e89b-12d3-a456-426655440000",
"deviceModel": "iPhone SE 2nd Gen",
"os": "iOs",
"locale": "ru_UA",
"clientVersion": "native",
"appVersion": "3.14",
"active": true
}
},
{
"type": "sms",
"value": "380501234567"
}
]
}
],
"dedupeOn": "sms",
"contactFields": ["mobilepush", "sms"],
"groupNames": ["mobile push contacts"],
"restoreDeleted": true
}
Важливо!
Для сповіщень типу Notification доступна можливість передавання зображення, для цього у редакторі повідомлення треба задати посилання в Custom data у форматі JSON: {"es_notification_image":"https://example.com/img.png"}
Важливо!
Для збирання та обліку активності за кожним повідомленням на боці вашого мобільного додатка треба реалізувати повернення статусу, при доставленні потрібно повернути DELIVERED або OPENED у випадку відкривання. Для цього доступний метод зміни статусу Push-повідомлення: PUT Update interaction status
У тілі запиту, окрім interactionId, передаються також токен FCM і час зміни статусу на девайсі.
Приклад PUT запиту для оновлення статусу сповіщення:
{
"token": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
"status": "OPENED",
"time": "2020-07-09T15:11:17"
}
Коли у сповіщенні є посилання, щоб переходи за ним фіксувалися і були доступні в статистиці персонального кабінету, у вашому додатку розробникам треба підтримати таку можливість. У редакторі повідомлень доступна підстановка посилання до тіла повідомлення, але без відстеження переходів за ним.
При додаванні до редактора посилання в тілі пуш-сповіщення буде додатково передано два поля: es_link_raw та es_link:
-
поле es_link_raw — http://example.com/somelink.html — містить початкове посилання, яке можна відкрите браузером пристрою або воно може бути внутрішнім посиланням вашого додатка, яке відкриває його конкретний розділ;
-
поле es_link — https://ххх.esclick.me/37NdHw3pf3DjRcukc0l — створюється на базі вказаного посилання і містить загорнуте посилання, призначене для відстеження та обліку переходів.
Важливо!
На боці вашого мобільного додатка треба реалізувати роботу з полями es_link_raw та es_link. Посилання з es_link_raw може бути використане для перенаправлення користувача до розділу програми або на web ресурс, для обліку кліків достатньо GET запиту за посиланням з es_link.
Також у редакторі підтримується можливість кастомного формату посилань; це може бути посилання на web ресурс, deeplink та velocity вираз, коли дані підставляються з події, що є актуальним для тригерних повідомлень.