Первые шаги
Отслеживание событий и поведения
Пользовательские данные
- Как добавить анкорные ссылки в емейл
- Настройка Smart-элементов
- Сквозные модули для одновременного обновления всех писем
- Оформление промовкладки для Gmail в письме
- Создание футера в адаптивном редакторе
- Всё для адаптивности в редакторе
- Редактирование HTML и CSS
- Работа с блоком "Баннер"
- Обзор адаптивного email-редактора eSputnik
- Как добавить Rollover в письмо
- Добавление блока "Видео"
- Работа с блоком "Меню"
- Работа с блоком "Картинки"
- Работа с блоком "Соц.сети"
- Как добавить таблицу в письмо?
- Библиотека блоков (Модули)
- Как добавить фон в редакторе
- Добавление пользовательских шрифтов в email-редакторе
- Как вставить кастомные социальные иконки в письмо
- Как создать кнопку CTA
- Создание оформления для письма
- Работа с блоком “Таймер"
Омниканальность
- Настройка универсальных ссылок (deeplinks & Universal links)
- Планирование мобильных push-уведомлений
- Настройка аналитики доставляемости и кликов
- Отчет по Mobile push-рассылке
- Управление ключами доступа к мобильному SDK
- Создание мобильных push-сообщений
- Создание и интеграция Google проекта для Mob Push
- SDK для мобильных приложений
- Подключение мобильных приложений к eSputnik
- Service Worker. Устранение неполадок
- Создание welcome цепочки для web-push уведомлений
- Как настроить подписку на Web Push
- Создание web-push-уведомлений
- Инструкция по подключению Safari web push
- Создание Google проекта для сбора web-push токенов
- Персонализация веб-пушей данными из веб-активности пользователя
- Создание веб-формы для сайтов
- Отправка событий из форм подписки в Google Analytics
- Как настроить информер для вашего сайта
- Создание pop-up-форм с помощью Google Tag Manager или WordPress
- Настройка pop-up виджета для сайта
- Настройка плавающего окна для сайта
- Создание кнопки вызова виджета
- Настройка виджета возрастного ограничения
Автоматизация
- Настройка формы подписки и двойного подтверждения
- Как настроить автоматическое поздравление с Днем рождения
- Согласование переменных события со сценарием на примере сценария "Заказ доставлен"
- Сегментация триггерных писем по дополнительным полям
- Запуск сценария после импорта контактов
- Контроль триггеров
- Как привязать сценарий к кнопке
- Устранение неполадок в работе сценариев
- Как настроить автоматическую реактивацию подписчиков и клиентов
- Настройка сценария для опросов и сбора отзывов
- Как отправить рассылку непрочитавшим
- Создание регулярного сценария для группы (видео)
- Создание welcome-цепочки для email-сообщений
Персонализация
- HTTP-запрос для передачи промокода из сообщения в карточку контакта
- Принципы генерации промокодов с помощью PHP/JAVA
- Подстановка промокода с использованием API
- Загрузка промокодов для использования в сценарии
- Подстановка промокода с помощью персонализации
- Подстановка промокода из файла
- Генерация промокодов в сценарии
- Отправка промокода с помощью препроцессора
Аналитика
- Настройка визуализации дохода от рассылок
- Отслеживание эффективности рассылок в Google Analytics
- Отчет по AMP-рассылке
- Отчет по Viber-рассылке
- Отчёт по email-рассылке
- Как корректно открыть CSV-файл после экспорта
- Отчет по Mobile push-рассылке
- Настройка передачи UTM-меток
- Отчет по Web-push рассылке
- Отчет по SMS-рассылке
Мультиязычность
API
- API-ключи
- Ресурсы API для добавления контактов
- Использование API-ресурса Send prepared message
- Получение рекомендаций по API ресурсом Contact recommendations based on web tracking
- Использование API-ресурса Generate event
- Интеграция с API – частые вопросы
- Передача заказов с помощью ресурса Generate event
Смена системы
Документы
Интеграция
API-ключи
Что такое API?
API — универсальный способ связи разных приложений.
API-ключи позволят другим приложениям получить доступ к вашей учетной записи в eSputnik без необходимости передачи им вашего пароля.
Использование API-ключа
Чтобы настроить интеграцию с вашей организацией в eSputnik, используйте API-ключ.
Ключ дает доступ к данным из вашей учетной записи eSputnik, поэтому он должен быть защищен от несанкционированного доступа.
eSputnik API поддерживает Basic HTTP Access Authentication с использованием API-ключа.
Чтобы авторизоваться и обратиться к ресурсам вашего аккаунта в eSputnik:
- введите любое значение для username;
- введите значение вашего API-ключа в поле password.
Пример авторизации с помощью API ключа для приложения Postman:
Создание и редактирование API-ключа
Чтобы настроить интеграцию со своей учетной записью eSputnik, вам нужно сгенерировать API-ключ.
1. Перейдите в раздел “Настройки”, затем выберите вкладку API и нажмите кнопку “Добавить ключ”. Откроется страница добавления (редактирования) API-ключа.
2. В поле "Описание" можно добавить информацию о том, какое именно приложение/сайт будет использовать этот ключ для доступа к вашему аккаунту в eSputnik. Это поможет в будущем легко идентифицировать данный API-ключ.
3. Вы можете ограничить доступ по API-ключу к рисковым частям вашего аккаунта в eSputnik.
4. Если вам нужно настроить несколько интеграций, вы можете создать ключ для каждой из них. Также для одной организации можно создать несколько ключей с разными правами доступа.
После добавления нового API-ключа в таблице появится строка с соответствующими данными:
- собственно ключ (в скрытом виде), его можно скопировать, просто кликнув по нему;
- информация о том, кем создан ключ;
- дата его создания;
- доступ;
- описание;
- статус (доступен/недоступен).
Права доступа
Доступ с API-ключом к ресурсам eSputnik устанавливается на этапе создания ключа. Вы можете дать полный доступ ко всем ресурсам и методам eSputnik API, выбрав опцию “Full access to API”, или ограничить его, выбрав:
- “Access to events”
- “Access to events and contacts”
- “Access to events and contacts” (adding/updating)
- "Access to messages"
Следующие правила применимы ко всем версиям методов (/v1, /v2 и т.д.), если иное не уточнено отдельно.
1. Методы API, доступ на которые выдается по умолчанию
Следующие методы не требуют никаких специальных разрешений и доступны в любой из опций.
Общие методы:
GET version
Информация об аккаунте:
GET account/info
GET balance
GET subscriptions
GET addressbooks
Управление сообщениями:
POST messages/email
GET messages/email
GET messages/email/{id}
DELETE messages/email/{id}
PUT messages/email/{id}
DELETE messages/email/{id}/{language}
PUT messages/email/{id}/{language}
GET messages/email/{id}/viewLink
GET messages/sms
GET messages/sms/{id}
Управление интерфейсами:
GET interfaces/email
GET interfaces/sms
Статистика:
GET contact/token/activated/{app_uuid}/{token_id}
PUT contact/token/activated/{app_uuid}/{token_id}
PUT interactions/{interaction_id}/status
2. Чтение контактов и групп (Read contacts and segments)
Доступные методы API:
GET contacts
GET contact/{id}
GET contacts/email
GET contact/{id}/subscriptions
GET groups
GET group/{id}/contacts
3. Обновление контактов и групп (Write contacts and segments)
Доступные методы API:
POST contacts
POST contacts/upload
GET importstatus/{sessionId}
POST contact
PUT contact/{id}
DELETE contact/{id}
PUT contact/{id}/subscriptions
POST contact/subscribe
POST emails/unsubscribed/add
POST emails/unsubscribed/delete
POST group/{id}/contacts/detach
4. Управление активностью контактов (Manage contact activity in campaign)
Доступные методы API:
GET contacts/activity
5. Управление ивентами (Manage events)
Доступные методы API:
POST event
POST past_events
DELETE past_events
6. Отправка сообщений (Send messages)
Доступные методы API:
POST message/{id}/smartsend
GET message/status
POST message/email
POST message/sms
POST message/viber
POST broadcast
GET broadcast/{broadcast_id}
DELETE broadcast/{broadcast_id}
GET broadcasts
Блокировка ключа
Если ключ скомпрометирован, вы можете отключить его.
Для этого вам необходимо переместить ползунок напротив ключа в положение “Отключить ключ”. После того, как вы подтвердите свое действие во всплывающем окне, система заблокирует доступ с этим ключом к API.
Порядок действий для разблокировки ключа такой же.
Если ключ не используется в течение 90 дней, он отключается автоматически.
Удаление ключа
Вы можете навсегда удалить ключ, так что его восстановление будет невозможно.
Для этого нажмите на троеточие напротив ключа и в выпадающем списке выберите “Удалить”.
Безопасность API-ключа
API-ключи предоставляют доступ к данным вашей учетной записи eSputnik и должны быть защищены так же, как и ваш пароль. В частности, существует несколько распространенных сценариев, которые следует учитывать при работе с API-ключами.
- Не допускайте, чтоб ключ был виден на скриншотах или демо-видео. Затирания ключа может быть недостаточно — лучше “вырезать” его в графическом редакторе.
- Не отправляйте API-ключ по почте, так как если ваш почтовый аккаунт взломают, данные в eSputnik окажутся под угрозой.