Initial commit

This commit is contained in:
Zhongwei Li
2025-11-29 18:32:45 +08:00
commit c02dafae1d
41 changed files with 17283 additions and 0 deletions

View File

@@ -0,0 +1,271 @@
---
name: gtm-triggers
description: Expert guidance for configuring Google Tag Manager triggers including page view triggers, click triggers (all elements, just links), form submission triggers, scroll depth tracking, element visibility triggers, video triggers (YouTube), custom event triggers, timer triggers, history change triggers for SPAs, JavaScript error triggers, trigger conditions, RegEx patterns, trigger exceptions, auto-event variables, and combining multiple trigger conditions. Use when creating triggers, setting up click tracking, configuring form submit tracking, implementing scroll tracking, working with custom events, debugging trigger conditions, using RegEx in triggers, setting trigger exceptions, or troubleshooting why triggers aren't firing.
---
# GTM Triggers Configuration
## Overview
Expert guidance for configuring all types of triggers in Google Tag Manager that control when tags fire, from simple page views to complex conditional triggers with RegEx patterns.
## When to Use This Skill
Invoke this skill when:
- Creating or configuring GTM triggers
- Setting up page view or DOM-based triggers
- Implementing click tracking (buttons, links, elements)
- Configuring form submission tracking
- Setting up scroll depth or element visibility triggers
- Working with custom event triggers from data layer
- Creating timer or history change triggers
- Using RegEx patterns in trigger conditions
- Setting up trigger exceptions (when NOT to fire)
- Combining multiple conditions in triggers
- Debugging why triggers aren't firing
- Optimizing trigger performance
## Trigger Types
### Pageview Triggers
- **Page View** - Fires on every page load (including virtual pages)
- **DOM Ready** - Fires when DOM is ready (before images load)
- **Window Loaded** - Fires when page fully loads (including images)
Use cases:
- Page View: Most common for tracking page views
- DOM Ready: Fire tags before full page load for performance
- Window Loaded: When you need all page resources loaded
### Click Triggers
- **All Elements** - Track clicks on any element (buttons, divs, images, etc.)
- **Just Links** - Track clicks only on `<a>` tags
Auto-Event Variables available:
- Click Element, Click Classes, Click ID
- Click URL, Click Text
- Click Target
### Form Triggers
- **Form Submission** - Fires when form is submitted
Auto-Event Variables available:
- Form Element, Form Classes, Form ID
- Form Target, Form URL
- Form Text
### User Engagement Triggers
- **Scroll Depth** - Track when users scroll to specific depths
- Vertical Scroll Depths: 25%, 50%, 75%, 90%, etc.
- Horizontal scrolling also supported
- **Element Visibility** - Fire when element becomes visible
- Minimum visibility percentage
- On-screen duration requirements
- **YouTube Video** - Track video plays, pauses, progress
- Requires YouTube videos to have enablejsapi=1
### Custom Event Triggers
- **Custom Event** - Fire when specific data layer event occurs
- Event name must match `dataLayer.push({'event': 'event_name'})`
- Most flexible trigger type for custom implementations
### Timer Triggers
- **Timer** - Fire repeatedly at intervals
- Set interval (milliseconds)
- Set limit on number of times to fire
- Use for tracking time on page, polling, etc.
### History Triggers
- **History Change** - Fire on URL changes without page reload
- Essential for Single Page Applications (SPAs)
- Tracks pushState, replaceState, and hash changes
### Other Triggers
- **JavaScript Error** - Fire when JavaScript errors occur
- **Trigger Group** - Combine multiple triggers with AND logic
- **Window Resize** - Fire when browser window resizes (custom via Custom HTML)
## Trigger Configuration
### Basic Configuration
1. **Trigger Type** - Select the type of trigger
2. **Trigger Name** - Use clear naming convention
3. **Trigger Conditions** - Define when to fire
4. **Trigger Exceptions** - Define when NOT to fire
### Trigger Conditions (Filters)
Combine multiple conditions with AND/OR logic:
**Condition Structure:**
- Variable (e.g., Click URL, Page Path)
- Operator (equals, contains, matches RegEx, etc.)
- Value (static text or variable)
**Common Operators:**
- `equals` - Exact match
- `contains` - Substring match
- `matches RegEx` - Pattern matching
- `starts with` - Prefix match
- `ends with` - Suffix match
- `less than` / `greater than` - Numeric comparison
- `CSS selector` - Match element with selector
**Example Conditions:**
```
Click URL contains /checkout
Page Path equals /thank-you
Click Classes matches RegEx ^btn-primary$
Form ID equals contact-form
```
### Trigger Exceptions
Prevent trigger from firing in specific cases:
- Same format as conditions
- Useful for excluding specific pages, elements, or scenarios
**Example:**
Trigger on all clicks EXCEPT:
- Click URL contains /admin
- Click Classes contains no-track
### RegEx in Triggers
Use Regular Expressions for complex pattern matching:
- `.*` - Match any characters
- `^` - Start of string
- `$` - End of string
- `|` - OR operator
- `[a-z]` - Character range
- `\d` - Any digit
**Examples:**
```
Page Path matches RegEx: ^/(products|services)/.*
Click URL matches RegEx: \.(pdf|docx?)$
Custom Event equals: purchase|checkout|lead
```
See references/google-rew-regular-expressions-syntax.txt for complete RegEx syntax.
## Common Workflows
### Create Click Trigger for Specific Button
1. Create new trigger → Click - All Elements
2. Set condition: Click Classes contains "cta-button"
3. Or use: Click ID equals "signup-btn"
4. Test in Preview mode by clicking button
5. Verify in Tags Fired section
### Set Up Form Submission Trigger
1. Create new trigger → Form Submission
2. Set condition: Form ID equals "contact-form"
3. Or use: Page Path equals /contact
4. Set exception if needed (e.g., exclude test forms)
5. Test by submitting form in Preview mode
### Configure Scroll Depth Trigger
1. Create new trigger → Scroll Depth
2. Select Vertical Scroll Depths
3. Choose percentages: 25, 50, 75, 90
4. Set Page Path condition if needed (specific pages only)
5. Test by scrolling on page
### Create Custom Event Trigger
1. Ensure data layer push is implemented: `dataLayer.push({'event': 'add_to_cart'})`
2. Create new trigger → Custom Event
3. Set Event name: add_to_cart
4. Add conditions as needed (e.g., fire only on specific pages)
5. Test in Preview mode, check Data Layer tab
### Set Up History Change Trigger for SPA
1. Create new trigger → History Change
2. Add condition: Page Path matches RegEx (if needed)
3. Test by navigating within SPA
4. Verify trigger fires on URL changes without page reload
## Best Practices
### Trigger Naming
Use consistent format: `[Event Type] - [Description]`
Examples:
- `Click - CTA Button`
- `Page View - Homepage`
- `Form Submit - Contact Form`
- `Custom Event - Add to Cart`
### Trigger Optimization
- Use specific conditions to avoid over-firing
- Set exceptions to exclude unwanted scenarios
- Test thoroughly in Preview mode
- Use built-in variables when possible (faster than custom JS)
- Avoid overly complex RegEx patterns
### Common Pitfalls
- **Click triggers not firing**: Element might be removed before click registers
- Solution: Use "Wait for Tags" or increase timeout
- **Form triggers not firing**: Form submits via AJAX without traditional submit
- Solution: Use custom event trigger instead
- **History triggers over-firing**: Fires on every URL parameter change
- Solution: Add specific Page Path conditions
### Auto-Event Variables
Enable relevant built-in variables for triggers:
- Click triggers: Click Element, Click Classes, Click ID, Click URL, Click Text
- Form triggers: Form Element, Form Classes, Form ID, Form URL, Form Text
- Scroll triggers: Scroll Depth Threshold, Scroll Depth Units
- Video triggers: Video Provider, Video Status, Video URL, Video Title
## References
- **references/triggers.md** - Comprehensive trigger configuration guide with all trigger types, conditions, and advanced patterns
- **references/google-rew-regular-expressions-syntax.txt** - RegEx syntax for trigger conditions
Search reference files for specific topics:
```bash
grep -r "Custom Event" references/
grep -r "scroll depth" references/
grep -r "RegEx" references/
```
## Integration with Other Skills
- **gtm-tags** - Configure tags that use these triggers
- **gtm-variables** - Use variables in trigger conditions
- **gtm-debugging** - Debug triggers that aren't firing
- **gtm-datalayer** - Implement custom events for custom event triggers
- **gtm-setup** - Container setup and built-in variables
- **gtm-best-practices** - Trigger naming conventions and optimization
## Quick Reference
### Trigger Type Selection Guide
- **Simple page tracking**: Page View
- **Button/link clicks**: Click triggers
- **Form submissions**: Form Submission
- **User engagement**: Scroll Depth, Element Visibility
- **Custom implementation**: Custom Event
- **SPA navigation**: History Change
- **Polling/time-based**: Timer
- **Error monitoring**: JavaScript Error
### Common Condition Patterns
```
// Homepage only
Page Path equals /
// All product pages
Page Path starts with /products/
// PDF downloads
Click URL ends with .pdf
// Multiple pages with RegEx
Page Path matches RegEx ^/(about|contact|services)$
// Exclude admin pages
Page Path does not contain /admin/
```
### Debugging Checklist
- [ ] Trigger type is correct for event
- [ ] Trigger conditions are specific enough
- [ ] Built-in variables are enabled
- [ ] No conflicting trigger exceptions
- [ ] Testing in Preview mode
- [ ] Checking Variables tab for condition values

View File

@@ -0,0 +1,462 @@
RE2 regular expression syntax reference
-------------------------­-------­-----
Single characters:
. any character, possibly including newline (s=true)
[xyz] character class
[^xyz] negated character class
\d Perl character class
\D negated Perl character class
[[:alpha:]] ASCII character class
[[:^alpha:]] negated ASCII character class
\pN Unicode character class (one-letter name)
\p{Greek} Unicode character class
\PN negated Unicode character class (one-letter name)
\P{Greek} negated Unicode character class
Composites:
xy «x» followed by «y»
x|y «x» or «y» (prefer «x»)
Repetitions:
x* zero or more «x», prefer more
x+ one or more «x», prefer more
x? zero or one «x», prefer one
x{n,m} «n» or «n»+1 or ... or «m» «x», prefer more
x{n,} «n» or more «x», prefer more
x{n} exactly «n» «x»
x*? zero or more «x», prefer fewer
x+? one or more «x», prefer fewer
x?? zero or one «x», prefer zero
x{n,m}? «n» or «n»+1 or ... or «m» «x», prefer fewer
x{n,}? «n» or more «x», prefer fewer
x{n}? exactly «n» «x»
x{} (== x*) NOT SUPPORTED vim
x{-} (== x*?) NOT SUPPORTED vim
x{-n} (== x{n}?) NOT SUPPORTED vim
x= (== x?) NOT SUPPORTED vim
Implementation restriction: The counting forms «x{n,m}», «x{n,}», and «x{n}»
reject forms that create a minimum or maximum repetition count above 1000.
Unlimited repetitions are not subject to this restriction.
Possessive repetitions:
x*+ zero or more «x», possessive NOT SUPPORTED
x++ one or more «x», possessive NOT SUPPORTED
x?+ zero or one «x», possessive NOT SUPPORTED
x{n,m}+ «n» or ... or «m» «x», possessive NOT SUPPORTED
x{n,}+ «n» or more «x», possessive NOT SUPPORTED
x{n}+ exactly «n» «x», possessive NOT SUPPORTED
Grouping:
(re) numbered capturing group (submatch)
(?P<name>re) named & numbered capturing group (submatch)
(?<name>re) named & numbered capturing group (submatch)
(?'name're) named & numbered capturing group (submatch) NOT SUPPORTED
(?:re) non-capturing group
(?flags) set flags within current group; non-capturing
(?flags:re) set flags during re; non-capturing
(?#text) comment NOT SUPPORTED
(?|x|y|z) branch numbering reset NOT SUPPORTED
(?>re) possessive match of «re» NOT SUPPORTED
re@> possessive match of «re» NOT SUPPORTED vim
%(re) non-capturing group NOT SUPPORTED vim
Flags:
i case-insensitive (default false)
m multi-line mode: «^» and «$» match begin/end line in addition to begin/end text (default false)
s let «.» match «\n» (default false)
U ungreedy: swap meaning of «x*» and «x*?», «x+» and «x+?», etc (default false)
Flag syntax is «xyz» (set) or «-xyz» (clear) or «xy-z» (set «xy», clear «z»).
Empty strings:
^ at beginning of text or line («m»=true)
$ at end of text (like «\z» not «\Z») or line («m»=true)
\A at beginning of text
\b at ASCII word boundary («\w» on one side and «\W», «\A», or «\z» on the other)
\B not at ASCII word boundary
\G at beginning of subtext being searched NOT SUPPORTED pcre
\G at end of last match NOT SUPPORTED perl
\Z at end of text, or before newline at end of text NOT SUPPORTED
\z at end of text
(?=re) before text matching «re» NOT SUPPORTED
(?!re) before text not matching «re» NOT SUPPORTED
(?<=re) after text matching «re» NOT SUPPORTED
(?<!re) after text not matching «re» NOT SUPPORTED
re& before text matching «re» NOT SUPPORTED vim
re@= before text matching «re» NOT SUPPORTED vim
re@! before text not matching «re» NOT SUPPORTED vim
re@<= after text matching «re» NOT SUPPORTED vim
re@<! after text not matching «re» NOT SUPPORTED vim
\zs sets start of match (= \K) NOT SUPPORTED vim
\ze sets end of match NOT SUPPORTED vim
\%^ beginning of file NOT SUPPORTED vim
\%$ end of file NOT SUPPORTED vim
\%V on screen NOT SUPPORTED vim
\%# cursor position NOT SUPPORTED vim
\%'m mark «m» position NOT SUPPORTED vim
\%23l in line 23 NOT SUPPORTED vim
\%23c in column 23 NOT SUPPORTED vim
\%23v in virtual column 23 NOT SUPPORTED vim
Escape sequences:
\a bell (== \007)
\f form feed (== \014)
\t horizontal tab (== \011)
\n newline (== \012)
\r carriage return (== \015)
\v vertical tab character (== \013)
\* literal «*», for any punctuation character «*»
\123 octal character code (up to three digits)
\x7F hex character code (exactly two digits)
\x{10FFFF} hex character code
\C match a single byte even in UTF-8 mode
\Q...\E literal text «...» even if «...» has punctuation
\1 backreference NOT SUPPORTED
\b backspace NOT SUPPORTED (use «\010»)
\cK control char ^K NOT SUPPORTED (use «\001» etc)
\e escape NOT SUPPORTED (use «\033»)
\g1 backreference NOT SUPPORTED
\g{1} backreference NOT SUPPORTED
\g{+1} backreference NOT SUPPORTED
\g{-1} backreference NOT SUPPORTED
\g{name} named backreference NOT SUPPORTED
\g<name> subroutine call NOT SUPPORTED
\g'name' subroutine call NOT SUPPORTED
\k<name> named backreference NOT SUPPORTED
\k'name' named backreference NOT SUPPORTED
\lX lowercase «X» NOT SUPPORTED
\ux uppercase «x» NOT SUPPORTED
\L...\E lowercase text «...» NOT SUPPORTED
\K reset beginning of «$0» NOT SUPPORTED
\N{name} named Unicode character NOT SUPPORTED
\R line break NOT SUPPORTED
\U...\E upper case text «...» NOT SUPPORTED
\X extended Unicode sequence NOT SUPPORTED
\%d123 decimal character 123 NOT SUPPORTED vim
\%xFF hex character FF NOT SUPPORTED vim
\%o123 octal character 123 NOT SUPPORTED vim
\%u1234 Unicode character 0x1234 NOT SUPPORTED vim
\%U12345678 Unicode character 0x12345678 NOT SUPPORTED vim
Character class elements:
x single character
A-Z character range (inclusive)
\d Perl character class
[:foo:] ASCII character class «foo»
\p{Foo} Unicode character class «Foo»
\pF Unicode character class «F» (one-letter name)
Named character classes as character class elements:
[\d] digits (== \d)
[^\d] not digits (== \D)
[\D] not digits (== \D)
[^\D] not not digits (== \d)
[[:name:]] named ASCII class inside character class (== [:name:])
[^[:name:]] named ASCII class inside negated character class (== [:^name:])
[\p{Name}] named Unicode property inside character class (== \p{Name})
[^\p{Name}] named Unicode property inside negated character class (== \P{Name})
Perl character classes (all ASCII-only):
\d digits (== [0-9])
\D not digits (== [^0-9])
\s whitespace (== [\t\n\f\r ])
\S not whitespace (== [^\t\n\f\r ])
\w word characters (== [0-9A-Za-z_])
\W not word characters (== [^0-9A-Za-z_])
\h horizontal space NOT SUPPORTED
\H not horizontal space NOT SUPPORTED
\v vertical space NOT SUPPORTED
\V not vertical space NOT SUPPORTED
ASCII character classes:
[[:alnum:]] alphanumeric (== [0-9A-Za-z])
[[:alpha:]] alphabetic (== [A-Za-z])
[[:ascii:]] ASCII (== [\x00-\x7F])
[[:blank:]] blank (== [\t ])
[[:cntrl:]] control (== [\x00-\x1F\x7F])
[[:digit:]] digits (== [0-9])
[[:graph:]] graphical (== [!-~] == [A-Za-z0-9!"#$%&'()*+,\-./:;<=>?@[\\\]^_`{|}~])
[[:lower:]] lower case (== [a-z])
[[:print:]] printable (== [ -~] == [ [:graph:]])
[[:punct:]] punctuation (== [!-/:-@[-`{-~])
[[:space:]] whitespace (== [\t\n\v\f\r ])
[[:upper:]] upper case (== [A-Z])
[[:word:]] word characters (== [0-9A-Za-z_])
[[:xdigit:]] hex digit (== [0-9A-Fa-f])
Unicode character class names--general category:
C other
Cc control
Cf format
Cn unassigned code points NOT SUPPORTED
Co private use
Cs surrogate
L letter
LC cased letter NOT SUPPORTED
L& cased letter NOT SUPPORTED
Ll lowercase letter
Lm modifier letter
Lo other letter
Lt titlecase letter
Lu uppercase letter
M mark
Mc spacing mark
Me enclosing mark
Mn non-spacing mark
N number
Nd decimal number
Nl letter number
No other number
P punctuation
Pc connector punctuation
Pd dash punctuation
Pe close punctuation
Pf final punctuation
Pi initial punctuation
Po other punctuation
Ps open punctuation
S symbol
Sc currency symbol
Sk modifier symbol
Sm math symbol
So other symbol
Z separator
Zl line separator
Zp paragraph separator
Zs space separator
Unicode character class names--scripts:
Adlam
Ahom
Anatolian_Hieroglyphs
Arabic
Armenian
Avestan
Balinese
Bamum
Bassa_Vah
Batak
Bengali
Bhaiksuki
Bopomofo
Brahmi
Braille
Buginese
Buhid
Canadian_Aboriginal
Carian
Caucasian_Albanian
Chakma
Cham
Cherokee
Chorasmian
Common
Coptic
Cuneiform
Cypriot
Cypro_Minoan
Cyrillic
Deseret
Devanagari
Dives_Akuru
Dogra
Duployan
Egyptian_Hieroglyphs
Elbasan
Elymaic
Ethiopic
Georgian
Glagolitic
Gothic
Grantha
Greek
Gujarati
Gunjala_Gondi
Gurmukhi
Han
Hangul
Hanifi_Rohingya
Hanunoo
Hatran
Hebrew
Hiragana
Imperial_Aramaic
Inherited
Inscriptional_Pahlavi
Inscriptional_Parthian
Javanese
Kaithi
Kannada
Katakana
Kawi
Kayah_Li
Kharoshthi
Khitan_Small_Script
Khmer
Khojki
Khudawadi
Lao
Latin
Lepcha
Limbu
Linear_A
Linear_B
Lisu
Lycian
Lydian
Mahajani
Makasar
Malayalam
Mandaic
Manichaean
Marchen
Masaram_Gondi
Medefaidrin
Meetei_Mayek
Mende_Kikakui
Meroitic_Cursive
Meroitic_Hieroglyphs
Miao
Modi
Mongolian
Mro
Multani
Myanmar
Nabataean
Nag_Mundari
Nandinagari
New_Tai_Lue
Newa
Nko
Nushu
Nyiakeng_Puachue_Hmong
Ogham
Ol_Chiki
Old_Hungarian
Old_Italic
Old_North_Arabian
Old_Permic
Old_Persian
Old_Sogdian
Old_South_Arabian
Old_Turkic
Old_Uyghur
Oriya
Osage
Osmanya
Pahawh_Hmong
Palmyrene
Pau_Cin_Hau
Phags_Pa
Phoenician
Psalter_Pahlavi
Rejang
Runic
Samaritan
Saurashtra
Sharada
Shavian
Siddham
SignWriting
Sinhala
Sogdian
Sora_Sompeng
Soyombo
Sundanese
Syloti_Nagri
Syriac
Tagalog
Tagbanwa
Tai_Le
Tai_Tham
Tai_Viet
Takri
Tamil
Tangsa
Tangut
Telugu
Thaana
Thai
Tibetan
Tifinagh
Tirhuta
Toto
Ugaritic
Vai
Vithkuqi
Wancho
Warang_Citi
Yezidi
Yi
Zanabazar_Square
Vim character classes:
\i identifier character NOT SUPPORTED vim
\I «\i» except digits NOT SUPPORTED vim
\k keyword character NOT SUPPORTED vim
\K «\k» except digits NOT SUPPORTED vim
\f file name character NOT SUPPORTED vim
\F «\f» except digits NOT SUPPORTED vim
\p printable character NOT SUPPORTED vim
\P «\p» except digits NOT SUPPORTED vim
\s whitespace character (== [ \t]) NOT SUPPORTED vim
\S non-white space character (== [^ \t]) NOT SUPPORTED vim
\d digits (== [0-9]) vim
\D not «\d» vim
\x hex digits (== [0-9A-Fa-f]) NOT SUPPORTED vim
\X not «\x» NOT SUPPORTED vim
\o octal digits (== [0-7]) NOT SUPPORTED vim
\O not «\o» NOT SUPPORTED vim
\w word character vim
\W not «\w» vim
\h head of word character NOT SUPPORTED vim
\H not «\h» NOT SUPPORTED vim
\a alphabetic NOT SUPPORTED vim
\A not «\a» NOT SUPPORTED vim
\l lowercase NOT SUPPORTED vim
\L not lowercase NOT SUPPORTED vim
\u uppercase NOT SUPPORTED vim
\U not uppercase NOT SUPPORTED vim
\_x «\x» plus newline, for any «x» NOT SUPPORTED vim
Vim flags:
\c ignore case NOT SUPPORTED vim
\C match case NOT SUPPORTED vim
\m magic NOT SUPPORTED vim
\M nomagic NOT SUPPORTED vim
\v verymagic NOT SUPPORTED vim
\V verynomagic NOT SUPPORTED vim
\Z ignore differences in Unicode combining characters NOT SUPPORTED vim
Magic:
(?{code}) arbitrary Perl code NOT SUPPORTED perl
(??{code}) postponed arbitrary Perl code NOT SUPPORTED perl
(?n) recursive call to regexp capturing group «n» NOT SUPPORTED
(?+n) recursive call to relative group «+n» NOT SUPPORTED
(?-n) recursive call to relative group «-n» NOT SUPPORTED
(?C) PCRE callout NOT SUPPORTED pcre
(?R) recursive call to entire regexp (== (?0)) NOT SUPPORTED
(?&name) recursive call to named group NOT SUPPORTED
(?P=name) named backreference NOT SUPPORTED
(?P>name) recursive call to named group NOT SUPPORTED
(?(cond)true|false) conditional branch NOT SUPPORTED
(?(cond)true) conditional branch NOT SUPPORTED
(*ACCEPT) make regexps more like Prolog NOT SUPPORTED
(*COMMIT) NOT SUPPORTED
(*F) NOT SUPPORTED
(*FAIL) NOT SUPPORTED
(*MARK) NOT SUPPORTED
(*PRUNE) NOT SUPPORTED
(*SKIP) NOT SUPPORTED
(*THEN) NOT SUPPORTED
(*ANY) set newline convention NOT SUPPORTED
(*ANYCRLF) NOT SUPPORTED
(*CR) NOT SUPPORTED
(*CRLF) NOT SUPPORTED
(*LF) NOT SUPPORTED
(*BSR_ANYCRLF) set \R convention NOT SUPPORTED pcre
(*BSR_UNICODE) NOT SUPPORTED pcre

File diff suppressed because it is too large Load Diff