/
Атрибуты событий. Widget.

Атрибуты событий. Widget.

Общая информация.

Начиная с версии виджета 4.1.0 вместе с событиями можно отправлять атрибуты этого события. В связи с этим метод отправки событий расширяется, для поддержки отправки второго параметра, при этом поддержка обратной совместимости сохраняется, т.е. все настроенные до этого события будут работать как раньше.

UXS.sendEvent("eventName");

UXS.sendEvent("eventName", { attributeName: "attributeValue", ... });

Выше представлены два валидных варианта для отправки событий.

Значения атрибутов не передаются в ответах и не сохраняются, а отвечают только за тергетирование. Для дополнения ответов используйте этот метод.

Правила атрибутов.

После настройки атрибутов для кампании, они становятся обязательным условием для показа формы. Т.е. если название события совпадает, но хотя бы один из атрибутов не удовлетворяет настроенным условиям, то форма не покажется.

Показ формы определятся путем применения логического “И” между названием события и всеми атрибутами.

На текущий момент доступно 4 варианта правил для атрибутов:

  • Точное соответствие

Атрибут считается удовлетворяющим требованиям только в том в случае, если передаваемое значение на сайте для атрибута с соответствующим названием в точности совпадает со значением, введенным при настройке.

Пример корректного вызова для настройки атрибута с названием city и значением Novgorod

UXS.sendEvent("eventName", { city: "Novgorod" });

Пример некорректного вызова для настройки атрибута с названием city и значением Novgorod

UXS.sendEvent("eventName", { city: "Nizhni Novgorod" });

UXS.sendEvent("eventName", { city: "novgorod" });

  • Содержит

Атрибут считается удовлетворяющим требованиям только в том в случае, если передаваемое значение на сайте для атрибута с соответствующим названием является строкой, которая содержит подстроку введенную при настройке атрибута.

Данное правило не поддерживает никакие спецсимволы, поэтому вся строка, введенная на этапе настройки, будет в таком же виде сопоставляться со значениями на сайте.

Пример корректного вызова для настройки атрибута с названием os и значением IOS

UXS.sendEvent("eventName", { os: "IOS 16.1.1" });

UXS.sendEvent("eventName", { os: "IOS 16.2.2" });

Пример некорректного вызова для настройки атрибута с названием os и значением IOS

UXS.sendEvent("eventName", { os: "iOS 16.1.1" });

Пример некорректного вызова для настройки атрибута с названием os и значением IOS, android

UXS.sendEvent("eventName", { os: "iOS 16.1.1" });

UXS.sendEvent("eventName", { os: "android 14" });

  • Диапазон чисел

Атрибут считается удовлетворяющим требованиям только в том в случае, если передаваемое значение на сайте для атрибута с соответствующим названием находится в диапазоне чисел введенными в настройках кампании.

Диапазон чисел включает в себя все числа из диапазона, а также граничные числа (т.е. работает по правилу больше или равно).

В диапазоне чисел допускается не указывать значение “до”. В таком варианте все числа больше или равные числа “от” будут удовлетворять требованиям.

В диапазоне чисел допускается не указывать значение “от”. В таком варианте все числа меньше или равные числа “до” будут удовлетворять требованиям (значения могут принимать отрицательные значения).

Значения для диапазона числе могут принимать и нецелые значения, с максимальной точностью 15-16 значащих цифр.

Десятичный разделитель - это . (точка)

Пример корректного вызова для настройки атрибута с названием cartItems и значением от 3 до 5

UXS.sendEvent("eventName", { cartItems : "3" });

UXS.sendEvent("eventName", { cartItems : "4" });

UXS.sendEvent("eventName", { cartItems : "5" });

Пример некорректного вызова для настройки атрибута с названием cartItems и значением от 3 до 5

UXS.sendEvent("eventName", { cartItems : "2" });

UXS.sendEvent("eventName", { cartItems : "-1" });

UXS.sendEvent("eventName", { cartItems : "10" });

  • Диапазон дат

Атрибут считается удовлетворяющим требованиям только в том в случае, если передаваемое значение на сайте для атрибута с соответствующим названием находится в диапазоне дат, введенных в настройках кампании.

Диапазон дат включает в себя все даты из диапазона, а также граничные даты.

Скрипт виджета принимает дату только в формате строки вида YYYY-MM-DD (ISO 8601)

Пример корректного вызова для настройки атрибута с названием orderDate и значением от 01.05.2024 до 10.05.2024

UXS.sendEvent("eventName", { orderDate: "2024-05-02" });

UXS.sendEvent("eventName", { orderDate: "2024-05-01" })

UXS.sendEvent("eventName", { orderDate: "2024-05-10" })

Пример некорректного вызова для настройки атрибута с названием orderDate и значением от 01.05.2024 до 10.05.2024

UXS.sendEvent("eventName", { orderDate: new Date("2024-05-10") });

UXS.sendEvent("eventName", { orderDate: "07.05.2024" });

UXS.sendEvent("eventName", { orderDate: "07/05/2024" });

UXS.sendEvent("eventName", { orderDate: "2024-04-01" });

UXS.sendEvent("eventName", { orderDate: "2024-05-11" });

Несколько атрибутов.

Вызвать метод для отправки событий можно с большим количеством атрибутов, чем указано в настройках кампании. Для показа кампании самое главное, чтобы указанные в настройках атрибуты принимали соответствующие значения.

К примеру, если у кампании не настроены атрибуты, а используется обычный таргетинг на событие, то следующие события будут вызывать показ кампании:

UXS.sendEvent("eventName", { city: "Novgorod" });

UXS.sendEvent("eventName", { city: "Novgorod", os: "IOS 16.1.1" });

UXS.sendEvent("eventName");