Первые шаги
Отслеживание событий и поведения
Пользовательские данные
- Создание сквозных модулей
- Оформление промовкладки для Gmail
- Настройка Smart-элементов
- Обзор адаптивного email-редактора
- Создание футера
- Настройка адаптивности
- Добавление Rolloverʼа
- Настройка блока "Меню"
- Добавление анкорных ссылок
- Робота с блоком "Изображения"
- Работа с блоком "Соцсети"
- Добавление таблицы в письмо
- Добавление фона в письмо
- Добавление пользовательских шрифтов
- Добавление кастомных иконок соцсетей
- Создание кнопки CTA
- Создание оформления для письма
- Редактирование HTML и CSS
- Работа с блоком "Баннер"
- Добавление блока "Видео"
- Библиотека блоков (Модули)
- Работа с блоком “Таймер"
Омниканальность
- Настройка универсальных ссылок (deeplinks & Universal links)
- Создание Google проекта для Mob Push
- Подключение мобильного приложения
- Планирование мобильных push-уведомлений
- Настройка аналитики доставляемости и кликов
- Управление ключами доступа к мобильному SDK
- Создание мобильных push-сообщений
- Отчеты по мобильным push-рассылкам
- SDK для мобильных приложений
Автоматизация
- Согласование переменных события со сценарием на примере сценария "Заказ доставлен"
- Запуск сценария после импорта контактов
- Поздравление с днем рождения
- Запуск Welcome-серии для разных категорий
- Двойное подтверждение подписки
- Приветственная серия
- Контроль триггеров
- Привязка сценария к кнопке
- Реактивация клиентов и подписчиков
- Сбор отзывов о заказе
- Если сценарий не работает
- Отправка рассылки непрочитавшим
- Регулярный сценарий для группы
Персонализация
- HTTP-запрос для передачи промокода из сообщения в карточку контакта
- Принципы генерации промокодов с помощью PHP/JAVA
- Подстановка промокода с использованием API
- Загрузка промокодов для использования в сценарии
- Подстановка промокода с помощью персонализации
- Подстановка промокода из файла
- Генерация промокодов в сценарии
- Отправка промокода с помощью препроцессора
Аналитика
- Отчет по AMP-рассылке
- Отчет по Viber-рассылке
- Отчёт по email-рассылке
- Настройка передачи UTM-меток
- Отчет по Web-push рассылке
- Визуализация дохода от рассылок
- Как открыть CSV-файл после экспорта
- Отслеживание эффективности рассылок в Google Analytics
- Отчет по SMS-рассылке
- Отчеты по мобильным push-рассылкам
Мультиязычность
API
Смена системы
Документы
Интеграция
Внешний ID для создания и обновления контактов
Внешний ID – это уникальный идентификатор контакта, который генерируется в вашей контактной базе. Чтобы избежать дублирования контактов, собирать все доступные данные в единый профиль контакта и получать полную информацию о его взаимодействии с вашей компанией, мы рекомендуем использовать его как основной идентификатор в поле API-запроса externalCustomerId (также может называться 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 с полем externalCustomerId, мы рекомендуем проводить каждое его обновление с уникальностью по externalCustomerId — например, при логине (Add/update a contact), создании заказа (Add orders или Generate event) и т. п. Таким образом вы сможете постоянно поддерживать актуальность всех контактных данных, поскольку externalCustomerId уникален и неизменен, а другие идентификаторы, даже постоянные, могут изменяться.
Примечание
Если ваша система не присваивает контактам ID, вы можете использовать системный ID eSputnik (Contact_id) и затем сохранять его на своей стороне как идентификатор клиента. Но использование externalCustomerId является лучшим вариантом, ведь такая идентификация на 100% предотвращает создание дубликатов.
Внешний ID клиента для маппинга событий с контактами
Система автоматически привязывает события к контактам. Чтобы событие сохранилось с привязкой к контакту, необходимо знать, какой параметр события содержит идентификатор, по которому можно найти контакт. А также какое поле контакта используется в качестве идентификатора. Если идентификатор контакта не задан в событии, по умолчанию система ищет параметр события ContactId.
Если вы передаете идентификатор в поле “Внешний ID клиента”, дополнительно настраивать маппинг не нужно. Но если этот идентификатор передается в поле с другим названием, его нужно соотнести с системным полем "Внешний ID клиента".
Чтобы сделать это:
1. Перейдите к настройкам вашего аккаунта -> События -> активируйте свитчер "Задайте правило соответствия для привязки события".
2. Укажите имя параметра в событии и выберите поле "Внешний ID клиента".
3. Кликните "Сохранить".
Обратите внимание
Вы можете создать условную группу, чтобы проверить, все ли ли ваши контакты имеют External customer ID.
Внешний 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.