Usa il plugin. È un'impostazione sola e sopravvive a un cambio di tema, cosa che le alternative non fanno.

Il plugin

  1. Apri skomi-plugin-wordpress e, sotto Releases, scarica lo skomi-wordpress.zip allegato all'ultima.
  2. In WordPress vai su Plugin → Aggiungi nuovo plugin → Carica plugin, scegli il file, installalo e attivalo.
  3. Vai su Impostazioni → Skomi Analytics.
  4. Incolla il tuo identificativo di sito e salva.

⚠ Prendi lo zip dalla release, non dal pulsante verde «Code → Download ZIP». Quello avvolge tutto in una cartella che porta il nome del repository e del ramo, e WordPress installa un plugin dentro qualunque cartella lo zip contenga. Il plugin finirebbe sotto il nome sbagliato, e l'estensione per WooCommerce qui sotto (che chiede skomi-wordpress per nome) smetterebbe di trovarlo.

L'identificativo di sito sta sulla pagina del tuo sito dentro Skomi. È un UUID, e non è un segreto: compare nel codice sorgente di ogni pagina che misura.

Contano due impostazioni e il resto può restare com'è:

  • Attivo, che è acceso. Spegnerlo ferma la raccolta e tiene il tuo identificativo di sito, così non devi andare a ripescarlo dopo.
  • Identificativo di sito. Un identificativo che non sia un UUID viene rifiutato con un messaggio invece che salvato, perché un identificativo sbagliato salvato stampa un tag script rotto su ogni pagina.

Un valore di serie che vale la pena conoscere: le visite delle persone che hanno l'accesso aperto su WordPress non vengono misurate. Su un sito piccolo le tue ricariche superano di numero il traffico vero, e niente in una dashboard lo dice. C'è una casella se le vuoi.

Se vendi con WooCommerce, aggiungi anche Skomi per WooCommerce, installato allo stesso modo. Riporta il totale, la valuta e il numero di ogni ordine, ed è il numero dell'ordine che impedisce a una pagina di ringraziamento ricaricata di contare una seconda vendita.

Tutti e due si caricano invece di trovarli nella directory dei plugin: non sono su wordpress.org. Il codice sorgente di entrambi è pubblico, e vale la pena leggerlo tutto prima di installare qualunque cosa su un sito che incassa soldi.

Incollare il tag a mano

Non ti serve se hai usato il plugin. Sta qui perché certi siti non ne possono aggiungere uno, e perché un tag incollato dentro un tema è il modo più comune in cui l'analitica si ferma in silenzio su WordPress: un cambio di tema se lo porta via, senza nessun errore e senza niente di cui accorgersi.

Vai prima a prendere lo snippet dalla tua dashboard. Ha questo aspetto, con il tuo identificativo di sito nel percorso:

<script src="https://t.skomi.com/s/your-site-id.js" defer></script>

Un plugin per intestazione e piè di pagina

L'opzione a cui rivolgersi se preferisci non toccare un tema. Plugin come WPCode o Head & Footer Code aggiungono una pagina di impostazioni con una casella per l'intestazione e una per il piè di pagina. Incolla il tag nella casella del piè di pagina e salva.

Questo sopravvive a ogni cambio di tema e a ogni aggiornamento di tema, che è tutto l'argomento a suo favore.

Un tema figlio

Se hai già un tema figlio, aggiungi questo al suo functions.php:

add_action( 'wp_footer', function () {
    ?>
    <script src="https://t.skomi.com/s/your-site-id.js" defer></script>
    <?php
}, 100 );

wp_footer scatta appena prima del tag </body> di chiusura, e la priorità 100 mette il tag dopo gli script che WordPress accoda alla priorità di serie di 20.

⚠ Un tema figlio, non il tema stesso. Modificare il footer.php di un tema genitore funziona finché quel tema non si aggiorna, e poi il tag è sparito senza nessun errore e senza nessun segno che qualcosa sia cambiato. Semplicemente smetti di raccogliere.

Il campo del tuo tema

Molti temi commerciali hanno un'impostazione «codice personalizzato», «codice di misurazione» o «script». Se il tuo ce l'ha, è la stessa idea di un plugin per intestazione e piè di pagina con una cosa in meno installata. Usa il campo del piè di pagina o del corpo invece di quello dell'intestazione.

⚠ È anche l'opzione che sparisce con il tema, quindi è la più debole delle tre a meno che tu non sia sicuro che il tema sia permanente.

Che cosa farà il tuo plugin di cache

Questo vale comunque il tag sia finito sulla pagina, con plugin o senza.

Svuota la cache dopo aver aggiunto il tag. Una pagina in cache è stata generata prima che il tag esistesse e non lo contiene, quindi non arriva niente e non c'è niente di sbagliato.

Escludi lo script di Skomi da «combina JavaScript» e da qualunque opzione che copi gli script di terze parti sul tuo server. Skomi costruisce un pacchetto per sito a partire dai prodotti che hai acceso, e il browser deve andare a prendere quello attuale. Una copia bloccata dentro il pacchetto del tuo plugin di ottimizzazione è congelata al giorno in cui è stata copiata: accendere un prodotto più avanti non cambierebbe niente, e non ci sarebbe niente da vedere che lo spieghi.

I plugin di ottimizzazione che soltanto rimandano o ritardano lo script vanno bene: il tag porta già defer.

Più di un sito

Un WordPress multisito, o più installazioni, vogliono dire più siti su Skomi: ogni dominio si registra a parte e riceve il suo identificativo, e ogni sottosito ha bisogno del suo tag. I sottodomini di un dominio registrato sono accettati dal sito a cui appartengono.

Controlla che funzioni

Carica una pagina del tuo sito e poi guarda la tua dashboard. Se non arriva niente, percorri che cosa controllare quando lo snippet non funziona; su WordPress la risposta è quasi sempre una cache che non è stata svuotata, o un plugin di ottimizzazione che ha riscritto il tag.