Dokumentation

Alles, was du brauchst, um Monoid auf deiner Website zum Laufen zu bringen.

Schnellstart Konfiguration Benutzerdefinierte Ereignisse Datenschutz & Daten API-Referenz

1. Konto erstellen

Gehe zu monoid.website, gib deine E-Mail, dein Passwort und deine Domain ein. Du erhältst einen Aktivierungslink per E-Mail.

2. Tracker-Snippet hinzufügen

Nach der Bestätigung füge dies innerhalb des <head>-Tags deiner Website ein. Ersetze YOUR_SITE_ID durch die ID aus deinem Dashboard.

html

<script async defer
  src="https://api.monoid.website/tracker.min.js"
  data-site-id="YOUR_SITE_ID"
  data-autotrack="true">
</script>

Das Skript wird asynchron geladen — es blockiert nie das Seitenrendering. Daten erscheinen innerhalb von Sekunden in deinem Dashboard.

3. Installation überprüfen

Öffne deine Website in einem Browser, dann überprüfe dein Monoid-Dashboard. Du solltest einen Seitenaufruf in Echtzeit im Live-Besucher-Panel erscheinen sehen. Wenn nach einer Minute nichts erscheint, überprüfe, ob das data-site-id-Attribut genau mit deiner Website-ID übereinstimmt.

Next.js / React

In Next.js füge den Snippet in deine _document.tsx ein oder verwende die next/script-Komponente mit strategy="afterInteractive":

tsx

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>
  )
}

WordPress

In der functions.php deines Themes füge hinzu:

php

function monoid_tracker() {
  echo '<script async defer src="https://api.monoid.website/tracker.min.js" data-site-id="YOUR_SITE_ID" data-autotrack="true"></script>';
}
add_action('wp_head', 'monoid_tracker');

No-JS-Tracking (Pixel)

Wenn du kein JavaScript ausführen kannst — serverseitig gerenderte Seiten mit deaktiviertem JS, streng statische Seiten oder Umgebungen, die Skripte blockieren — verwende stattdessen den Tracking-Pixel. Füge dieses <img>-Tag dort ein, wo das Tracking ausgelöst werden soll. Ersetze YOUR_SITE_ID und setze p auf den aktuellen Seitenpfad.

html

<img src="https://api.monoid.website/pixel.gif?s=YOUR_SITE_ID&p=/your-page-path"
  width="1" height="1" alt=""
  style="display:none"
  referrerpolicy="strict-origin-when-cross-origin" />

Der Pixel zeichnet dieselben Kern-Analytics-Daten auf wie der JS-Tracker — Pfad, Verweiser, Land, Gerätetyp und täglicher Besucher-Hash — aber ohne Bildschirmbreite (kein JavaScript verfügbar). Der Referer-Header des Browsers wird automatisch verwendet; du kannst ihn mit einem &r=verweiser-domain-Parameter überschreiben. Besucher, die DNT: 1 senden, werden nicht aufgezeichnet.

Etwas fehlt oder ist falsch? Sag es uns