Nastavit

Můžete použít zaraz.set() kdekoli uvnitř <body> značka stránky:

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

Set je užitečné, pokud chcete, aby byla proměnná dostupná ve všech vašich událostech, aniž byste ji museli ručně nastavovat pokaždé, když používáte zaraz.track(). Pro účely tohoto příkladu předpokládejme, že uživatelé ve vašem systému mají jedinečný identifikátor, který chcete odesílat svým nástrojům. Můžete mít mnoho zaraz.track() volání, která všechna sdílejí tento jeden parametr:

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"})

Zde všechny události shromažďují userId klíč a kód pro nastavení tohoto klíče se opakuje. S zaraz.set() se můžete vyhnout opakování tím, že klíč nastavíte jednou při načtení stránky. Zaraz pak tento klíč připojí ke všem budoucím zaraz.track() volání.

Použijeme-li výše uvedená data jako příklad, pokud použijete zaraz.set("userId", "ABC-123") jednou, před zaraz.track() volání můžete odebrat userId klíč ze všech zaraz.track() volání.

Další příklad:

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

Klíče, které se odesílají pomocí zaraz.set() lze použít uvnitř akcí nástroje úplně stejně jako klíče v eventProperties z zaraz.track(). Výše uvedené product klíč je dostupný v Cloudflare dashboardu pod proměnnou Název Track Property:, a nastavte její název jako product_name. Zaraz ho poté nahradí t-shirt.

Příklad vytvoření proměnné pomocí metody Set při sledování triček

[options] argument je volitelný objekt a může obsahovat scope vlastnost s hodnotou typu řetězec. Tato vlastnost určuje životnost tohoto klíče, tedy jak dlouho jej má Zaraz nadále připojovat k zaraz.track() volání. Povolené hodnoty jsou:

page: Nastaví klíč pouze pro kontext aktuální stránky.
session: Klíč zůstane platný po celou dobu relace.
persist: Uloží klíč napříč relacemi. Jde o výchozí režim, který používá localStorage a uložte hodnotu.

V předchozím příkladu {scope: 'page'} způsobí, že product_name vlastnost dostupná všem zaraz.track() volání na aktuální stránce, ale neovlivní volání poté, co návštěvníci přejdou na jiné stránky.

Hodnotu proměnné zrušíte tak, že ji nastavíte na undefined. Proměnná se poté odstraní ze všech rozsahů platnosti, do kterých byla zahrnuta, a nebude se automaticky odesílat s dalšími zaraz.track volání. Například:

zaraz.set('product_name', undefined)