1# Configuration
2 
3## Setup Methods
4 
5### Proxied Sites (Automatic)
6 
7Dashboard → Web Analytics → Add site → Select hostname → Done
8 
9| Injection Option | Description |
10|------------------|-------------|
11| Enable | Auto-inject for all visitors (default) |
12| Enable, excluding EU | No injection for EU (GDPR) |
13| Enable with manual snippet | You add beacon manually |
14| Disable | Pause tracking |
15 
16**Fails if response has:** `Cache-Control: public, no-transform`
17 
18**CSP required:**
19```
20script-src https://static.cloudflareinsights.com https://cloudflareinsights.com;
21```
22 
23### Non-Proxied Sites (Manual)
24 
25Dashboard → Web Analytics → Add site → Enter hostname → Copy snippet
26 
27```html
28<script defer src='https://static.cloudflareinsights.com/beacon.min.js' 
29        data-cf-beacon='{"token": "YOUR_TOKEN", "spa": true}'></script>
30```
31 
32**Limits:** 10 non-proxied sites per account
33 
34## SPA Mode
35 
36**Enable `spa: true` for:** React Router, Next.js, Vue Router, Nuxt, SvelteKit, Angular
37 
38**Keep `spa: false` for:** Traditional multi-page apps, static sites, WordPress
39 
40**Hash routing (`#/path`) NOT supported** - use History API routing.
41 
42## Token Management
43 
44- Found in: Dashboard → Web Analytics → Manage site
45- **Not secrets** - domain-locked, safe to expose in HTML
46- Each site gets unique token
47 
48## Environment Config
49 
50```typescript
51// Only load in production
52if (process.env.NODE_ENV === 'production') {
53  // Load beacon
54}
55```
56 
57Or use environment-specific tokens via env vars.
58 
59## Verify Installation
60 
611. DevTools Network → filter `cloudflareinsights` → see `beacon.min.js` + data request
622. No CSP/CORS errors in console
633. Dashboard shows pageviews after 5-10 min delay
64 
65## Rules (Plan-dependent)
66 
67Configure in dashboard for:
68- **Sample rate** - reduce collection % for high-traffic
69- **Path-based** - different behavior per route
70- **Host-based** - separate tracking per domain
71 
72## Data Retention
73 
74- 6 months rolling window
75- 1-hour bucket granularity
76- No raw export, dashboard only
77