Documentazione

Tutto ciò che ti serve per avere Monoid in funzione sul tuo sito.

Avvio rapido Configurazione Eventi personalizzati Privacy e dati Riferimento API

1. Crea un account

Vai su monoid.website, inserisci la tua email, la password e il dominio. Riceverai un link di attivazione via email.

2. Aggiungi lo snippet del tracker

Dopo la conferma, incolla questo all'interno del tag <head> del tuo sito. Sostituisci YOUR_SITE_ID con l'ID dalla tua dashboard.

html

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

Lo script viene caricato in modo asincrono — non blocca mai il rendering della pagina. I dati iniziano ad apparire nella tua dashboard entro pochi secondi.

3. Verifica l'installazione

Apri il tuo sito in un browser, poi controlla la tua dashboard Monoid. Dovresti vedere una pagina vista comparire in tempo reale nel pannello Visitatori Live. Se non appare nulla dopo un minuto, controlla che l'attributo data-site-id corrisponda esattamente al tuo ID sito.

Next.js / React

In Next.js, aggiungi lo snippet al tuo _document.tsx oppure usa il componente next/script con 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

Nel functions.php del tuo tema, aggiungi:

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');

Tracciamento no-JS (pixel)

Se non puoi eseguire JavaScript — pagine renderizzate lato server con JS disabilitato, pagine statiche rigorose o ambienti che bloccano gli script — usa il pixel di tracciamento. Inserisci questo tag <img> dove vuoi che si attivi il tracciamento. Sostituisci YOUR_SITE_ID e imposta p sul percorso corrente della pagina.

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" />

Il pixel registra gli stessi dati analitici principali del tracker JS — percorso, referrer, paese, tipo di dispositivo e hash giornaliero del visitatore — ma senza la larghezza dello schermo (nessun JavaScript disponibile). L'header Referer del browser viene usato automaticamente; puoi sovrascriverlo con un parametro &r=referrer-domain. I visitatori che inviano DNT: 1 non vengono registrati.

Manca qualcosa o c'è qualcosa di errato? Faccelo sapere