Первые шаги
Отслеживание событий и поведения
Пользовательские данные
- Обзор адаптивного email-редактора
- Создание оформления для письма
- Создание сквозных модулей
- Настройка адаптивности
- Настройка Smart-элементов
- Оформление промовкладки для Gmail
- Добавление Rolloverʼа
- Добавление фона в письмо
- Добавление анкорных ссылок
- Библиотека блоков (Модули)
- Добавление блока "Видео"
- Добавление таблицы в письмо
- Работа с блоком "Баннер"
- Добавление пользовательских шрифтов
- Добавление кастомных иконок соцсетей
- Работа с блоком "Соцсети"
- Создание кнопки CTA
- Редактирование HTML и CSS
- Робота с блоком "Изображения"
- Работа с блоком “Таймер"
- Настройка блока "Меню"
- Создание футера
Омниканальность
- SDK для мобильных приложений
- Управление ключами доступа к мобильному SDK
- Подключение мобильного приложения
- Создание Google проекта для Mob Push
- Создание мобильных push-сообщений
- Настройка аналитики доставляемости и кликов
- Планирование мобильных push-уведомлений
- Настройка универсальных ссылок (deeplinks & Universal links)
- Отчеты по мобильным push-рассылкам
Автоматизация
- Настройка дополнительных рассылок
- Двойное подтверждение подписки
- Приветственная серия
- Приветственная серия с сегментацией по категориям
- Запуск сценария после импорта контактов
- Регулярный сценарий для группы
- Поздравление с днем рождения
- Привязка сценария к кнопке
- Согласование переменных события со сценарием на примере сценария "Заказ доставлен"
- Сбор отзывов о заказе
- Реактивация клиентов и подписчиков
- Отправка рассылки непрочитавшим
Персонализация
- Подстановка промокода из файла
- Подстановка промокода с использованием API
- Принципы генерации промокодов с помощью PHP/JAVA
- Подстановка промокода с помощью персонализации
- Загрузка промокодов для использования в сценарии
- Генерация промокодов в сценарии
- Отправка промокода с помощью препроцессора
- HTTP-запрос для передачи промокода из сообщения в карточку контакта
Аналитика
- Отчёт по email-рассылке
- Отчет по AMP-рассылке
- Отчеты по мобильным push-рассылкам
- Отчет по SMS-рассылке
- Отчет по Web-push рассылке
- Отчет по Viber-рассылке
- Настройка передачи UTM-меток
- Визуализация дохода от рассылок
- Отслеживание эффективности рассылок в Google Analytics
- Как открыть CSV-файл после экспорта
Мультиязычность
Товарные рекомендации
API
Смена системы
Документы
Интеграция
Передача рекомендаций через JavaScript API
Если вы планируете использовать алгоритмы товарных рекомендации eSputnik, а отображение (внешний вид блоков, страницы показа и т. д.) настроить на своей стороне, вам необходимо
- установить на сайт скрипт для отслеживания поведения посетителей сайта;
- загрузить фид товарных данных в аккаунт eSputnik;
- настроить передачу рекомендаций из eSputnik на ваш сайт.
Описание настроек
Функция JS API необходима для получения рекомендаций и дальнейшего их использования в товарных блоках на сайте.
Скрипты получения рекомендаций
На главной и 404 странице
eS('getRecommendations', {
'variantId': 'r554v778'
}, function(error, products) {
if (error) {
console.error(error);
return ;
}
});
На странице товара
eS('getRecommendations', {
'variantId': 'r554v778',
'productId': 'MX-1512\42'
}, function(error, products) {
if (error) {
console.error(error);
return ;
}
});
На странице корзины
eS('getRecommendations', {
'variantId': 'r554v778',
'productIds': ['123', '543534']
}, function(error, products) {
if (error) {
console.error(error);
return ;
}
});
На поп-апе корзины использование события StatusCartPage
eS('sendEvent', 'StatusCartPage');
На странице категорий
eS('getRecommendations', {
'variantId': 'r554v778',
'categoryKey': 'cK'
}, function(error, products) {
if (error) {
console.error(error);
return ;
}
});
Метод JS API – асинхронный, что позволяет не ждать выполнения других функций на сайте.
Параметры запроса
Название |
Тип |
Пример |
Описание |
variantId |
Required String |
r262v361 |
Уникальный идентификатор варианта рекомендации, созданный в аккаунте eSputnik. |
productId |
Optional String |
MX-1512\42 |
Для передачи id товара со страницы, на которой находится пользователь. Обязательный параметр для рекомендаций с использованием продуктового алгоритма (похожие товары, с этим товаром покупают), для других типов алгоритмов передавать не нужно. |
productIds |
Optional List |
['123', '543534']
|
Для передачи id товара или массива ids товаров корзины. Обязательный параметр для рекомендаций с использованием продуктового алгоритма (похожие товары, с этим товаром покупают), для других типов алгоритмов передавать не нужно. |
categoryKey |
Optional String |
Jackets |
Для передачи ключа категории, в которой находится пользователь. Обязательный параметр для рекомендаций с использованием категориального алгоритма (персонально для вас в этой категории), для других типов алгоритмов передавать не нужно. |
allFields | Optional Boolean | true\false |
Параметр для определения того, какие атрибуты товара будут в запросе рекомендаций: Все (которые имеются в фиде товарных данных) или только Обязательные: product_id По умолчанию параметр = false |
Пример ответа
При успешной отправке запроса вы получите ответ следующего вида:
Тело ответа | Тип | Описание |
|
List<object> | ● product_id - идентификатор рекомендуемого товара ● container_type необходимо использовать при передаче события ProductImpression ● url содержит ссылку на товар, с дополнительным параметром для правильного трекинга кликов. |
Важно
Вы не должны редактировать, возвращаемое значение в поле URL-адреса, чтобы веб-трекинг работал правильно.
Пример ошибки
Пример |
Тип |
Описание |
variantId r262v361 was not found in config |
String |
Такой идентификатор варианта рекомендации не найден. |
Важно
После вызова и отображения блока рекомендаций для правильного трекинга необходимо передавать событие ProductImpressions.
Фильтрация рекомендаций
Фильтрация рекомендаций через JavaScript API позволяет показывать товары на сайте, фильтруя выдачу рекомендаций по данным из фида или по контактным данным, хранящимся на вашей стороне. Например, можно фильтровать рекомендации по городу проживания, размеру одежды, любимому бренду, акционному предложению и т. п. параметрам.
Фильтрация рекомендаций через JS API избавляет вас от необходимости каждый раз менять правила фильтрации в источнике данных в eSputnik.
Формат запроса:
eS('getRecommendations', {
variantId: 'r362v614',
'filters': {
'include': [{'name': 'city', values: ['Kiev','Kharkiv']}]
}
},
function(error, products) {
if (error) {
console.error(error);
return;
}
}
);
Параметры запроса:
Название |
Тип | Описание |
filters | Optional Object |
Параметр, включающий правила фильтрации. |
include | Optional List |
Строгая фильтрация: рекомендация только товаров согласно заданным параметрам. Например, показывать только товары определенного бренда. |
exclude | Optional List |
Строгая фильтрация: товары с заданными параметрами не показываются. Например, не показывать акционные товары. |
should | Optional List |
Нестрогая фильтрация: товары с заданными параметрами |
name |
Required |
Название параметра товара из товарного фида. |
values | Required List |
Список значений для фильтрации. Запятая в значениях values — оператор OR (values: ['Kiev','Kharkiv']). |
Если вы хотите задавать отображение внешнего вида рекомендательных блоков в eSputnik, ознакомьтесь с этой инструкцией.