Перші кроки
Відстеження подій та поведінки
Дані користувача
- Створення синхронізованих модулів
- Оформлення промовкладки для Gmail
- Налаштування Smart-елементів
- Огляд адаптивного email-редактора
- Налаштування адаптивності
- Додавання Rolloverʼа
- Додавання анкорних посилань
- Робота з блоком "Зображення"
- Додавання таблиці до листа
- Додавання фону до листа
- Додавання кастомних шрифтів
- Додавання кастомних іконок соцмереж
- Створення кнопки СТA
- Cтворення оформлення для листа
- Бібліотека блоків (Модулі)
Омніканальність
- Налаштування універсальних посилань (deeplinks & Universal links)
- Створення Google проекту для Mob Push
- Підключення мобільного додатка
- Планування мобільних push-повідомлень
- Налаштування аналітики доставлень та кліків
- Керування ключами доступу до мобільного SDK
- Створення мобільних push-повідомлень
- SDK для мобільних застосунків
- Звіти за мобільними push-розсилками
- Service Worker. Усунення несправностей
- Створення welcome ланцюжка для web-push повідомлень
- Як налаштувати підписку на Web Push
- Створення web push-повідомлень
- Інструкція з підключення Safari web push
- Створення Google проекту для збирання web-push токенів
- Додавання даних з веб-активності користувача до веб-пушів
- Створення вебформи для сайтів
- Надсилання подій з форм підписки в Google Analytics
- Як налаштувати інформери для вашого сайту
- Створення pop-up-форм за допомогою Google Tag Manager або WordPress
- Налаштування pop-up віджета для сайту
- Налаштування плаваючого вікна для сайту
- Створення кнопки виклику віджета
- Налаштування віджета вікового обмеження
Автоматизація
- Налаштування форми підписки та подвійного підтвердження
- Як налаштувати автоматичне вітання з Днем народження
- Запуск сценарію після імпорту контактів
- Контроль тригерів
- Як прив'язати сценарій до кнопки
- Усунення несправностей у роботі сценаріїв
- Як відправити розсилку тим, хто не прочитав
- Створення регулярного сценарію для групи
- Створення welcome-ланцюжка для email-повідомлень
Персоналізація
- HTTP-запит для передачі промокоду з повідомлення до картки контакту
- Принципи генерації промокодів за допомогою PHP/JAVA
- Підстановка промокоду з використанням API
- Завантаження промокодів для використання в сценарії
- Підстановка промокоду за допомогою персоналізації
- Підстановка промокоду з файлу
- Генерація промокодів у сценарії
- Відправлення промокоду за допомогою передпроцесора
Аналітика
API
- API-ключі
- Ресурси API для додавання контактів
- Використання API-ресурсу Send prepared message
- Отримання рекомендацій щодо API ресурсом Contact recommendations based on web tracking
- Використання API-ресурсу Generate event
- Інтеграція з API — найчастіші питання
- Передавання замовлень за допомогою ресурсу Generate event
Зміна системи
Документи
Інтеграція
Відстеження активності на сайті за допомогою Generate event
Ви можете передавати та зберігати події, що отримуєте з вашого вебсайту, з вашого бекенду безпосередньо в нашу систему, використовуючи метод Generate event v2. Також, якщо ви налаштували інтеграцію із рекомендаційною системою, ви можете зберігати дані в обох сервісах.
Щоб зробити запит, надішліть вказані нижче параметри в тілі запиту на https://esputnik.com/api/v2/event:
Параметр | Опис |
---|---|
eventTypeKey | Обов'язковий. Ідентифікатор типу події. Якщо такого типу події з таким ключем не існує, то створюється нова подія. |
keyValue | Обов'язковий. Ключ події. Визначає унікальність події. |
params | Перелік параметрів події, представлений у вигляді масиву пар: "ключ" - "значення". Ключі параметрів є довільними. |
Ви можете передавати наступні події:
Подія | Опис |
---|---|
pageViewed | Перегляд сторінки. |
productViewed | Перегляд картки товару. |
productCategoryViewed | Перегляд категорії товару. |
cartUpdated | Зміна позицій товарів у кошику. |
productImpressions | Товарні рекомендації, які відображаються для відвідувача вашого сайту. |
productAddedToWishlist | Відвідувач вашого сайту додав товар до списку бажань. |
searchRequest | Дані про пошук товарів. |
pageViewed
Подія надсилається, коли контакт переглядає будь-яку сторінку або відкриває мобільне посилання на контент ("deeplink").
Приклад запиту наведений нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
String | Адреса електронної пошти. Локатор для визначення зв`язку між подією і контактом. | |
page | String | Розташування сторінки. Обов'язковий для створення події. |
location | String | URL-адреса сторінки або посилання на контент ("deeplink"). Обов'язковий для створення події. |
Приклад:
{
"eventTypeKey": "pageViewed",
"keyValue": "example@email.com",
"params": [
{
"name": "phone",
"value": "380501234567"
},
{
"name": "email",
"value": "example@email.com"
},
{
"name": "page",
"value": "{"location":"https://example.com"}"
}
]
}
productViewed
Подія відправляється, коли контакт переглядає певний продукт. Таку активність можна використовувати в алгоритмах рекомендацій.
Приклад запиту наведений нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
String | Адреса електронної пошти. Локатор для визначення зв`язку між подією і контактом. | |
product | String | Обов'язковий. Дані про товар. |
productId | String | Обов'язковий. Код товару. |
price | Double | Обов'язковий. Ціна за одиницю товару. |
isInStock | Int | Необов'язковий. Наявність товару. Два можливі значення:
|
someProductProperty | Array of strings | Необов'язковий. Розділені комами значення характеристик товару. |
currencyCode | String | Необов'язковий. Код валюти у форматі ISO 4217. Якщо не встановлений, то використовується значення за замовчуванням для організації. |
Приклад:
{
"eventTypeKey": "productViewed",
"keyValue": "example@email.com",
"params": [
{
"name": "phone",
"value": "411786452"
},
{
"name": "email",
"value": "example@email.com"
},
{
"name": "product",
"value": "{"productId":"WS01-L-Green","price":45.5,"isInStock":1,"someProductProperty":["green"]}]}"
},
{
"name": "currencyCode",
"value": "USD"
}
]
}
productCategoryViewed
Подія відправляється коли контакт переглядає список товарів у зазначеній категорії.
Приклад запиту наведений нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
String | Адреса електронної пошти. Локатор для визначення зв`язку між подією і контактом. | |
category | String | Опис категорії. Обов'язковий для створення події. |
productCategoryId | String | Код категорії. Обов'язковий для створення події. |
Приклад:
{
"eventTypeKey": "productCategoryViewed",
"keyValue": "example@email.com",
"params": [
{
"name": "phone",
"value": "7411324763"
},
{
"name": "email",
"value": "example@email.com"
},
{
"name": "category",
"value": "{"productCategoryId":"Mugs"}"
}
]
}
cartUpdated
Подія відправляється, коли контакт змінює товари у кошику. Повний перелік товарів у кошику передається з кожним запитом. Якщо кошик очищений, список товарів буде порожнім.
Приклад запиту наведено нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
String | Адреса електронної пошти. Локатор для визначення зв`язку між подією і контактом. | |
products | Array of strings | Товари. Обов'язковий параметр, якщо кошик не порожній. |
productId | String | Обов'язковий. Код товару. |
quantity | Double | Обов'язковий. Кількість товарів у кошику. |
price | Double | Обов'язковий. Ціна за одиницю товару. |
name | String | Необов'язковий. Найменування товару. |
category | String | Необов'язковий. Категорія товарів. |
discount | String | Необов'язковий. Знижка на одиницю товару. |
someProductProperty | Array of strings | Необов'язковий. Розділені комами значення властивостей товару. |
currencyCode | String | Необов'язковий. Код валюти у форматі ISO 4217. Якщо не встановлений, використовується значення за замовчуванням для організації. |
recycleStateId | String | Обов'язковий. Унікальний ідентифікатор, що пов'язує події кошика та покупки. Генерується як набір випадкових чисел та латинських букв. |
Приклад:
{
"eventTypeKey": "cartUpdated",
"keyValue": "example@email.com",
"params": [
{
"name": "phone",
"value": "73456712"
},
{
"name": "email",
"value": "example@email.com"
},
{
"name": "products",
"value": "[{"productId":"WS01-L-Green","quantity":1,"price":45.5}]"
},
{
"name": "currencyCode",
"value": "USD"
},
{
"name": "recycleStateId",
"value": "d59c6e6d-4123-4b0e-8c32-15f0656a8c60"
}
]
}
productImpressions
Подія передає дані про товарний блок, який відображується на сайті. За замовчуванням він надсилається через JS API. Вам не потрібно надсилати його додатково.
Приклад запиту наведено нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
recomVariantId | String | Обов'язковий. Варіант рекомендації у форматі r{recomId}v{variantId}. |
products | String | Обов'язковий. Містить перелік товарів у форматі JSON. |
productId | String | Обов'язковий. Код товару. |
Приклад:
{
"eventTypeKey": "productImpressions",
"keyValue": "380501234567",
"params": [
// Locator or several locators to map an event to a contact
{
"name": "phone",
"value": Phone
},
{
"name" : "recomVariantId" // Required. Recom variant in r{recomId}v{variantId} format
"value" : string // Mer: container_type
},
{
"name": "products", // Required. Mer: ProductImpression.Products
"value": "[ // string contains JSON for a list
{
// Required product fields
"productId": string // Mer: product_id
},
...
]"
}
]
}
productAddedToWishlist
Подія передає дані про товари, додані до списку бажань (категорія "Обране").
Він використовується для розрахунку та відображення рекомендацій та відправлення тригерів, які пов'язані зі списком бажань.
Приклад запиту наведено нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
product | String | Обов'язковий. Містить перелік товарів, доданих до списку бажань у форматі JSON. |
productId | String | Обов'язковий. Код товару. |
price | Decimal | Обов'язковий. Ціна на товар. |
isInStock | Int | Необов'язковий. Наявність на складі. Може приймати значення: 0 ("немає в наявності") або 1 ("в наявності"). |
someProductProperty | String | Значення характеристик товару. Додаткове поле товару. |
currencyCode | String | Необов'язковий. Код валюти у форматі ISO 4217. Якщо не встановлений, використовується значення за замовчуванням для організації. |
Приклад:
{
"eventTypeKey": "productAddedToWishlist",
"keyValue": "380501234567",
"params": [
// Locator or several locators to map an event to a contact
{
"name": "phone",
"value": Phone
},
{
"name": "product", // Required. Mer: AddToWishlist.Product
"value": "{ // string contains JSON for a product
// Product fields
"productId": string, // Required. Mer: product_key
"price": decimal, // Required. Mer: price
"isInStock": int, // Optional. 0 or 1; Mer: isInStock
// Extended product fields
"someProductProperty": [ string, ... ], // Mer: tag_someProductProperty
...
}"
}
{
"name": "currencyCode", // Optional
"value": CurrencyCode
}
]
}
searchRequest
Подія передає дані про пошукові запити, надіслані з пошукового рядка.
Ця подія використовується для тригерів. Надсилайте її, коли пошук не повертає результатів. У тригері такі контакти отримуватимуть персональні рекомендації (наразі надання рекомендацій не враховує значення, введене у рядку пошуку).
Приклад запиту наведено нижче. Він містить наступні параметри:
Параметр | Тип | Опис |
---|---|---|
phone | String | Номер телефона у міжнародному форматі. Локатор для визначення зв`язку між подією і контактом. |
search | String | Обов'язковий. Запит, введений у рядку пошуку. |
isFound | Int | Необов'язковий. Якщо пошук не повертає результатів, тоді значення дорівнює 0. Якщо пошук повертає будь-які результати, тоді значення дорівнює 1. Значення за замовчуванням – 0. |
Приклад:
{
"eventTypeKey": "searchRequest",
"keyValue": "380501234567",
"params": [
// Locator or several locators to map an event to a contact
{
"name": "phone",
"value": Phone
},
{
"name": "search", // Required. Mer: SearchRequest.search
"value": string
},
{
"name": "isFound", // 0 or 1. Optional, default 0. Mer: SearchRequest.isFound
"value": int
}
]
}