Zurück zum Blog

Datenschutzfreundliches Analytics in einer Next.js-App Einbinden

Eine Schritt-für-Schritt-Anleitung zur Integration von Monoid in Next.js ohne Cookies, Einwilligungsbanner oder Compliance-Kopfschmerzen.

Next.js-Anwendungen haben einige gängige Analytics-Ansätze, und die meisten von ihnen erfordern entweder ein Cookie-Banner oder ein schwergewichtiges Drittanbieter-Skript, das Ihre Core Web Vitals verlangsamt. Hier ist, wie Sie Echtzeit-, datenschutzfreundliches Analytics ohne beides hinzufügen.

Was Sie erhalten

  • Pageview-Tracking bei jedem Routenwechsel, einschließlich clientseitiger Navigation
  • Besucherzählungen, Referrer, Länder, Browser-Familien und Gerätetypen
  • Keine Cookies, kein Fingerprinting, keine DSGVO-Einwilligung erforderlich
  • Einzelnes asynchrones Skript-Tag — kein npm-Paket zu warten

Schritt 1: Ein Monoid-Konto erstellen

Registrieren Sie sich auf monoid.website und erstellen Sie eine neue Site. Sie erhalten eine site_id — eine kurze alphanumerische Kennung für Ihre Property.

Schritt 2: Den Tracker zu Ihrem Layout hinzufügen

Fügen Sie in Next.js 13+ mit dem App Router das Tracker-Skript zu Ihrem Root-layout.tsx hinzu:

import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://api.monoid.website/tracker.min.js"
          data-site-id="YOUR_SITE_ID"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

Die Verwendung von strategy="afterInteractive" lädt das Skript, nachdem die Seite interaktiv wird, und hält Ihren Largest Contentful Paint Score unbeeinflusst.

Schritt 3: Clientseitige Navigation behandeln

Der eingebaute history.pushState-Hook des Trackers feuert automatisch bei jedem Navigationsereignis in sowohl dem Pages Router als auch dem App Router. Sie müssen nichts Zusätzliches hinzufügen.

Wenn Sie benutzerdefinierte Ereignisse senden möchten — zum Beispiel, wenn ein Nutzer einen Checkout abschließt oder einen bestimmten Button klickt — rufen Sie den globalen Helfer direkt auf:

window.monoid('event', 'checkout_complete')

Schritt 4: Im Dashboard verifizieren

Öffnen Sie Ihr Monoid-Dashboard und navigieren Sie zu einer Seite auf Ihrer Website. Sie sollten innerhalb weniger Sekunden einen Live-Besucher im Echtzeit-Feed erscheinen sehen. Wenn Sie eine Staging-Umgebung eingerichtet haben, stellen Sie sicher, dass sie eine separate site_id verwendet, damit Entwicklungs-Traffic Ihre Produktions-Metriken nicht verunreinigt.

Was nicht erforderlich ist

Sie müssen keinen Cookie-Einwilligungs-Manager installieren. Sie müssen Ihre Datenschutzerklärung nicht aktualisieren, um Analytics-Cookies zu erwähnen (weil es keine gibt). Und Sie benötigen kein npm-Paket — der Tracker ist eine einzige Vanilla-JavaScript-Datei, die aus einem globalen Edge-Netzwerk ausgeliefert wird.

Browser-Familie und Gerätetyp werden serverseitig aus dem gewöhnlichen User-Agent der Anfrage für aggregierte Berichte abgeleitet. Vollständige User-Agent-Strings, Browser-Versionen, Cookies, persistente Kennungen und Gerätefingerabdrücke werden niemals gespeichert.

Für die meisten Next.js-Projekte dauert das von der Anmeldung bis zu Live-Daten weniger als zwei Minuten.