Top 5 contenuti citati
La classifica dei cinque contenuti che ricevono più letture e citazioni, con il dettaglio dei bot e delle pagine di atterraggio.
- Confronto tra periodi.
- Filtro per singolo bot.
- Link diretto all'editor del contenuto.
AI Interaction Tracker
Ogni visita AI lascia una traccia. Impara a misurarla.
Chi legge il tuo sito? Quali pagine cita? Da dove arrivano le persone che aprono ChatGPT o Perplexity e poi atterrano su WordPress? Il tracker risponde con dati aggregati, senza rallentare una sola pagina.
5 min cooldown
3 tabelle
Top 5 citati
5minuti di cooldown per IP
1 hcache per le analytics
Top 5contenuti più citati
3tabelle dedicate ai dati
Tracking asincrono, zero impatto sui Core Web Vitals
Il tracker non aggiunge script bloccanti e non costringe il browser ad aspettare. Il snippet usa un caricamento asincrono e invia i dati con navigator.sendBeacon o fetch in modalità keepalive: se la rete cade, la pagina non se ne accorge.
- Nessuna richiesta sincrona nel percorso critico di rendering.
- Nessun cookie pubblicitario e nessun identificatore cross-site.
- Rilevamento lato server per i bot che non eseguono JavaScript.
- Endpoint di raccolta separato dall'HTML della pagina, con nonce e limiti di frequenza.
Il risultato è una misurazione continua che non entra nel budget di performance del sito.
Riconoscimento
Regex bot detection: preciso, ordinato, senza falsi positivi
Gli user agent sono stringhe libere. Una ricerca ingenua per sottostringa confonde un browser normale con un crawler e trasforma le statistiche in rumore. Il tracker applica espressioni regolari ordinate, senza distinzione tra maiuscole e minuscole, con priorità alle firme più specifiche.
- Pattern dedicati per GPTBot, ClaudeBot, PerplexityBot, Google-Extended, ChatGPT-User e altri crawler.
- Controllo dei confini di parola per evitare che una firma simile venga attribuita al bot sbagliato.
- Prima regola che corrisponde vince: niente doppie classificazioni.
- User agent sconosciuti esclusi dai conteggi AI, non attribuiti per approssimazione.
- Pattern personalizzabili e verificabili dal pannello, con esito della corrispondenza.
// pattern ordinati, case-insensitive
GPTBot = ~\bGPTBot\b~i
OAI-SearchBot = ~\bOAI-SearchBot\b~i
ChatGPT-User = ~\bChatGPT-User\b~i
ClaudeBot = ~\bClaudeBot\b~i
PerplexityBot = ~\bPerplexityBot\b~i
Google-Extended = ~\bGoogle-Extended\b~i
// la prima corrispondenza determina il bot
// nessun match = nessun conteggio AI
Un bot, una riga. La classificazione avviene una sola volta e alimenta sia le statistiche sia la dashboard, così hit, referral e citazioni parlano la stessa lingua.
Modello dati
Tre tabelle, una sola verità
Le metriche non vengono ricalcolate a ogni pagina: il tracker scrive su tabelle dedicate, aggregate e indicizzate per data, pagina e bot.
| Tabella / archivio | Cosa contiene | Granularità | Uso nella dashboard |
|---|---|---|---|
| gop_stats | Hit dei bot AI, pagina di destinazione, bot riconosciuto, ultima visita. | Giorno · pagina · bot | Trend, totale hit, Top 5 contenuti. |
| gop_ai_queries | Query e prompt aggregati, con conteggio delle occorrenze. Popolata solo con prompt logging attivo. | Query normalizzata · periodo | Intenti ricorrenti e contenuti da creare. |
| Referral AI | Visite umane provenienti da interfacce AI, referrer sanitizzato, pagina di atterraggio. | Visita aggregata · sorgente · pagina | Traffico generato, sorgente, pagina di ingresso. |
Hit non significa visita. Un hit è una lettura del contenuto da parte di un crawler; un referral è una persona arrivata da un'interfaccia AI. Il tracker tiene distinti i due fenomeni per non gonfiare nessuna metrica.
AI Analytics
La risposta in cinque secondi: cosa citano le AI
La dashboard AI Analytics mette in ordine i dati che contano: contenuti più letti, bot più attivi, referral e andamento nel tempo.
Statistiche essenziali
Hit totali, referral AI, pagine più lette e ripartizione per crawler. Ogni numero è accompagnato dal periodo di riferimento, senza ambiguità.
- Totali per giorno, settimana e mese.
- Ripartizione per famiglia di bot.
- Confronto tra sorgenti di referral.
Sidebar insights
Nel menu laterale dell'admin trovi sempre lo stato del tracker, il totale degli hit e l'ultimo bot con data e ora: sai subito se qualcosa si è fermato.
- Stato: attivo o in pausa.
- Hit totali del periodo corrente.
- Ultimo bot e ultima visita registrata.
| Posizione | Contenuto | Bot dominante | Segnale |
|---|---|---|---|
| 1 | Guida introduttiva al servizio | GPTBot | Alta lettura, referral stabile |
| 2 | Confronto tra piani e prezzi | PerplexityBot | Citato nelle risposte comparative |
| 3 | Case study del settore | ClaudeBot | Lettura profonda, pochi referral |
| 4 | FAQ tecnica | ChatGPT-User | Risposte puntuali, buona permanenza |
| 5 | Articolo di scenario | Google-Extended | Da rafforzare con dati e fonti |
Esempio di lettura della dashboard
Qualità del dato
Cooldown, aggregazione e cache: numeri che non si gonfiano
Un tracker utile non è quello che conta di più: è quello che conta meglio. Tre meccanismi proteggono le statistiche dal rumore.
Cooldown di 5 minuti
Lo stesso IP non può generare due hit ravvicinati sulla stessa pagina. Il cooldown si basa su un hash temporaneo e impedisce che un monitoraggio o un refresh automatico falsifichi il trend.
- Finestra di 5 minuti per IP e pagina.
- Hash non reversibile nelle statistiche.
- Nessun impatto sui bot legittimi già conteggiati.
Query aggregate
Le query vengono normalizzate e contate, non salvate come eventi separati per ogni utente. Le varianti equivalenti confluiscono in un'unica voce, così i report restano leggibili.
- Normalizzazione di spazi, maiuscole e punteggiatura.
- Conteggio per periodo, non sequenza utente.
- Nessuna correlazione tra query e persona.
Cache analytics di 1 ora
Le query di aggregazione più pesanti vengono memorizzate per un'ora. La dashboard resta rapida anche con anni di storico e non ripete gli stessi calcoli a ogni apertura.
- TTL di un'ora per i report aggregati.
- Invalidazione quando arrivano nuovi dati rilevanti.
- Nessun carico aggiuntivo sul database.
Privacy by design
Prompt logging: spento di default, acceso solo se decidi tu
Le query possono contenere dati personali, nomi, email o dettagli sensibili. Per questo la registrazione dei prompt è un'opzione esplicita, disattivata di default, con una retention definita e strumenti GDPR completi.
- Default OFF: il plugin non salva il testo delle query finché non attivi la funzione.
- Retention da 1 a 3650 giorni: scegli tu per quanto conservare i prompt, con pulizia automatica.
- Exporter ed eraser: integrazione con gli strumenti WordPress per esportare o cancellare i dati personali.
- Minimizzazione: niente IP in chiaro nelle dashboard e nessun identificatore cross-site.
Il consenso non è un dettaglio. Se attivi il prompt logging, il plugin ti ricorda di aggiornare l'informativa privacy e di raccogliere una base giuridica adeguata. La retention è il secondo livello di protezione.
| Dato | Default | Controllo |
|---|---|---|
| Testo dei prompt | Non registrato | Opt-in esplicito |
| Retention prompt | Definita all'attivazione | 1–3650 giorni |
| IP per cooldown | Hash temporaneo | 5 minuti |
| Statistiche hit | Aggregate | Sempre attive |
Attribuzione server-side
Anche le letture API v2 entrano nelle statistiche
Un client che legge il contenuto tramite API v2 non esegue il beacon del browser. Per non perdere queste letture, il plugin attribuisce la richiesta lato server al contenuto e alla chiave API utilizzata.
- Endpoint raw
text/markdownetext/htmltracciati per ID contenuto. - Attribuzione alla chiave API, utile per i report Agency.
- Nessun dato personale del chiamante nelle statistiche aggregate.
- Le letture API compaiono accanto a hit bot e referral, nello stesso periodo.
Così sai non solo che il contenuto è stato citato, ma anche quante integrazioni lo stanno leggendo in modo programmatico.
# lettura raw tracciata lato server
curl -H "Authorization: Bearer gop_xxx" \
-H "Accept: text/markdown" \
https://example.com/wp-json/geo-pro/v2/content/123
# la richiesta viene attribuita a:
content_id = 123
api_key = gop_xxx (scope read)
format = markdown
event = api_read
Una metrica in più, zero lavoro in più. Le letture API sono già incluse nel conteggio: non serve un secondo tracker né un tag aggiuntivo.
Esplora API v2 e webhook
Domande frequenti
Misurare senza rallentare e senza invadere
Il tracker rallenta il sito?
No. Il codice front-end è asincrono e usa sendBeacon, quindi non blocca il rendering. Il rilevamento dei bot avviene lato server e le statistiche pesanti sono servite da una cache di un'ora, senza query ripetute a ogni visualizzazione.
I bot AI eseguono JavaScript?
Quasi mai. Per questo il tracker non si affida al browser: intercetta la richiesta HTTP lato server, analizza lo user agent con espressioni regolari ordinate e registra il colpo anche quando nessuno script viene eseguito.
Quali dati personali vengono salvati?
Le statistiche sono aggregate per pagina, bot e giorno. L'indirizzo IP viene usato solo in forma hash per il cooldown di cinque minuti e non viene mostrato nelle dashboard. Il testo dei prompt viene registrato solo se attivi esplicitamente il prompt logging.
Posso cancellare i prompt registrati?
Sì. La retention è configurabile da 1 a 3650 giorni e i prompt più vecchi vengono eliminati automaticamente. Sono disponibili anche gli strumenti di esportazione e cancellazione dei dati personali previsti dal GDPR.
Che differenza c'è tra hit bot e referral AI?
L'hit è una lettura del contenuto da parte di un crawler AI. Il referral è una visita umana arrivata da un'interfaccia come ChatGPT o Perplexity. Il tracker registra entrambi e li collega alla pagina di destinazione.
Come vengono attribuite le letture tramite API v2?
Quando un client legge il contenuto tramite l'endpoint API v2 raw non c'è un browser da tracciare. Il plugin attribuisce la richiesta lato server al contenuto e alla chiave API, così le letture restano visibili nelle statistiche senza beacon aggiuntivi.
Misura ciò che conta
Scopri chi ti legge, cosa cita e quanto traffico porta l'AI.
30 giorni di prova gratuita, 14 giorni money back e tutte le funzioni Pro incluse: tracker, AI Analytics, prompt logging opzionale, API v2 e dashboard.
Oppure attiva subito la licenza per 1 sito o per 3 siti.