Option A: Install Directly on Website (Recommended)
- Copy the script from dashboard.
- Paste it before
</head>in your site template. - Deploy.
- Verify browser network calls to
/collect.
Option B: Install Using Google Tag Manager (GTM)
- Open GTM container.
- Create a new
Custom HTMLtag. - Paste the same Scanova script snippet.
- Trigger:
All Pages. - Save and publish container.
GTM Best Practices
- Ensure only one Scanova script instance is loaded.
- Do not duplicate direct + GTM install on same page.
- Keep script in head-equivalent loading path for earliest capture.
- If your site is SPA, keep loader persistent and avoid repeated
init.
SPA Frameworks
- Add loader snippet in your root HTML (for example
index.html). - Keep one
scanova('init', ...)call per page load lifecycle.
Send Custom Events from Frontend Code
Afterscanova('init', ...), send custom events any time:
Example: CTA click
Example: Signup completed
Metadata Guidelines
- Send compact JSON metadata.
- Do not send raw emails/PII in browser metadata.
- Use stable event names (snake_case recommended).
- For conversions from backend systems, prefer server events.
Optional Element Naming
Usedata-scnv-name on links/buttons/forms for cleaner click labels in reports.
Example:
Next
- Browser verification: Verify Client-Side Events
- Server-side events: Generate API Key