Track

Вы можете использовать zaraz.track() в любом месте внутри <body> тег страницы.

zaraz.track() позволяет отслеживать пользовательские события на сайте, которые могут происходить в режиме реального времени. Это async функцию, поэтому вы можете выбрать await его, если хотите убедиться, что он завершился, прежде чем выполнять остальной код.

К пользовательским событиям, которые может быть полезно отслеживать, относятся успешные регистрации, клики по призывам к действию и покупки. Среди других распространённых примеров: отслеживание показов отдельных элементов страницы или загрузки определённого виджета.

Чтобы начать отслеживать события, используйте zaraz.track() функцию следующим образом:

zaraz.track(eventName, [eventProperties]);

eventName параметр является строкой, а eventProperties параметр представляет собой необязательный плоский объект с дополнительным контекстом, который можно прикрепить к событию, используя собственные ключи по вашему выбору. Например, отслеживание покупки на сумму 200 USD может выглядеть так:

zaraz.track("purchase", { value: 200, currency: "USD" });

Обратите внимание, что имя события (purchase в примере выше), названия ключей (value и currency) и количество ключей можно настроить самостоятельно. Вы сами выбираете, какие переменные отслеживать и как именно их отслеживать. При этом осмысленные имена облегчат настройку триггеров, поскольку конфигурация триггера должна соответствовать событиям, которые отправляет ваш сайт.

После использования zaraz.track() на вашем сайте, обычно вы захотите создать триггер на его основе, а затем использовать этот триггер в действии. Начните с создания нового триггера, с Имя события в качестве вашего триггера Имя переменной, и eventName которое вы отслеживаете в Строка сопоставления. Следуя приведённому выше примеру, ваш триггер будет выглядеть так:

Пример триггера: Match zaraz.track("purchase")

Тип правила	Имя переменной	Операция сопоставления	Строка сопоставления
Правило сопоставления	Имя события	Equals	`purchase`

В каждом инструменте, где нужно использовать этот триггер, добавьте действие с этим триггером настроен как срабатывающий триггер. Каждое действие, использующее этот триггер, может обращаться к eventProperties которые вы отправили. В Действие поля можно использовать {{ client.<KEY_NAME> }} чтобы получить значение <KEY_NAME>. В приведённом выше примере Zaraz заменит {{ client.value }} с 200. Если ваш ключ содержит специальные символы или цифры, заключите его в обратные кавычки, например {{ client.`<KEY_NAME>` }}.

Подробнее о свойствах, которые можно использовать с zaraz.track(), см. Справочник свойств.