INTEGRITY Dokumentace

Triggery a pravidla

Triggery definují podmínky, za kterých nástroj spustí akci. Ve většině případů budete vytvářet triggery pro konkrétní události na webu, které jsou důležité pro vaše podnikání. Trigger může vycházet z události, k níž na webu došlo, například po kliknutí na tlačítko nebo po načtení konkrétní stránky.

Tyto webové události lze do Cloudflare Zaraz předat několika způsoby. Můžete použít Track metodu Web API nebo dataLayer volání. Pokud nechcete psát kód pro sledování událostí na svém webu, můžete místo toho nastavit spouštěče, které naslouchají událostem na straně prohlížeče, pomocí různých typů pravidel, jako jsou posluchače kliknutí nebo odesílání formulářů.

Typy pravidel

Přesná skladba triggeru se bude lišit v závislosti na typu zvoleného pravidla.

Pravidlo shody

Zaraz porovná proměnnou, kterou zadáte v Název proměnné textem pod Řetězec shody. Úplný seznam podporovaných proměnných najdete v Referenční přehled vlastností.

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

Pokud vytvoříte spouštěč s pravidly shody, která využívají proměnné z kategorií Page Properties, Cookies, Device Properties nebo Miscellaneous, budete si často chtít přidat druhé pravidlo, které odpovídá Pageview. Jinak bude váš trigger platit i pro všechny ostatní události na této stránce. Viz Vytvoření spouštěče a zjistěte, jak k triggeru přidat více než jednu podmínku.

Příklad triggeru: Všechny stránky pod /blog

Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody URL pathname Začíná na /blog
Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody Název události Rovná se Pageview

Příklad triggeru: Všichni přihlášení uživatelé

Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody Cookie: název: isLoggedIn Rovná se true
Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody Název události Rovná se Pageview

Viz Referenční přehled vlastností kde najdete další informace o proměnných, které můžete použít u typu Match rule.

Click listener

Sleduje kliknutí na webové stránce. Click listenery můžete nastavit pomocí CSS selektorů nebo výrazů XPath. Čekat na akce (v milisekundách) říká Zaraz, aby po zadanou dobu zabránil změnám na stránce. Díky tomu stihnou všechny požadavky vyvolané posluchačem kliknutí dosáhnout svého cíle.

Příklad triggeru pro CSS selektor:

Typ pravidla Typ Selektor Čekat na akce
Click listener CSS #my-button 500

Výkon webové stránky zlepšíte tak, že click listener omezíte na konkrétní URL adresu kombinací s pravidlem Match. Chcete-li například sledovat kliknutí na tlačítko na konkrétní stránce, nastavte v triggeru následující pravidla:

Typ pravidla Typ Selektor Čekat na akce
Click listener CSS #myButton 500
Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody URL pathname Rovná se /my-page-path

Pokud potřebujete sledovat odkaz prvku pomocí CSS selektorů, například u klikatelného tlačítka, musíte vytvořit posluchač pro href atribut <a> značka:

Typ pravidla Typ Selektor Čekat na akce
Click listener CSS a[href$='/#my-css-selector'] 500

Viz Vytvoření spouštěče a zjistěte, jak k triggeru přidat více než jedno pravidlo.


Příklad triggeru pro XPath:

Typ pravidla Typ Selektor Čekat na akce
Click listener XPath /html/body//*[contains(text(), 'Add To Cart')] 500

Element Visibility

Spustí akci, jakmile se CSS selektor zobrazí na obrazovce.

Typ pravidla CSS Selector
Element Visibility #my-id

Scroll depth

Spustí akci, jakmile uživatel posune stránku o předem stanovený počet pixelů. Může jít o pevný počet pixelů nebo o procento obrazovky.

Příklad s pixely

Typ pravidla CSS Selector
Scroll Depth 100px

Příklad s procentem obrazovky

Typ pravidla CSS Selector
Scroll Depth 45%

Form submission

Sleduje odesílání formulářů pomocí CSS selektorů. Vyberte Ověření přepínač, aby se trigger spustil pouze tehdy, když formulář neobsahuje žádné chyby validace.

Příklad triggeru:

Typ pravidla CSS Selector Ověření
Form submission #my-form Zapnout nebo vypnout

Výkon webové stránky zlepšíte tak, že trigger Form submission omezíte na konkrétní URL adresu kombinací s pravidlem Match. Chcete-li například sledovat formulář na konkrétní stránce, nastavte v triggeru následující pravidla:

Typ pravidla CSS Selector Ověření
Form submission #my-form Zapnout nebo vypnout
Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody URL pathname Rovná se /my-page-path

Viz Vytvoření spouštěče a zjistěte, jak k triggeru přidat více než jednu podmínku.

Timer

Nastavte časovač, který aktivuje trigger po každých Interval. Nastavte interval v milisekundách. V Limit určete počet opakování intervalu, který způsobí spuštění triggeru. Pokud limit neurčíte, časovač se bude opakovat, dokud bude stránka zobrazena.

Příklad triggeru:

Typ pravidla Interval Limit
Timer 5000 1

Výše uvedený Timer se aktivuje jednou, a to po pěti sekundách. Chcete-li zlepšit výkon webové stránky, můžete trigger Timer omezit na konkrétní URL adresu jeho zkombinováním s pravidlem Match. Chcete-li například nastavit časovač na konkrétní stránce, můžete v rámci triggeru nastavit následující pravidla:

Typ pravidla Interval Limit
Timer 5000 1
Typ pravidla Název proměnné Operace shody Řetězec shody
Pravidlo shody URL pathname Rovná se /my-page-path

Viz Vytvoření spouštěče a zjistěte, jak k triggeru přidat více než jednu podmínku.