Установить

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

zaraz.set(key, value, [options])

Set удобен, если вы хотите, чтобы переменная была доступна во всех ваших событиях без необходимости каждый раз задавать её вручную при использовании zaraz.track(). Для этого примера предположим, что у пользователей в вашей системе есть уникальный идентификатор, который вы хотите отправлять своим инструментам. У вас может быть много zaraz.track() вызовов, у которых есть общий параметр:

zaraz.track("form completed", {userId: "ABC-123"})

zaraz.track("button clicked", {userId: "ABC-123", value: 200})

zaraz.track("cart viewed", {items: 3, userId: "ABC-123"})

Здесь все события собирают userId ключ, и код для установки этого ключа повторяется. С помощью zaraz.set() вы можете избежать повторения, задав ключ один раз при загрузке страницы. После этого Zaraz будет добавлять этот ключ ко всем последующим zaraz.track() вызовы.

Если использовать приведённые выше данные в качестве примера и применить zaraz.set("userId", "ABC-123") один раз, перед zaraz.track() вызовов можно удалить userId ключ из всех zaraz.track() вызовы.

Ещё один пример:

zaraz.set('product_name', 't-shirt', {scope: 'page'})

Ключи, которые отправляются с помощью zaraz.set() можно использовать внутри действий инструмента точно так же, как ключи в eventProperties zaraz.track(). Таким образом, приведённый выше product ключ доступен через панель управления Cloudflare с помощью переменной Название Track Property:, задав ему имя product_name. После этого Zaraz заменит его на t-shirt.

Пример создания переменной методом Set для отслеживания футболок

[options] аргумент является необязательным объектом и может включать scope свойство со строковым значением. Это свойство определяет срок жизни ключа, то есть как долго Zaraz будет прикреплять его к zaraz.track() вызовов. Допустимые значения:

page: Чтобы задать ключ только в контексте текущей страницы.
session: Чтобы ключ сохранялся в течение всей сессии.
persist: Чтобы сохранить ключ между сессиями. Это режим по умолчанию, использующий localStorage чтобы сохранить значение.

В предыдущем примере {scope: 'page'} делает product_name свойство, доступное для всех zaraz.track() вызовов на текущей странице, но не повлияет на вызовы после перехода посетителей на другие страницы.

Чтобы сбросить значение переменной, присвойте ей значение undefined. После этого переменная будет удалена из всех областей, в которые она была включена, и не будет автоматически отправляться при последующих zaraz.track вызовов. Например:

zaraz.set('product_name', undefined)