Валидация параметров события

События, которые отправляются в eSputnik, должны соответствовать определенным требованиям. В противном случае сценарии могут не срабатывать, важные данные — теряться, и т. д.

eSputnik позволяет устанавливать необходимые параметры события, предупреждает об ошибках и показывает, что именно и как нужно исправить.

Установка необходимых параметров события

Задайте необходимые параметры, без которых система не будет принимать события.

Шаги по настройке валидации структуры события:

1. Создайте новое событие или зайдите в настройки уже созданного (инструкция по созданию событий).
2. Активируйте свитчер “Валидировать параметры”.
3. Кликните “+ Добавить параметр”.
4. Введите название параметра в соответствующее поле и при необходимости установите флажок “Обязательный параметр”.
5. При необходимости добавьте другие параметры, затем нажмите “Редактировать“.

Валидация параметров событий

Валидируйте параметры и структуру события с помощью API-метода Generate event. Укажите параметры в массиве params.

В ответ на невалидное событие отправляется сообщение об ошибке 400 bad request и требования к событию.

Пример ответа:

The event should have the following params: [
    {
        "name": "EmailAddress",
        "required": true
    },
    {
        "name": "Phone Number",
        "required": false
    },
    {
        "name": "Name",
        "required": false
    }
]
JSON
COPY

Типы событий с включенной валидацией параметров обозначаются иконкой проверки.

Требования к событиям

eventTypeKey

eventParams

eventParams содержат два типа информации:

• Идентификаторы контактов (обязательно). Пример:

{
   "name": "externalCustomerId",
   "value": "a7c9f9b8-d3a2-401c-8b93-7f3d4f91bfa2"
}
JSON
COPY

• Дополнительные параметры события (опционально). Пример:

{  
  "name": "cartId",  
  "value": "CART12345"  
}
JSON
COPY

Пример события AbandonedCart >