Luminel

Get Started

Luminel Analytics โ€“ Get Started

๐Ÿš€ Step 1 - Add website

Log in to your Luminel Dashboard and add your websiteโ€™s domain to start tracking analytics.

โšก Step 2 โ€“ Add Code Snippet

Insert the following script inside your websiteโ€™s <head>...</head> section. The script auto-detects SPA navigations and works for both static and SPA sites.

<script defer src="https://luminel.app/script.js" data-id="YOUR_WEBSITE_ID" data-dnt="false"></script>

โœ… Attributes:

  • data-id โ†’ Your Website ID (used to directly identify your site, independent of domain).
  • data-dnt โ†’ Honors Do Not Track when set to true. Default: false.

๐Ÿ”— Ignores localhost by default and derives its API endpoint automatically from the script URL.

<script defer src="https://luminel.app/script.js" data-id="YOUR_WEBSITE_ID" data-dnt="false"></script>

๐Ÿงช Step 3 โ€“ Verify the Script

  1. Deploy your site with the snippet.
  2. Reload your siteโ€™s page.
  3. Go to your dashboard/:siteId to confirm the first page view is logged on the charts.

๐Ÿ“ˆ What is Tracked

The script tracks page views with essential, non-PII context: title, timezone, language, viewport, connection, referrer, and basic device info (browser, os, device). โš ๏ธ No cookies and no personal data are collected.

๐Ÿ”’ Privacy

  • โŒ No cookies, no persistent identifiers for individuals.
  • ๐ŸŒ IP addresses are used transiently to derive a country and generate a rolling session/visit hash, then discarded.
  • ๐Ÿ›‘ You can opt-in to respect Do Not Track via data-dnt="true".
  • ๐Ÿ–ฅ๏ธ Localhost traffic is ignored by default; API endpoint is derived automatically from the script URL.