Перші кроки
Відстеження подій та поведінки
- Отримання та встановлення скрипта веб-трекінгу
- Налаштування трекінгу прив'язкою до селекторів сайту
- Налаштування та використання вебтрекінгу для персоналізації контенту на сайті та в розсилках
- Налаштування Web Tracking методом відправлення подій через JavaScript
- Передавання даних про поведінку відвідувачів сайту через REST API
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування Smart-елементів
- Оформлення промовкладки для Gmail
- Додавання Rolloverʼа
- Додавання фону до листа
- Додавання анкорних посилань
- Бібліотека блоків (Модулі)
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Робота з блоком "Зображення"
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного додатка
- Створення Google проекту для Mob Push
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Налаштування універсальних посилань (deeplinks & Universal links)
- Звіти за мобільними push-розсилками
Автоматизація
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням API
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду за допомогою персоналізації
- Завантаження промокодів для використання в сценарії
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
Аналітика
Товарні рекомендації
API
- Інтеграція з API — найчастіші питання
- API-ключі
- Ресурси API для додавання контактів
- Використання API-ресурсу Generate event
- Передача замовлень API-ресурсом Generate event
- Отримання рекомендацій щодо API ресурсом Contact recommendations based on web tracking
- Використання API-ресурсу Send prepared message
Зміна системи
Документи
Інтеграція
Налаштування App Inbox для мобільних застосунків
App Inbox – альтернативний канал комунікації: повідомлення автоматично або вручну відправляються до особистого кабінету користувачів мобільного застосунку.
Загальний опис App Inbox та його переваги в порівнянні з іншими каналами ви знайдете у статті “App Inbox: чому ви оціните цей канал і як його ефективно використовувати”.
Налаштування App Inbox для мобільних додатків
Налаштування App Inbox включає відправлення запитів:
-
Одержання токена аутентифікації.
-
Отримання кількості непрочитаних повідомлень App Inbox.
-
Отримання кількості сторінок із повідомленнями.
-
Отримання списку всіх повідомлень App Inbox в мобільному додатку.
-
Зміна статусу App Inbox повідомлень.
Запит токена автентифікації
Для отримання токена автентифікації користувача (authToken) надсилається запит із сервера до API eSputnik. Запит повинен бути автентифікований одним із способів, описаних в інструкції до API. Наприклад, API-ключем.
У запиті необхідно передати відомі поля користувача: email, phone, externalCustomerId (мінімум одне з наведених). Ці поля потрібні для пошуку контакту в eSputnik.
Метод запиту | POST |
---|---|
URL запиту | https://esputnik.com/api/v1/auth/contact/token |
Заголовок запиту | Content-Type: application/json |
Тіло запиту |
|
Відповідь |
|
Надалі authToken використовується для автентифікації всіх запитів App Inbox. Його потрібно передавати у заголовку запиту ES-TOKEN. Після кожного запиту поточний токен інвалідується, а в заголовку відповіді ES-TOKEN надходить новий, який використовується для наступного запиту.
Якщо у відповідь на будь-який запит App Inbox надходить статус 401, запит на отримання токена необхідно повторити.
Запит кількості непрочитаних повідомлень
Запит дає можливість отримувати інформацію щодо кількості непрочитаних повідомлень у мобільному застосунку користувача. Запит може виконуватися регулярно.
Метод запиту | GET |
---|---|
URL запиту | https://esputnik.com/appinbox/v1/messages/count |
Заголовок запиту | ES-TOKEN: authToken |
Заголовок відповіді | ES-TOKEN: newAuthToken |
Відповідь |
|
Якщо значення count > 0, користувач має побачити індикатор непрочитаних повідомлень.
Запит списку повідомлень
Запит дозволяє отримати у відповіді список повідомлень у мобільному застосунку з такими даними:
-
ID повідомлення;
-
дата створення;
-
заголовок;
-
текст повідомлення;
-
URL зображення;
-
URL посилання;
-
статус повідомлення (прочитане або непрочитане).
Метод запиту | GET |
---|---|
URL запиту | https://esputnik.com/appinbox/v1/messages?page={pageNumber}&pageSize={pageSize}s |
Заголовок запиту | ES-TOKEN: authToken |
Заголовок відповіді | ES-TOKEN: newAuthToken |
pageNumber | minimum value 0 |
pageSize | minimum value 1 |
Відповідь |
|
Якщо pageNumber або pageSize не встановлені, у відповідь на запит повернуться всі актуальні повідомлення.
Зміна статусу повідомлень
Запит використовується для надсилання події прочитання повідомлення. Необхідно надсилати лише ідентифікатори повідомлень, у яких newMessage=true.
За допомогою запиту також можна змінити статус усіх повідомлень з "непрочитане" на "прочитане".
Метод запиту | POST |
---|---|
URL запиту | https://esputnik.com/appinbox/v1/messages/status |
Заголовок запиту | ES-TOKEN: authToken |
Заголовок відповіді | ES-TOKEN: newAuthToken |
Тіло запиту |
Для передачі події про прочитання повідомлення:
Для зміни статусу всіх повідомлень на "прочитане":
|
Відповідь | ні |
Створення повідомлень
Інструкція по створенню App Inbox повідомлень та їх розсилання представлена на сторінці “Створення App Inbox повідомлень”.