SERP Tracker — Guida completa
Installare, configurare e gestire il monitoraggio delle posizioni Google: provider SERP, parole chiave per paese e dispositivo, dashboard, distanza dal top, indice di visibilità, concorrenti, avvisi e cron per PrestaShop 8 e 9.
Presentazione
Il modulo SERP Tracker (dfserptracker) monitora le posizioni del tuo negozio nei risultati di ricerca di Google, direttamente dal back-office PrestaShop. Dichiari le tue parole chiave (con il loro paese e dispositivo), il modulo controlla periodicamente la loro posizione tramite un provider di API SERP a tua scelta, conserva lo storico di ogni controllo, calcola le tue opportunità e ti avvisa via e-mail quando una pagina scende.
SERP Tracker non fa scraping di Google: si appoggia a un’API SERP ufficiale a cui fornisci la tua chiave. I controlli sono così affidabili, stabili e conformi alle condizioni d’uso di Google. Quattro provider sono supportati nativamente: Serper.dev, ValueSERP, SerpApi e DataForSEO.
Compatibilità
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- MySQL 5.6+ o MariaDB 10.3+
- Mononegozio e multinegozio (monitoraggio isolato per negozio)
- 5 lingue: FR, EN, ES, DE, IT
- Hosting condiviso compatibile (o2switch, OVH, ecc.)
- Nessuna dipendenza Composer (autoloader proprietario); grafici renderizzati con Chart.js in locale, senza CDN
Installazione
- Nel back-office, apri Moduli > Gestore moduli.
- Clicca su Carica un modulo e seleziona il file
dfserptracker.zip. - Una volta installato, clicca su Configura.
All’installazione, il modulo crea le sue due tabelle (df_serp_keyword e df_serp_position), registra le sue schede di amministrazione sotto il menu SERP Tracker (Dashboard, Parole chiave, Concorrenti) e inizializza le sue impostazioni predefinite, incluso un token cron casuale.
Scegliere e configurare un provider SERP
Prima di qualsiasi controllo, devi scegliere un provider e inserire la tua chiave API nella pagina di configurazione del modulo.
- Serper.dev: inserisci la tua chiave in Chiave API Serper. Semplice ed economico, ideale per iniziare.
- ValueSERP: inserisci la tua chiave in Chiave API ValueSERP.
- SerpApi: inserisci la tua chiave in Chiave API SerpApi.
- DataForSEO: questo provider usa un’autenticazione con identificativo e password. Inserisci il tuo Login DataForSEO e la tua Password DataForSEO.
Il modulo è un acquisto una tantum; i controlli consumano crediti presso il provider che scegli, in base al tuo account e al tuo volume di parole chiave. La maggior parte dei provider offre un piano gratuito o molto economico per iniziare.
Un banner di avviso viene mostrato nella dashboard finché nessun provider è correttamente configurato. Verifica che la chiave inserita corrisponda al provider selezionato nel menu a tendina Provider.
Configurazione
Contesto di ricerca predefinito
- Dominio monitorato: il dominio di cui vuoi rilevare la posizione (per impostazione predefinita il dominio del negozio). Il modulo confronta questo dominio con i risultati organici, ignorando il prefisso
www. - Paese predefinito e Dispositivo predefinito (desktop o mobile): applicati alle nuove parole chiave, sovrascrivibili caso per caso su ogni parola chiave.
- Profondità dei risultati: numero di risultati analizzati per controllo (oltre, la posizione è considerata «non posizionata»).
Avvisi
- Attivare gli avvisi: attiva l’invio di e-mail in caso di cambiamenti di posizione significativi.
- E-mail di destinazione: l’indirizzo che riceve gli avvisi.
- Soglia di calo: numero di posizioni perse a partire dal quale viene attivato un avviso.
Pianificazione
- Dimensione del lotto: numero di parole chiave elaborate a ogni passaggio del cron.
- Ritenzione dello storico: durata di conservazione dei controlli; i controlli più vecchi vengono purgati automaticamente.
- URL del cron: indirizzo in sola lettura, protetto da token, da attivare dal cron del tuo hosting (vedi la sezione Controlli automatici).
Aggiungere e gestire le parole chiave
Apri la scheda Parole chiave e poi Aggiungi una parola chiave. Ogni parola chiave porta il suo contesto:
- Parola chiave: la query da monitorare.
- URL di destinazione (facoltativo): la pagina che vuoi vedere posizionata. Se indicata, il modulo privilegia una corrispondenza esatta di questo URL; altrimenti mantiene la prima pagina del tuo dominio.
- Tag: etichetta di raggruppamento (gamma, tematica…) per filtrare le tue parole chiave.
- Lingua, Paese e Dispositivo: il contesto di ricerca proprio di questa parola chiave.
- Volume di ricerca (facoltativo): a titolo indicativo.
- Attiva: solo le parole chiave attive sono controllate dal cron.
La lista delle parole chiave mostra la posizione attuale, con un’etichetta colorata e una freccia di evoluzione (▲ / ▼) rispetto al controllo precedente. La posizione 0 significa «non posizionata» entro la profondità analizzata.
Puoi lanciare un controllo immediato senza attendere il cron: usa l’azione Controlla ora su una riga, oppure seleziona più parole chiave e applica l’azione di massa Controlla. Le azioni di massa permettono anche di attivare, disattivare o eliminare in lotto.
La dashboard
La scheda Dashboard sintetizza la tua SEO attraverso 7 indicatori:
- Indice di visibilità (0 a 100): punteggio globale ponderato da una curva di CTR per posizione. Una parola chiave in prima posizione pesa molto più di una in fondo alla pagina. È l’indicatore di tendenza da seguire nel tempo.
- Totale monitorate: numero di parole chiave attive.
- Top 3 e Top 10: numero di parole chiave posizionate nei primi tre e dieci posti.
- Distanza dal top: parole chiave posizionate tra il 4° e il 20° posto — le tue opportunità più redditizie.
- Posizione media: media delle posizioni posizionate.
- Non posizionate: parole chiave uscite dalla profondità analizzata.
Sotto gli indicatori, un grafico ad anello mostra la distribuzione delle tue posizioni (top 3 / top 10 / distanza dal top / non posizionate). Due tabelle elencano i tuoi in crescita e in calo tra gli ultimi due controlli, e una tabella distanza dal top isola le parole chiave ad alto potenziale. Il pulsante Avvia tutti i controlli esegue un controllo immediato di tutte le parole chiave dovute (in AJAX, senza lasciare la pagina).
Concorrenti e funzioni SERP
Per ogni controllo, il modulo rileva le funzioni della SERP: featured snippet (con identificazione del proprietario — tu o un concorrente), People Also Ask e local pack.
La scheda Concorrenti aggrega i domini che appaiono sulle tue query a partire dall’ultimo controllo di ogni parola chiave, conta le loro apparizioni e calcola la loro posizione media. Vengono mostrati i 30 domini più presenti, per individuare a colpo d’occhio chi ti sta alle calcagna sull’intero tuo perimetro.
Controlli automatici (cron)
Per automatizzare i controlli, attiva l’URL del cron dal pianificatore di attività del tuo hosting (cron o2switch, OVH, ecc.). L’URL, protetto da un token, è mostrato in sola lettura nella configurazione.
A ogni passaggio, il cron elabora un lotto di parole chiave dovute (secondo la dimensione del lotto configurata), distanzia le chiamate per rispettare il tuo provider, poi applica il tuo periodo di ritenzione purgando i controlli vecchi. Due parametri facoltativi sono accettati sull’URL: limit (numero di parole chiave da elaborare) e id_shop (negozio mirato in multinegozio).
Il token del cron protegge l’endpoint contro le chiamate non autorizzate. Non diffonderlo pubblicamente. Ogni richiesta senza il token corretto viene rifiutata.
Avvisi
Quando gli avvisi sono attivati, SERP Tracker invia un’e-mail (modelli HTML e testo, in francese e inglese) quando una parola chiave subisce un cambiamento significativo:
- ingresso o uscita dal top 3;
- uscita dal top 10;
- perdita di posizione (la parola chiave non appare più);
- calo superiore alla soglia configurata;
- conquista di un featured snippet.
L’e-mail ricorda la parola chiave interessata, la posizione precedente e quella nuova, il motivo o i motivi dell’avviso e l’URL posizionato.
FAQ e risoluzione dei problemi
La dashboard mostra «nessun provider configurato»
Verifica di aver selezionato un provider nel menu a tendina Provider e inserito la chiave corrispondente (o login/password per DataForSEO). Il banner scompare non appena viene rilevato un provider valido.
Le mie parole chiave non si aggiornano automaticamente
Il modulo controlla le posizioni solo quando l’URL del cron viene chiamato. Configura un’attività pianificata presso il tuo hosting per attivare questo URL alla frequenza desiderata (per esempio una volta al giorno). Nel frattempo, il pulsante Avvia tutti i controlli e l’azione Controlla ora permettono controlli manuali.
Una posizione mostra 0
La posizione 0 significa che il tuo dominio non è stato trovato entro la profondità di risultati analizzata. Aumenta eventualmente la profondità nella configurazione, o verifica l’URL di destinazione e il contesto (paese, dispositivo) della parola chiave.
Perché non fare scraping di Google direttamente?
Lo scraping diretto è fragile, viene bloccato in fretta ed è contrario alle condizioni d’uso di Google. Passando per un’API SERP ufficiale, i controlli restano affidabili e conformi. Mantieni il controllo dei costi tramite il tuo account provider.
Come viene calcolato l’indice di visibilità?
Ogni posizione viene convertita in un CTR stimato tramite una curva per posizione, poi l’insieme viene riportato a un punteggio da 0 a 100. È un indicatore di tendenza: sale quando le tue parole chiave avanzano globalmente verso l’alto dei risultati.
È compatibile con PrestaShop 9 e multinegozio?
Sì. Il modulo è compatibile con PrestaShop 8 e 9, e il monitoraggio è isolato per negozio in multinegozio. I controller si appoggiano a ModuleAdminController per restare compatibili tra PS8 e PS9.