1# Cloudflare Zaraz
2 
3Expert guidance for Cloudflare Zaraz - server-side tag manager for loading third-party tools at the edge.
4 
5## What is Zaraz?
6 
7Zaraz offloads third-party scripts (analytics, ads, chat, marketing) to Cloudflare's edge, improving site speed, privacy, and security. Zero client-side performance impact.
8 
9**Core Concepts:**
10- **Server-side execution** - Scripts run on Cloudflare, not user's browser
11- **Single HTTP request** - All tools loaded via one endpoint
12- **Privacy-first** - Control data sent to third parties
13- **No client-side JS overhead** - Minimal browser impact
14 
15## Quick Start
16 
171. Navigate to domain > Zaraz in Cloudflare dashboard
182. Click "Start setup"
193. Add tools (Google Analytics, Facebook Pixel, etc.)
204. Configure triggers (when tools fire)
215. Add tracking code to your site:
22 
23```javascript
24// Track page view
25zaraz.track('page_view');
26 
27// Track custom event
28zaraz.track('button_click', { button_id: 'cta' });
29 
30// Set user properties
31zaraz.set('userId', 'user_123');
32```
33 
34## When to Use Zaraz
35 
36**Use Zaraz when:**
37- Adding multiple third-party tools (analytics, ads, marketing)
38- Site performance is critical (no client-side JS overhead)
39- Privacy compliance required (GDPR, CCPA)
40- Non-technical teams need to manage tools
41 
42**Use Workers directly when:**
43- Building custom server-side tracking logic
44- Need full control over data processing
45- Integrating with complex backend systems
46- Zaraz's tool library doesn't meet needs
47 
48## In This Reference
49 
50| File | Purpose | When to Read |
51|------|---------|--------------|
52| [api.md](./api.md) | Web API, zaraz object, consent methods | Implementing tracking calls |
53| [configuration.md](./configuration.md) | Dashboard setup, triggers, tools | Initial setup, adding tools |
54| [patterns.md](./patterns.md) | SPA, e-commerce, Worker integration | Best practices, common scenarios |
55| [gotchas.md](./gotchas.md) | Troubleshooting, limits, pitfalls | Debugging issues |
56 
57## Reading Order by Task
58 
59| Task | Files to Read |
60|------|---------------|
61| Add analytics to site | README → configuration.md |
62| Track custom events | README → api.md |
63| Debug tracking issues | gotchas.md |
64| SPA tracking | api.md → patterns.md (SPA section) |
65| E-commerce tracking | api.md#ecommerce → patterns.md#ecommerce |
66| Worker integration | patterns.md#worker-integration |
67| GDPR compliance | api.md#consent → configuration.md#consent |
68 
69## Decision Tree
70 
71```
72What do you need?
73 
74├─ Track events in browser → api.md
75│   ├─ Page views, clicks → zaraz.track()
76│   ├─ User properties → zaraz.set()
77│   └─ E-commerce → zaraz.ecommerce()
78│
79├─ Configure Zaraz → configuration.md
80│   ├─ Add GA4/Facebook → tools setup
81│   ├─ When tools fire → triggers
82│   └─ GDPR consent → consent purposes
83│
84├─ Integrate with Workers → patterns.md#worker-integration
85│   ├─ Enrich context → Context Enrichers
86│   └─ Inject tracking → HTML rewriting
87│
88└─ Debug issues → gotchas.md
89    ├─ Events not firing → troubleshooting
90    ├─ Consent issues → consent debugging
91    └─ Performance → debugging tools
92```
93 
94## Key Features
95 
96- **100+ Pre-built Tools** - GA4, Facebook, Google Ads, TikTok, etc.
97- **Zero Client Impact** - Runs at Cloudflare's edge, not browser
98- **Privacy Controls** - Consent management, data filtering
99- **Custom Tools** - Build Managed Components for proprietary systems
100- **Worker Integration** - Enrich context, compute dynamic values
101- **Debug Mode** - Real-time event inspection
102 
103## Reference
104 
105- [Zaraz Docs](https://developers.cloudflare.com/zaraz/)
106- [Web API](https://developers.cloudflare.com/zaraz/web-api/)
107- [Managed Components](https://developers.cloudflare.com/zaraz/advanced/load-custom-managed-component/)
108 
109---
110 
111This skill focuses exclusively on Zaraz. For Workers development, see `cloudflare-workers` skill.
112