SERP Tracker — Guida completa
Installare, configurare e usare il monitoraggio delle posizioni su Google: Search Console o una SERP API, parole chiave per paese, lingua e dispositivo, dashboard, scheda parola chiave, concorrenti, avvisi, cron, quote e costi, per PrestaShop da 1.7.8 a 9.
Presentazione
Il modulo SERP Tracker (dfserptracker) monitora le posizioni del Suo negozio nei risultati di Google, parola chiave per parola chiave, direttamente nel back-office di PrestaShop: paese (gl), lingua (hl), computer o mobile, località facoltativa. Conserva la cronologia di ogni rilevazione, traccia le curve di andamento, confronta le Sue posizioni con quelle dei concorrenti che sceglie e La avvisa via e-mail dei cambiamenti importanti, tenendo sotto controllo il numero di richieste e il loro costo.

Il modulo non ha alcun effetto sul Suo negozio lato visitatori: aggiunge solo pagine di back-office (menu Migliora > Monitoraggio posizioni) e un URL di attività pianificata protetto da token.
Da dove provengono le posizioni?
SERP Tracker non interroga mai Google direttamente. Le norme antispam di Google classificano l’estrazione automatizzata dei risultati a fini di monitoraggio delle posizioni come traffico generato automaticamente: uno strumento installato sul Suo server esporrebbe il Suo indirizzo IP a un blocco. Scelga quindi una fonte in Impostazioni > Fonte delle posizioni:
- Google Search Console (API ufficiale di Google, gratuita): posizione media delle Sue pagine negli ultimi 7 giorni completi, con 2-3 giorni di ritardo, solo per le ricerche in cui il Suo negozio è stato mostrato. Nessun dato sui concorrenti.
- Una SERP API (DataForSEO, SerpApi, ValueSERP, Serper.dev): posizione in tempo reale, altri siti della pagina, snippet in primo piano, «Altre domande», local pack. Questi fornitori raccolgono autonomamente le pagine dei risultati, alle proprie condizioni e sotto la propria responsabilità; sono a pagamento per richiesta.
- Demo: posizioni fittizie generate localmente per scoprire il modulo, senza alcuna richiesta. Un banner viola lo ricorda su tutte le pagine.

Compatibilità
- PrestaShop da 1.7.8 a 9.x (testato su 1.7.8.11, 8.2.1 e 9.1.5)
- PHP da 7.4 a 8.5, estensioni cURL e OpenSSL
- Negozio singolo e multinegozio (parole chiave, dominio, avvisi e proprietà Search Console per negozio)
- Back-office ed e-mail in 8 lingue: FR, EN, ES, DE, IT, NL, PL, PT
- Compatibile con l’hosting condiviso: un semplice URL da chiamare una volta al giorno, senza Composer né servizi esterni
Installazione e aggiornamento
- In Moduli > Gestione moduli, clicchi su Carica un modulo e scelga
dfserptracker-2.0.0.zip. - Apra Migliora > Monitoraggio posizioni: una schermata di benvenuto La guida in tre passaggi (fonte, parole chiave, pianificazione).
Dalla 1.0.0: carichi semplicemente il nuovo zip. Le Sue parole chiave e tutta la loro cronologia vengono conservate; le Sue chiavi API vengono cifrate e i vecchi valori in chiaro vengono eliminati; il menu viene spostato sotto Migliora e i profili che vedevano la vecchia dashboard mantengono l’accesso alle nuove pagine. Per prudenza sui costi, una profondità superiore a 30 viene riportata a 30 (modificabile).
Scegliere e configurare la fonte
Google Search Console (consigliato per iniziare)
- In Google Cloud, crei un account di servizio e scarichi la sua chiave in formato JSON.
- In Search Console, aggiunga l’indirizzo e-mail dell’account di servizio come utente della proprietà (Impostazioni > Utenti e autorizzazioni).
- In Impostazioni > Fonte delle posizioni, scelga Google Search Console, incolli la chiave JSON e la proprietà (
sc-domain:tuo-dominio.itohttps://www.tuo-dominio.it/). - Clicchi su Verifica la connessione (gratuito).
SERP API
- DataForSEO: login API e password API (non quelli dell’account). Fatturato per pagina di 10 risultati; il costo effettivo restituito dall’API viene registrato.
- SerpApi: chiave API; una ricerca fatturata per pagina di 10 risultati. Verifica della connessione gratuita (ricerche rimanenti).
- ValueSERP: chiave API; un credito per pagina di 10 risultati.
- Serper.dev: chiave API; solo risultati per computer (la documentazione dell’API non è pubblica).
Le chiavi vengono cifrate con la chiave del Suo negozio prima di essere salvate. Non vengono mai rivisualizzate (il campo indica solo «Salvato»), non vengono mai scritte nei log e i messaggi di errore vengono ripuliti da qualsiasi identificativo. Lasci un campo vuoto per mantenere il valore memorizzato, selezioni «Elimina il valore memorizzato» per cancellarlo.
Impostazioni del monitoraggio
- Dominio da cercare nei risultati: il dominio del negozio (il prefisso
www.viene ignorato). Opzione: contare anche i sottodomini. - Profondità analizzata: da top 10 a top 100. Da settembre 2025 Google mostra 10 risultati per pagina: ogni pagina aggiuntiva è una richiesta fatturabile in più. La lettura si ferma alla pagina in cui compare il Suo negozio.
- Valori predefiniti per le nuove parole chiave: paese, lingua, dispositivo, frequenza.
Aggiungere parole chiave
In Parole chiave > Aggiungi parole chiave:
- Più parole chiave: una per riga (500 al massimo), con paese, lingua, frequenza, un gruppo, una località facoltativa e il dispositivo (computer, mobile o entrambi). I duplicati vengono ignorati e una stima del costo su 30 giorni si aggiorna durante l’inserimento.
- Una parola chiave con la sua pagina di destinazione: quando la pagina di destinazione compare nei risultati, viene considerata la sua posizione; altrimenti quella della migliore pagina del Suo dominio.
- Importazione CSV: colonne
keyword;group;country;language;device;target_url;volume;frequency.

L’elenco mostra per ogni parola chiave la posizione, la variazione rispetto alla rilevazione precedente, la tendenza su 30 giorni, la migliore posizione, il volume e la pagina posizionata, con filtri, ordinamento e azioni di gruppo (verifica, metti in pausa, riprendi, gruppo, frequenza, elimina). Sono disponibili due esportazioni CSV: le parole chiave con le loro ultime posizioni e la cronologia su 90 giorni.

La dashboard
- Visibilità (su 100): stima del tasso di clic atteso delle Sue parole chiave rispetto alla situazione in cui fossero tutte in prima posizione, secondo una curva di CTR media pubblica. Non è una misura del traffico.
- Posizione media (solo parole chiave posizionate), Top 3, Pagina 1, variazioni nel periodo.
- Andamento: visibilità, posizione media o fasce di posizioni giorno per giorno; distribuzione del giorno.
- Maggiori guadagni e perdite, parole chiave vicine alla prima pagina o alla top 3 (posizioni da 4 a 20, ordinate per volume), elementi della pagina dei risultati, richieste e costi, ultime esecuzioni.
Filtri: periodo (da 7 giorni a 1 anno), gruppo, dispositivo, paese.


La scheda di una parola chiave
Clicchi su una parola chiave per vedere la sua posizione attuale, le variazioni su 7 e 30 giorni, la migliore posizione, la curva della sua cronologia confrontata con i concorrenti seguiti, l’ultima pagina dei risultati, i cambi della pagina posizionata (più pagine del negozio che si alternano sulla stessa ricerca possono farsi concorrenza) e le ultime rilevazioni. Pulsanti Verifica ora, Modifica ed Elimina.


Concorrenti
Segua fino a 8 domini concorrenti (sottodomini inclusi). La loro posizione viene registrata a ogni verifica; quando se ne aggiunge uno, le sue posizioni passate vengono ricostruite a partire dalle pagine dei risultati già memorizzate (top 20). La pagina mostra la quota di visibilità stimata di ogni sito sulle Sue parole chiave, il numero di parole chiave in cui ciascun concorrente è sopra o sotto di Lei, l’andamento nel tempo e gli altri siti trovati sulle Sue parole chiave, con un pulsante Segui.


Con Google Search Console questa pagina rimane vuota: Search Console fornisce dati solo sulle Sue pagine.
Avvisi
In Avvisi, scelga i destinatari (5 al massimo) e le regole: calo o guadagno di almeno N posizioni, entrata nella top 3 o uscita dalla top 3, arrivo in prima pagina o uscita dalla prima pagina, scomparsa dai risultati analizzati, ritorno, posizionamento di un’altra pagina del negozio, snippet in primo piano ottenuto o perso.
- Un’e-mail raggruppata dopo ogni esecuzione (una parola chiave per riga) o un riepilogo giornaliero a partire dall’ora scelta;
- intervallo minimo tra due e-mail; lo stesso avviso non viene mai ripetuto per la stessa parola chiave entro 24 ore;
- cronologia degli avvisi conservata anche quando le e-mail sono disattivate, pulsante Invia un’e-mail di prova.


Pianificazione, limiti e costi
Le verifiche vengono avviate da un URL cron da chiamare una volta al giorno (ad esempio alle 6:00) dalle attività pianificate del Suo hosting. Il token può essere inviato nell’intestazione X-DFSERP-Token per non comparire nei log del server; Genera un nuovo URL invalida quello precedente.
- Frequenza per parola chiave (ogni giorno, ogni 3 giorni, ogni settimana, ogni 2 settimane, ogni mese): vengono verificate solo le parole chiave in scadenza.
- Parole chiave per chiamata, durata massima di una chiamata, pausa tra due richieste, numero massimo di richieste al giorno e budget mensile.
- Ripresa: la chiamata successiva riprende con le parole chiave non ancora verificate. Una parola chiave in errore viene ritentata più tardi (1 h, 2 h, 4 h… 24 h); una chiave rifiutata o una quota esaurita interrompe l’esecuzione senza penalizzare le parole chiave.
- Costo stimato per 30 giorni per ogni fornitore, in base al numero di parole chiave, alla loro frequenza e alla profondità, con i prezzi per 1.000 richieste che inserisce (tariffe pubbliche per impostazione predefinita). Fa fede la fattura del fornitore.

Il pulsante Verifica le parole chiave in scadenza nell’intestazione avvia le verifiche anche dal back-office, in piccoli lotti, con una barra di avanzamento.
Dati e riservatezza
- Cronologia conservata da 90 giorni a 3 anni (o senza limite), eliminata automaticamente una volta al giorno.
- Permessi per profilo dipendente: visualizza per consultare, modifica per aggiungere parole chiave, cambiare le impostazioni e avviare verifiche (fatturate), elimina per eliminare.
- Con il fornitore demo, Genera 90 giorni di cronologia demo popola i grafici; Elimina le rilevazioni demo le cancella prima di passare a una fonte reale.
- Alla disinstallazione, le tabelle, le impostazioni e le schede del modulo vengono eliminate.

FAQ e risoluzione dei problemi
Le posizioni sono esatte?
Sono rilevazioni puntuali: la stessa ricerca può dare risultati diversi a seconda del luogo, del dispositivo, della personalizzazione e del momento. Segua le tendenze piuttosto che un valore isolato. Con Search Console, il valore è una posizione media su più giorni.
Il modulo migliora il mio posizionamento?
No: misura. La aiuta a individuare le parole chiave vicine alla prima pagina, le pagine che si fanno concorrenza e i cali da tenere d’occhio; nessun guadagno di posizione è garantito.
Una parola chiave mostra «–»
Il Suo dominio non è stato trovato nella profondità analizzata. Verifichi il dominio, la pagina di destinazione e il contesto (paese, lingua, dispositivo), oppure aumenti la profondità tenendo conto del costo.
Non si aggiorna nulla
Verifichi che l’URL cron venga chiamato (la data dell’ultima chiamata è indicata nelle impostazioni), che la fonte sia configurata (indicatore verde nell’intestazione) e che il limite giornaliero o il budget non sia stato raggiunto (stato delle ultime esecuzioni nella dashboard). Se il negozio è in manutenzione, aggiunga l’indirizzo IP del Suo server agli IP autorizzati.
Quanto costano le verifiche?
Search Console è gratuita (nei limiti di Google). Per una SERP API, il costo dipende dal numero di parole chiave, dalla loro frequenza e dalla profondità: la tabella «Costo stimato per 30 giorni» nelle impostazioni lo calcola per ogni fornitore. Una frequenza settimanale divide il costo per 7.