intelliada / laravel
First-party Intelliada analytics for Laravel: the tracking script and events are served from your own domain.
Requires
- php: ^8.2
- illuminate/console: ^12.0|^13.0
- illuminate/http: ^12.0|^13.0
- illuminate/routing: ^12.0|^13.0
- illuminate/support: ^12.0|^13.0
- illuminate/view: ^12.0|^13.0
Requires (Dev)
- guzzlehttp/guzzle: ^7.8
- orchestra/testbench: ^10.0|^11.0
- phpunit/phpunit: ^11.0|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 18:53:49 UTC
README
Cookieless, first-party Intelliada analytics for Laravel.
The tracking script and its events are served from your own domain, under a path that's random to your app, so your analytics aren't treated as a third-party tracker. Your project token stays on your server.
Installation
composer require intelliada/laravel php artisan intelliada:install --token=your-project-token
The install command:
- publishes
config/intelliada.php; - saves
INTELLIADA_TOKENand a randomINTELLIADA_PATHto.env; - adds
@intelliadato your layout's<head>, checkingresources/views/app.blade.php,layouts/app.blade.phpandcomponents/layouts/app.blade.php.
If your layout lives elsewhere, add the directive yourself:
<head> ... @intelliada </head>
What gets tracked
- A pageview for each page load.
- Client-side navigations in Inertia, Livewire
wire:navigate, Turbo and otherhistory.pushStaterouters, each with the previous page as its referrer so visits keep their original source. - Custom events from your JavaScript:
window.Intelliada?.trackEvent('Signup', { plan: 'pro' });
No cookies are set and nothing is stored beyond the browser session.
Without Laravel
The browser client is the intelliada package. Install it in a single-page app or any other JavaScript app and pass your project token:
npm install intelliada
import { init } from 'intelliada' const intelliada = init({ token: 'your-project-token', }) intelliada.trackEvent('Signup', { plan: 'pro' })
Events then go to Intelliada from the browser, so the token is visible there. To keep it on your server, send events to an endpoint you control and pass that as endpoint, which is what @intelliada does.
How it works
@intelliada renders a script tag pointing at /{path}/main.js on your domain. The script sends events to /{path}/e, and the package forwards them to Intelliada with your token, the visitor's IP address and user agent, and their country if your CDN provides one. The visitor's IP address is used only to compute a daily-rotating visitor hash and is never stored.
Only a visitor's first event waits for Intelliada, because the script needs the visitor hash it returns. Later events are answered straight away and forwarded after the response is sent, so a slow network doesn't hold up your app.
These routes sit outside the web middleware group, so they use no session or CSRF token, and they're rate-limited per visitor.
Privacy and consent
Serving analytics from your own domain doesn't change your privacy obligations. Whether you need consent depends on what's collected and where your visitors are, not on which domain the requests go to.
What the package does:
- Sets no cookies.
- Keeps the visitor hash in
sessionStorage, which is cleared when the tab closes. - Uses the visitor's IP address only to compute a hash with a salt that rotates daily, then discards it.
- Skips automated browsers and known bots.
Some regulators, such as those applying the EU ePrivacy Directive, treat any storage on the visitor's device as needing consent unless it's strictly necessary. If your own assessment says you need consent, only render @intelliada for visitors who have given it, and list Intelliada in your privacy policy.
Configuration
| Variable | Default | Purpose |
|---|---|---|
INTELLIADA_TOKEN |
– | Your project token. Tracking is off until it's set. |
INTELLIADA_ENABLED |
true |
Set to false to switch tracking off for an environment, such as local. |
INTELLIADA_PATH |
ia |
The first-party path. Set by intelliada:install. |
INTELLIADA_TIMEOUT |
2 |
Seconds to wait when forwarding an event. |
The route middleware and the CDN country headers (CF-IPCountry, CloudFront-Viewer-Country, X-Vercel-IP-Country, X-Country-Code) can be changed in config/intelliada.php.
Behind a load balancer or CDN
Visitors are identified by $request->ip(), so make sure Laravel's trusted proxies are configured. Otherwise every visitor looks like your load balancer.
Testing
composer test
Developing the tracking script
resources/js/script.ts starts the installed intelliada package from the script tag's data-* attributes. The build bundles that dependency into resources/dist/intelliada.min.js, which is what this package serves. Commit that file:
npm install npm run build
CI fails if the committed build doesn't match the source. The client itself is the intelliada package.
License
MIT. See LICENSE.