Валідація параметрів подій
Події, що надсилаються до eSputnik, повинні відповідати певним вимогам. Інакше сценарії можуть не спрацьовувати, важливі дані — губитися, тощо.
eSputnik дозволяє встановлювати необхідні параметри події, попереджає про помилки та показує, що саме та як потрібно виправити.
Встановлення необхідних параметрів події
Вкажіть необхідні параметри, без яких система не прийматиме події.
Кроки з налаштування валідації структури події:
- Створіть нову подію або зайдіть в налаштування вже створеної (інструкція зі створення подій).
- Активуйте перемикач Валідувати параметри.
- Натисніть + Додати параметр.
- Введіть назву параметра у відповідне поле та за потреби встановіть прапорець Обов'язковий параметр.
- Якщо потрібно, додайте інші параметри, а потім натисніть Редагувати.

Валідація параметрів подій
Валідуйте параметри та структуру події за допомогою API-методу Generate event.
Вкажіть параметри у масиві BODY PARAMS.

У відповідь на невалідну подію надсилається повідомлення про помилку 400 bad request
та вимоги до події.
Приклад відповіді:
{
"params": {
"EmailAddress": {
"required": true
},
"Phone Number": {
"required": false
},
"Name": {
"required": false
}
}
}
Типи подій з ввімкненою валідацією параметрів, позначаються іконкою перевірки.

Вимоги до подій
eventTypeKey
Параметр | Тип | Обов'язковий/Опціональний | Опис | Вимоги |
---|---|---|---|---|
eventTypeKey | String | Обов'язковий | Унікальний ідентифікатор типу події, наприклад, PageViewed. Після першого запиту він з'явиться у вашому обліковому записі, і ви зможете побачити його у розділі Тригери → Типи подій. |
|
eventParams
eventParams містять два типи інформації:
-
Ідентифікатори контактів (обов'язково). Приклад:
{ "externalCustomerId": "a7c9f9b8-d3a2-401c-8b93-7f3d4f91bfa2" }
-
Додаткові параметри події (опційно). Приклад:
{ "subscriptionPlan": "Premium" }
Параметр | Тип | Обов'язковий/Опціональний | Опис | Вимоги |
---|---|---|---|---|
Ідентифікатори контактів | String | Обов'язковий | eventParams повинні містити ідентифікатор контакту для визначення унікальності події. Пріоритет параметрів наступний: |
|
Додаткові параметри події | Об'єкт | Опціональний | Масив об'єктів — списки з парами “ключ-значення”, що містять параметри події. |
|
Приклад події AbandonedCart >
Updated 17 days ago