Перші кроки
Відстеження подій та поведінки
- Отримання та встановлення скрипта веб-трекінгу
- Налаштування веб-трекінгу прив'язкою до селекторів сайту
- Налаштування веб-трекінгу для персоналізації контенту на сайті та в розсилках
- Передача даних про поведінку відвідувачів сайту через JavaScript
- Передача даних про поведінку відвідувачів сайту через REST API
Дані користувача
- Огляд адаптивного email-редактора
- Cтворення оформлення для листа
- Створення синхронізованих модулів
- Налаштування адаптивності
- Налаштування Smart-елементів
- Оформлення промовкладки для Gmail
- Додавання Rolloverʼа
- Додавання фону до листа
- Додавання анкорних посилань
- Бібліотека блоків (Модулі)
- Додавання таблиці до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Робота з блоком "Зображення"
Омніканальність
- SDK для мобільних застосунків
- Керування ключами доступу до мобільного SDK
- Підключення мобільного додатка
- Створення Google проекту для Mob Push
- Створення мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Планування мобільних push-повідомлень
- Налаштування універсальних посилань (deeplinks & Universal links)
- Звіти за мобільними push-розсилками
Автоматизація
Персоналізація
- Підстановка промокоду з файлу
- Підстановка промокоду з використанням API
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду за допомогою персоналізації
- Завантаження промокодів для використання в сценарії
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
Аналітика
Мультимовність
Товарні рекомендації
API
- Інтеграція з API — найчастіші питання
- API-ключі
- Ресурси API для додавання контактів
- Використання API-ресурсу Generate event
- Передача замовлень API-ресурсом Generate event
- Отримання рекомендацій щодо API ресурсом Contact recommendations based on web tracking
- Використання API-ресурсу Send prepared message
Зміна системи
Документи
Інтеграція
Передача рекомендацій через 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, ознайомтеся з цією інструкцією.