Installer Statsdot sur Next.js

App Router

Ajoutez le script à votre layout racine, app/layout.tsx :

import Script from 'next/script'

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://statsdot.com/js/script.js"
          data-domain="yoursite.com"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

Pages Router

Ajoutez une balise script classique dans pages/_document.tsx :

import { Html, Head, Main, NextScript } from 'next/document'

export default function Document() {
  return (
    <Html>
      <Head>
        <script defer data-domain="yoursite.com" src="https://statsdot.com/js/script.js" />
      </Head>
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  )
}

Changements de route

Next.js change de page avec l'API History du navigateur, et Statsdot l'écoute : chaque changement de route compte comme une page vue. Aucun événement du routeur à brancher.

Événements personnalisés

<button onClick={() => window.statsdot?.track('Signup')}>Create account</button>

En TypeScript, déclarez la variable globale une fois :

declare global {
  interface Window { statsdot?: { track: (name: string, label?: string) => void } }
}

Développement

Les visites depuis localhost sont ignorées : votre développement local ne s'ajoute pas à vos chiffres.