# AEO Monitor & Optimizer — Guida completa > Panoramica AEO Monitor & Optimizer misura la visibilità del tuo brand nelle risposte di cinque assistenti IA — ChatGPT (OpenAI), Claude (Anthropic), Perplexity, Gemini (Google) e Mistral — e genera… - Pagina: - Lingua: it - Aggiornato il: 2026-07-01 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfaeomonitor/index.md), [en](https://www.datafirefly.com/en/documentation/dfaeomonitor/index.md), [es](https://www.datafirefly.com/es/documentation/dfaeomonitor/index.md), [de](https://www.datafirefly.com/de/documentation/dfaeomonitor/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaeomonitor/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaeomonitor/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaeomonitor/index.md) - Indice: ## Panoramica AEO Monitor & Optimizer misura la visibilità del tuo brand nelle risposte di cinque assistenti IA — ChatGPT (OpenAI), Claude (Anthropic), Perplexity, Gemini (Google) e Mistral — e genera raccomandazioni concrete per migliorarla. Il plugin invia i tuoi prompt di monitoraggio a ogni LLM attivo, analizza le risposte (menzioni di brand, citazioni di dominio, URL esatti, concorrenti), calcola un punteggio di visibilità da 0 a 100 e serve un file llms.txt dinamico. Il plugin funziona con il modello BYOK (Bring Your Own Key): usi le tue chiavi API e le chiamate vanno direttamente dal tuo server alle API ufficiali. Nessun dato passa da DataFirefly. ## Requisiti - WordPress 6.0 o superiore (testato fino alla 6.7) - PHP 7.4 o superiore (8.1+ consigliato) - WooCommerce 7.0+ solo per il monitoraggio automatico dei prodotti e la generazione di prompt per categoria (opzionale) - Almeno una chiave API tra: OpenAI, Anthropic, Perplexity, Google Gemini, Mistral - WP-Cron funzionante (o un cron di sistema che chiami wp-cron.php) per gli audit pianificati ## Installazione 1. Scarica il file ZIP dal tuo account cliente DataFirefly. 2. Nell'admin di WordPress, vai su **Plugin → Aggiungi nuovo → Carica plugin**, seleziona dfaeomonitor.zip e clicca su **Installa ora**. 3. Clicca su **Attiva**. Il plugin crea automaticamente le sue 6 tabelle di database e pianifica il cron di audit settimanale. 4. Vai su **Impostazioni → Permalink** e clicca su **Salva** (senza modificare nulla) per aggiornare le regole di riscrittura per l'URL llms.txt. Un menu **AEO Monitor** compare nella barra laterale dell'admin con sei pagine: Dashboard, Prompt, Risultati, Pagine monitorate, Raccomandazioni e Impostazioni. ## Configurazione iniziale ### 1. Brand e sito In **AEO Monitor → Impostazioni**, compila: - **Nome del brand**: il nome esatto che gli LLM dovrebbero citare. - **Alias / varianti**: altre grafie o denominazioni commerciali (una per riga). Ogni alias conta come menzione del brand. - **Dominio principale**: il tuo dominio senza http né www (esempio: mionegozio.it). Ogni citazione di un URL di quel dominio conta come citazione di dominio. - **Concorrenti**: un brand per riga. Il plugin rileva quando un LLM parla di loro al posto tuo e applica una penalità al punteggio. ### 2. Fornitori LLM Sempre nelle Impostazioni, attiva i fornitori che vuoi interrogare e incolla la chiave API corrispondente: - **OpenAI** — chiave da platform.openai.com. Modello consigliato per il monitoraggio: gpt-4o-mini. Il plugin usa l'API Responses con lo strumento di ricerca web. - **Anthropic** — chiave da console.anthropic.com. La chiamata usa l'API Messages con lo strumento di ricerca web. - **Perplexity** — chiave da perplexity.ai. Modello sonar-pro con citazioni native: il fornitore più ricco di fonti. - **Google Gemini** — chiave da Google AI Studio. Il grounding con Google Search si attiva automaticamente. - **Mistral** — chiave da console.mistral.ai. Ricerca web quando disponibile, altrimenti ripiego sulle conoscenze interne del modello. Una sola API basta per iniziare, ma tre o più fornitori danno una visione rappresentativa. Un audit settimanale di 10 prompt su 5 LLM (50 chiamate) costa di solito tra 0,30 e 1,20 euro con i modelli economici. ### 3. Pianificazione - **Cadenza degli audit**: settimanale (consigliata) o giornaliera. - **Prompt max per audit**: tetto di prompt inviati a ogni esecuzione. Ricorda: ogni prompt viene inviato a ogni LLM attivo. - **Timeout richiesta**: durata massima di una chiamata API (45 secondi di default). - **Monitoraggio automatico**: spunta per monitorare automaticamente ogni nuovo prodotto WooCommerce pubblicato e, se vuoi, ogni nuova pagina. - **llms.txt dinamico**: attiva la risposta del sito all'URL llms.txt. ## Creare e gestire i prompt Un prompt è una domanda inviata così com'è agli LLM, formulata come la porrebbe un utente reale. Esempi: «Quali sono i migliori moduli SEO per PrestaShop?», «Quale negozio consigli per comprare sneaker in pelle in Italia?» In **AEO Monitor → Prompt** puoi: - **Creare un prompt manualmente** con un'etichetta interna, il testo della domanda, un intento (brand, prodotto, categoria, concorrente, informazionale), una lingua, e facoltativamente un URL di destinazione di cui vuoi tracciare la citazione. - **Generare prompt predefiniti**: il pulsante dedicato crea automaticamente prompt di brand e un prompt per ogni categoria WooCommerce, nella lingua del sito. - **Attivare / disattivare** un prompt senza eliminarlo: solo i prompt attivi vengono inviati durante gli audit. Associare un URL di destinazione a un prompt permette di misurare con precisione se gli LLM rimandano alla pagina giusta — il punteggio guadagna 20 punti quando viene citato l'URL esatto. ## Avviare un audit Tre modi per avviare un audit: 1. **Pulsante «Avvia un audit adesso»** sulla dashboard — l'esecuzione parte in background entro pochi secondi. 2. **Cron pianificato** — automatico secondo la cadenza scelta nelle impostazioni. 3. **WP-CLI** — il comando wp dfaeo audit esegue l'audit in modo sincrono con i dettagli nel terminale. Durante l'audit, ogni prompt attivo viene inviato a ogni fornitore attivo con una pausa di 300 ms tra le chiamate. Le risposte vengono memorizzate, analizzate e le raccomandazioni vengono generate automaticamente alla fine dell'esecuzione. ## Capire il punteggio di visibilità Ogni risposta LLM riceve un punteggio da 0 a 100 calcolato così: - +30 punti se il tuo brand viene menzionato, più un bonus fino a +15 in base al numero di ripetizioni - +25 punti se il tuo dominio viene citato nelle fonti - +20 punti se viene citato l'URL di destinazione esatto del prompt - +5 punti se la risposta contiene fonti - Penalità fino a -15 punti in base al numero di menzioni di concorrenti La dashboard aggrega questi punteggi: media globale, tasso di menzione del brand, tasso di citazione del dominio, andamento su 7, 30 o 90 giorni e confronto delle cinque piattaforme. ## Pagine monitorate e punteggio di copertura La pagina **Pagine monitorate** elenca gli URL di cui sorvegli l'indicizzazione da parte degli LLM. Il punteggio di copertura di una pagina aumenta ogni volta che un LLM cita il suo URL esatto e diminuisce leggermente a ogni audit senza citazione (fattore 0,98), riflettendo la freschezza reale della tua presenza. - I prodotti WooCommerce pubblicati vengono aggiunti automaticamente se l'opzione è attiva. - Puoi aggiungere manualmente qualsiasi URL con un tipo (pagina, prodotto, articolo, categoria) e una priorità da 1 a 10. - Le pagine ad alta priorità ma con punteggio basso generano automaticamente raccomandazioni. ## Raccomandazioni Dopo ogni audit, il motore di raccomandazioni analizza le pagine in difficoltà e propone azioni classificate per severità (alta, media, bassa): - **FAQ JSON-LD** — blocco di codice pronto da incollare nell'intestazione della pagina, con domande e risposte generate dal contenuto. - **Schema Product** — dati strutturati arricchiti per le schede WooCommerce (prezzo, disponibilità, recensioni) popolati dai dati reali del prodotto. - **Riassunto TL;DR** — un paragrafo di 60-80 parole da inserire all'inizio del contenuto, un formato che gli LLM estraggono volentieri. - **Schema Organization** — identità di brand rafforzata per limitare confusioni e allucinazioni sulla tua azienda. - **robots.txt** — regole di autorizzazione per i crawler IA: GPTBot, ClaudeBot, PerplexityBot, Google-Extended. - **Priorità llms.txt** — promozione di una pagina strategica nel file llms.txt dinamico. Ogni raccomandazione può essere segnata come In corso, Risolta o Ignorata. Il codice proposto compare in un blocco espandibile pronto da copiare. ## Il file llms.txt dinamico Quando l'opzione è attiva, il tuo sito risponde all'URL llms.txt con un indice Markdown generato di continuo: - **Top references** — le pagine meglio rilevate dagli LLM, ordinate per punteggio di copertura. - **Priority pages** — le pagine con priorità 5 o più non ancora ben rilevate. - **Catalog** — le tue principali categorie WooCommerce. - **About** — nome del brand, URL del sito e contatto. Se l'URL llms.txt restituisce un 404, salva di nuovo i permalink in Impostazioni → Permalink. Il filtro dfaeo_llmstxt_lines permette agli sviluppatori di modificare le righe generate. ## WP-CLI Tre comandi disponibili per l'automazione: ``` «wp dfaeo audit» avvia un audit sincrono (opzione --prompts=5 per limitare) «wp dfaeo seed» genera i prompt predefiniti da brand e categorie «wp dfaeo report --days=30» mostra il report aggregato (opzione --format=json o csv) ``` Il comando report è ideale per alimentare uno strumento di BI o una dashboard esterna tramite un cron job di sistema. ## Risoluzione dei problemi - **«Nessun audit è potuto partire»** — verifica che almeno un fornitore sia attivo con una chiave API valida e che almeno un prompt sia attivo. - **Errori 401 / 403 nei risultati** — la chiave API del fornitore interessato è invalida o scaduta. Gli errori sono visibili nel dettaglio di ogni risultato. - **Errori 429** — quota API raggiunta presso il fornitore. Riduci il numero di prompt per audit o passa alla cadenza settimanale. - **Il cron non parte** — sui siti a basso traffico, WP-Cron si esegue solo con le visite. Configura un cron di sistema che chiami wp-cron.php ogni 15 minuti. - **llms.txt restituisce 404** — salva di nuovo i permalink oppure disattiva e riattiva il plugin. - **Grafici vuoti sulla dashboard** — normale prima del primo audit completato. Verifica anche che nessun blocker di script impedisca il caricamento di Chart.js dal CDN jsdelivr. ## Disinstallazione La disattivazione conserva tutti i tuoi dati. L'eliminazione del plugin dalla pagina Plugin esegue la pulizia completa: le 6 tabelle (prompts, runs, results, citations, pages, recommendations), le opzioni e le attività cron vengono rimosse definitivamente. ## Privacy e GDPR Il plugin non invia alcun dato a DataFirefly e non include telemetria. Le uniche chiamate in uscita vanno alle API degli LLM che hai attivato, con le tue chiavi. I prompt che scrivi vengono trasmessi a questi fornitori terzi: evita di includervi dati personali dei clienti. Le chiavi API sono memorizzate nella tabella delle opzioni WordPress del tuo database.