1# Zaraz Gotchas
2 
3## Events Not Firing
4 
5**Check:**
61. Tool enabled in dashboard (green dot)
72. Trigger conditions met
83. Consent granted for tool's purpose
94. Tool credentials correct (GA4: `G-XXXXXXXXXX`, FB: numeric only)
10 
11**Debug:**
12```javascript
13zaraz.debug = true;
14console.log('Tools:', zaraz.tools);
15console.log('Consent:', zaraz.consent.getAll());
16```
17 
18## Consent Issues
19 
20**Modal not showing:**
21```javascript
22// Clear consent cookie
23document.cookie = 'zaraz-consent=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;';
24location.reload();
25```
26 
27**Tools firing before consent:** Map tool to consent purpose with "Do not load until consent granted".
28 
29## SPA Tracking
30 
31**Route changes not tracked:**
321. Configure History Change trigger in dashboard
332. Hash routing (`#/path`) requires manual tracking:
34```javascript
35window.addEventListener('hashchange', () => {
36  zaraz.track('pageview', { page_path: location.pathname + location.hash });
37});
38```
39 
40**React fix:**
41```javascript
42const location = useLocation();
43useEffect(() => {
44  zaraz.track('pageview', { page_path: location.pathname });
45}, [location]); // Include dependency
46```
47 
48## Performance
49 
50**Slow page load:**
51- Audit tool count (50+ degrades performance)
52- Disable blocking triggers unless required
53- Reduce event payload size (<100KB)
54 
55## Tool-Specific Issues
56 
57| Tool | Issue | Fix |
58|------|-------|-----|
59| GA4 | Events not in real-time | Wait 5-10 min, use DebugView |
60| Facebook | Invalid Pixel ID | Use numeric only (no `fbpx_` prefix) |
61| Google Ads | Conversions not attributed | Include `send_to: 'AW-XXX/LABEL'` |
62 
63## Data Layer
64 
65- Properties persist per page only - set on each page load
66- Nested access: `{{client.__zarazTrack.user.plan}}`
67 
68## Limits
69 
70| Resource | Limit |
71|----------|-------|
72| Request size | 100KB |
73| Consent purposes | 20 |
74| API rate | 1000 req/sec |
75 
76## When NOT to Use Zaraz
77 
78- Server-to-server tracking (use Workers)
79- Real-time bidirectional communication
80- Binary data transmission
81- Authentication flows
82