Первые шаги
Пользовательские данные
- Обзор адаптивного email-редактора
- Создание оформления для письма
- Создание сквозных модулей
- Настройка адаптивности
- Настройка smart-контейнеров
- Оформление промовкладки для Gmail
- Добавление Ролловера
- Добавление анкорных ссылок
- Библиотека модулей
- Добавление таблицы в письмо
- Работа с блоком "Баннер"
- Добавление пользовательских шрифтов
- Создание кнопки CTA
- Работа с блоком "Картинка"
- Работа с блоком “Таймер"
- Использование ИИ в email-редакторе
- Поддержка мессенджер-протоколов почтовыми клиентами и платформами
Омниканальность
- SDK для мобильных приложений
- Управление ключами доступа к мобильному SDK
- Подключение мобильного приложения
- Создание и загрузка ключа Firebase
- Создание мобильных push-сообщений
- Настройка аналитики доставляемости и кликов
- Планирование мобильных push-уведомлений
- Типы диплинков
- Отправка тестовых сообщений из отладки запросов
- Настройка виджетов для сайта
- Вызов виджета
- Настройка геоданных для правил вызова виджетов
- Сохранение данных из виджетов в поля контактов
- Защита от раздражения
- Действия после заполнения формы
- Замена системного сценария Double Opt-In
- Создание pop-up-форм с помощью Google Tag Manager или WordPress
- Отправка событий из форм подписки в 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
Смена системы
Документы
Интеграция
Интеграция с Google BigQuery
Google 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 c 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, затем Done.
6. На главной странице раздела Credentials нажмите на ссылку Manage service accounts.
7. Напротив только что созданного аккаунта нажмите три точки и выберите опцию Manage keys.
8. Вы попали в раздел Keys. Нажмите на кнопку Add key и выберите вариант Create new key.
9. В появившемся диалоговом окне выберите тип ключа JSON и нажмите CREATE.
После этого браузер автоматически скачает ключ в папку для загрузки.
Потом в настройках eSputnik вы загрузите этот ключ.
Подключение BigQuery
Чтобы подключить BigQuery к eSputnik, перейдите в “Настройки”① → “Коннекторы”② и нажмите “Подключить BigQuery”③.
В открывшемся окне настроек впишите название①, загрузите ключ проекта② и задайте соответствие полей, содержащих ключ уникальности③. Благодаря этому ключу уникальности система eSputnik будет ассоциировать поля с контактами в BigQuery. Без ключа уникальности нельзя будет построить ни сегмент по параметрам из BigQuery, ни подставить данные в сообщение.
После сохранения настроек подключение будет отображаться в разделе “Настройки” → “Коннекторы”. Кликнув на название, вы сможете зайти в настройки и редактировать параметры. Например, изменить правило сопоставления уникальных полей, если идентификатор контактов в BQ поменялся.
Экспорт данных из системы eSputnik в таблицу BigQuery
Чтобы регулярно актуализировать в BigQuery информацию об аудитории, активности контактов в виджетах, заказах и результатах рассылок, настройте экспорт данных в таблицы. Например, это могут быть ответы на NPS-опрос, история покупок, дата последнего перехода из рассылки и т. д.
Доступные наборы данных для экспорта:
- broadcasts;
- contactActivities;
- contacts;
- devices;
- events;
- messages;
- orderItems;
- orders;
- revenue.
После настройки 1 раз в сутки данная информация будет передаваться в BigQuery и обновлять данные в таблицах.
Важный момент
Предварительно создавать таблицы в BigQuery не нужно. Они создаются автоматически при первом экспорте и в дальнейшем информация в них будет обновляться. Названия таблиц будут соответствовать наборам данных (contactActivities, contacts, orderItems, orders).
Список параметров данных для экспорта
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, то система задействует только эту 1 000 контактов. Для того чтобы оперировать всеми 10 000 контактов, их нужно сначала добавить в базу eSputnik через ручной импорт либо методом API Add/update contacts. Позже мы добавим возможность использовать все контакты из внешнего источника, а также автоматически сохранять их в базу eSputnik и обновлять данные уже существующих контактов.