Первые шаги
Пользовательские данные
- Обзор адаптивного 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
Смена системы
Документы
Интеграция
Внешний ID для создания и обновления контактов
Внешний ID – это уникальный идентификатор контакта, который генерируется в вашей контактной базе. Чтобы избежать дублирования контактов, собирать все доступные данные в единый профиль контакта и получать полную информацию о его взаимодействии с вашей компанией, мы рекомендуем использовать его как основной идентификатор в поле API-запроса externalCustomerId (в мобильном SDK — user_id).
Типы идентификаторов
Контактные идентификаторы можно разделить на условно постоянные и изменяемые:
- условно постоянные — email, номер телефона и т.д.
- изменяющиеся — web cookies, мобильные, телеграм и веб-токены.
Обычно сначала в систему попадают изменяющиеся идентификаторы, но внешний ID привязывается только к условно постоянным идентификаторам.
Важно
Внешний ID должен создаваться в вашей системе в тот момент, когда вы впервые получаете любой условно постоянный идентификатор
Чтобы лучше понять, как контактные данные попадают в систему и как оптимизировать идентификацию контактов, рассмотрим два базовых примера: для мобильных приложений и веб-сайтов.
Пример 1. Создание и обновление контакта из мобильного приложения
- Контакт устанавливает приложение мобильное устройство с ОС Android.
- Приложение передает в eSputnik мобильный токен контакта (метод API Add/update a contact).
- В eSputnik создается контакт с этим токеном в качестве идентификатора.
- Контакт регистрируется в приложении.
- В вашу систему попадают условно постоянные идентификаторы, такие как email, номер телефона или имя.
- Ваша система присваивает этому контакту уникальный ID и передает его в eSputnik вместе с другими идентификаторами, в том числе с мобильным токеном (метод API Add/update a contact).
- eSputnik находит контакт с этим мобильным токеном и обновляет его карту, записывая в нее новые идентификаторы.
Пример 2. Создание и обновление контакта для веб-сайта
- Незалогенный контакт посещает ваш сайт.
- В eSputnik передаются и записываются соответствующие cookies. Контакт не создается (используется скрипт веб-трекинга).
- Контакт регистрируется на сайте или подписывается на рассылку.
- В вашу систему попадают постоянные идентификаторы, такие как email, номер телефона или имя.
- Ваша система присваивает этому контакту уникальный ID и передает его в eSputnik вместе с другими идентификаторами (Add/update a contact или Subscribe contact).
- eSputnik сохраняет контакт со всеми передаваемыми идентификаторами и добавляет его предыдущую историю взаимодействия с вашим сайтом (файлы cookies).
После того как контакт был создан в eSputnik с полем External ID, мы рекомендуем проводить каждое его обновление с уникальностью по этому полю — например, при логине (Add/update a contact), создании заказа (Add orders или Generate event) и т. п. Таким образом вы сможете постоянно поддерживать актуальность всех контактных данных, поскольку внешний ID уникален и неизменен, а другие идентификаторы, даже постоянные, могут изменяться.
Примечание
Если ваша система не присваивает контактам ID, вы можете использовать системный ID eSputnik (contactId) и затем сохранять его на своей стороне как идентификатор клиента. Но использование External ID является лучшим вариантом, ведь такая идентификация на 100% предотвращает создание дубликатов.
Внешний ID в методах API для одиночных контактов
Ознакомьтесь с обновленной логикой работы методов API, работающих с одним контактом:
Создать контакт (Add/update a contact)
Принимая запрос, система ищет соответствующий контакт по внешнему ID:
- если контакт с этим внешним ID найден, он обновляется данными из запроса;
- если контакт не найден, он создается в системе.
- если контакт с этим внешним ID был удален, он будет восстановлен;
- если внешний ID в запросе отсутствует, логика создания остается неизменной.
Обновить контакт (Update contact)
В URL запроса задается contactId, а в теле передается внешний ID:
- если этот внешний ID уже принадлежит контакту с другим contactId, произойдет ошибка;
- если внешний ID не принадлежит другому контакту, контакт обновится и ему будет предоставлен этот ID;
- если внешний ID не задан, логика остается без изменений.
Получить контакт (Get contact)
Внешний ID добавляется к данным контакта, которые возвращаются запросом.
Подписать контакт (Subscribe contact)
В логике поиска контакта внешний ID имеет самый высокий приоритет; если контакт по этому идентификатору не найден, система ищет его по email-адресу, если email не найден — по номеру телефона.
Внешний ID в методах API для работы с массовыми контактами
Обновлена логика работы массовых методов API.
Поиск (Search contacts)
Вы можете задать уникальность поиска контакта по полю "externalCustomerId". В этом случае задать другие параметры поиска нельзя.
Импорт (Add/update contacts)
При импорте контактов можно использовать любое поле, чтобы определить их уникальность. Например, импортировать контакты с уникальностью по email-адресу, при этом добавлять или обновлять их внешние ID.
Использование в ресурсе Send prepared message
Поддержана возможность использования внешнего ID в ресурсе Send prepared message. Это позволяет отправлять одиночные сообщения через сценарий с учетом этого поля.
Кроме locator или contactId, входные параметры также можно валидировать по полю externalCustomerId.
Приоритет проверки полей: contactId > externalCustomerId > locator.
Экспорт внешнего ID в BigQuery и PostgreSQL
Экспортируйте внешние ID в BigQuery и PostgreSQL — они появятся в колонке в таблице contacts. По умолчанию эта опция доступна для всех новых экспортов. Если вы хотите создать ее для уже существующих экспортов, напишите в службу поддержки на support@esputnik.com.
Поиск контактов без внешнего ID в учетной записи eSputnik
Создайте условную группу, чтобы проверить, все ли ваши контакты имеют внешний ID.
- Перейдите в "Контакты" → "Группы" и создайте условную группу.
- Добавьте условие: "Поля контакта" → External ID → "не указано" и нажмите "Готово".
Система найдет все контакты без внешних идентификаторов и поместит их в эту группу. Поскольку сегмент динамический, все новые контакты без внешних идентификаторов также будут автоматически помещаться в него.