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 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.

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.

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.

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.

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.