Privatus Analytics

You want to know which docs pages people read and where they come from. Many analytics tools use cookies, so in many countries you must show a cookie pop-up first. Many visitors click no, and they never show up in your numbers.

Privatus Analytics counts visits without cookies and keeps no IP addresses. Known bots are left out. The @privatus-analytics/next package adds its script to your Fumadocs site with one tag. There is a free plan with 10,000 events a month on up to 3 sites, and it needs no card.

SetupCopy Anchor Link

You need a Privatus Analytics site id. It starts with pa_, and you find it under Site settings, Tracking.

npm install @privatus-analytics/next

PRIVATUS_SITE_ID=pa_YOURSITEID

import { RootProvider } from 'fumadocs-ui/provider/next';
import { PrivatusAnalyticsTag } from '@privatus-analytics/next/server';
import type { ReactNode } from 'react';

export default function Layout({ children }: { children: ReactNode }) {
  return (
    <html lang="en" suppressHydrationWarning>
      <head>
        <PrivatusAnalyticsTag modules={['engage', 'auto', 'vitals', 'clicks', 'ask']} />
      </head>
      <body className="flex flex-col min-h-screen">
        <RootProvider>{children}</RootProvider>
      </body>
    </html>
  );
}

Without the packageCopy Anchor Link

You can add the script tag by hand instead:

<head>
  <script
    defer
    src="https://privatusstats.com/js/pa.js"
    data-site="pa_YOURSITEID"
    data-modules="engage,auto,vitals,clicks,ask"
  />
</head>

Track eventsCopy Anchor Link

To count an action, like a download, call usePrivatus() in a Client Component. This needs the package:

'use client';
import { usePrivatus } from '@privatus-analytics/next';

export function DownloadButton() {
  const privatus = usePrivatus();
  return (
    <button onClick={() => privatus.track('Download', { file: 'guide.pdf' })}>Download</button>
  );
}

If you added the script tag by hand, you can add an attribute instead. The script reads it in the browser:

<a href="/guide.pdf" data-privatus-event="Download" data-privatus-prop-file="guide.pdf">
  Download
</a>

See the package README for every setting, and the Privatus Analytics docs for the dashboard.