← Cloudflare Zaraz / zaraz / web-api
Track
Můžete použít zaraz.track() kdekoli uvnitř <body> značka stránky.
zaraz.track() umožňuje sledovat vlastní události na vašem webu, ke kterým může docházet v reálném čase. Jedná se o async funkci, takže si můžete zvolit, zda await to, pokud se chcete ujistit, že bylo dokončeno před spuštěním dalšího kódu.
Mezi uživatelské události, které možná budete chtít sledovat, patří úspěšné registrace, kliknutí na výzvy k akci nebo nákupy. U dalších typů událostí jde často o sledování zobrazení konkrétních prvků na stránce nebo načtení konkrétního widgetu.
Sledování událostí zahájíte pomocí zaraz.track() funkci takto:
zaraz.track(eventName, [eventProperties]); eventName parametr je řetězec a eventProperties parametr je volitelný plochý objekt s dalším kontextem, který můžete k události připojit pomocí vlastních klíčů. Sledování nákupu v hodnotě 200 USD by pak mohlo vypadat takto:
zaraz.track("purchase", { value: 200, currency: "USD" });Všimněte si, že název události (purchase v příkladu výše), názvy klíčů (value a currency) a počet klíčů si můžete přizpůsobit sami. Vy si volíte, které proměnné chcete sledovat a jak je sledovat. Výběr výstižných názvů vám ale usnadní konfiguraci triggerů, protože ta musí odpovídat událostem, které vaše webová stránka odesílá.
Po použití zaraz.track() ve svém webu, obvykle budete chtít na jejím základě vytvořit trigger a poté tento trigger použít v akci. Začněte tím, že vytvoření nového spouštěče, s Název události jako spouštěče Název proměnné, a eventName sledujete v Řetězec shody. Podle výše uvedeného příkladu bude váš trigger vypadat takto:
Příklad triggeru: Match zaraz.track("purchase")
| Typ pravidla | Název proměnné | Operace shody | Řetězec shody |
|---|---|---|---|
| Pravidlo shody | Název události | Rovná se | purchase |
V každém nástroji, ve kterém chcete tento spouštěč použít, přidejte akci s tímto spouštěčem nastavený jako aktivní spouštěč. Každá akce, která tento trigger používá, může přistupovat k eventProperties jste odeslali. V Akce polí můžete použít {{ client.<KEY_NAME> }} a získejte hodnotu <KEY_NAME>. Ve výše uvedeném příkladu Zaraz nahradí {{ client.value }} hodnotou 200. Pokud klíč obsahuje speciální znaky nebo čísla, uzavřete ho do zpětných apostrofů, například {{ client.`<KEY_NAME>` }}.
Další informace o vlastnostech, které můžete použít s zaraz.track(), přečtěte si Referenční přehled vlastností.