Integrations
Installing the Frantiko Snippet: A Complete Setup Guide
· 9 min read
A step-by-step guide to installing the Frantiko tracking snippet, configuring event tracking, and activating Session Insights from day one.
The Frantiko tracking snippet is the first-party behavioral data layer that powers Session Insights. It captures interaction-level signals — rage clicks, dead clicks, drop-offs, and session timings — and surfaces them as actionable insights in your Frantiko dashboard. This guide walks through the complete installation and configuration process.
Step 1: Get your project token
In Frantiko, go to Dashboard > Integrations > Frantiko Snippet. Your project token is shown there. Copy it — you will need it in the next step.
Step 2: Install the snippet
Add the following script to the <head> of your product, replacing YOUR_PROJECT_TOKEN with the token you copied. If you are using Next.js, add it to your root layout.tsx using the next/script component with strategy="afterInteractive":
The snippet is a single async JavaScript file. It adds less than 8KB to your bundle and loads asynchronously so it does not block your main thread or affect your Core Web Vitals.
Step 3: Tag features for grouped reporting (optional)
To see behavioral signals grouped by product feature, add a data-frantiko-feature attribute to the root element of each major UI section. Session Insights will bucket rage clicks and drop-offs by feature automatically:
<div data-frantiko-feature="onboarding-flow"> ... </div>
Step 4: Identify signed-in users (optional)
By default, the snippet tracks anonymous sessions. To associate sessions with specific users — required for per-user session history — call frantiko("identify") after sign-in with the user's ID and email. Frantiko stores only the ID and email; no PII beyond those fields is recorded.
What you see in Session Insights after installation
- Top rage click targets — the UI elements users click most in frustration, sorted by frequency
- Top dead click zones — areas with high click density but no interactive elements
- Session funnel — drop-off points across your most common user flows
- Feature adoption map — which features have been triggered, and by what percentage of users
- Recent sessions — a list of the last 50 sessions with per-session event timelines
Troubleshooting
If Session Insights shows "No data yet" after installing the snippet, check two things. First, open your browser developer console and confirm window.frantiko is defined — if it is not, the script tag is not loading. Second, confirm your project token in Dashboard > Integrations matches the one in your snippet exactly; the token is case-sensitive.
Try Frantiko for free
AI Architect, Session Insights, AI Fix Center, and Product Reports — all in one place.
Get started free