1# Zaraz Configuration
2 
3## Dashboard Setup
4 
51. Domain → Zaraz → Start setup
62. Add tool (e.g., Google Analytics 4)
73. Enter credentials (GA4: `G-XXXXXXXXXX`)
84. Configure triggers
95. Save and Publish
10 
11## Triggers
12 
13| Type | When | Use Case |
14|------|------|----------|
15| Pageview | Page load | Track page views |
16| Click | Element clicked | Button tracking |
17| Form Submission | Form submitted | Lead capture |
18| History Change | URL changes (SPA) | React/Vue routing |
19| Variable Match | Custom condition | Conditional firing |
20 
21### History Change (SPA)
22 
23```
24Type: History Change
25Event: pageview
26```
27 
28Fires on `pushState`, `replaceState`, hash changes. **No manual tracking needed.**
29 
30### Click Trigger
31 
32```
33Type: Click
34CSS Selector: .buy-button
35Event: purchase_intent
36Properties:
37  button_text: {{system.clickElement.text}}
38```
39 
40## Tool Configuration
41 
42**GA4:**
43```
44Measurement ID: G-XXXXXXXXXX
45Events: page_view, purchase, user_engagement
46```
47 
48**Facebook Pixel:**
49```
50Pixel ID: 1234567890123456
51Events: PageView, Purchase, AddToCart
52```
53 
54**Google Ads:**
55```
56Conversion ID: AW-XXXXXXXXX
57Conversion Label: YYYYYYYYYY
58```
59 
60## Consent Management
61 
621. Settings → Consent → Create purposes (analytics, marketing)
632. Map tools to purposes
643. Set behavior: "Do not load until consent granted"
65 
66**Programmatic consent:**
67```javascript
68zaraz.consent.setAll({ analytics: true, marketing: true });
69```
70 
71## Privacy Features
72 
73| Feature | Default |
74|---------|---------|
75| IP Anonymization | Enabled |
76| Cookie Control | Via consent purposes |
77| GDPR/CCPA | Consent modal |
78 
79## Testing
80 
811. **Preview Mode** - test without publishing
822. **Debug Mode** - `zaraz.debug = true`
833. **Network tab** - filter "zaraz"
84 
85## Limits
86 
87| Resource | Limit |
88|----------|-------|
89| Event properties | 100KB |
90| Consent purposes | 20 |
91