PS PrestaShop Intermedio

dfsearchconsole — Google Search Console per PrestaShop

Installazione, connessione a Google in 5 passaggi, sincronizzazione, dashboard, opportunità SEO, impostazioni e aggiornamento dalla 1.x.

Aggiornato Versione del modulo 2.0.0

Presentazione

DataFirefly – Search Console importa i dati di Google Search Console nel back office di PrestaShop 1.7.8, 8 e 9: clic, impressioni, CTR e posizione media per pagina e per query, confronto con il periodo precedente o con l’anno precedente, quota delle ricerche di marca, dispositivi e paesi. A partire da questi dati, il modulo elenca opportunità SEO calcolate con regole esplicite, mostrate a schermo, e collega ogni URL al prodotto, alla categoria o alla pagina CMS corrispondente, con un link alla relativa modifica.

Il modulo aggiunge il menu Migliora → Opportunità SEO con cinque schede: Dashboard, Opportunità, Pagine, Query e Connessione e impostazioni. L’accesso a Google avviene in sola lettura (webmasters.readonly) con il proprio client OAuth Google Cloud.

Dashboard di Search Console in PrestaShop: clic, impressioni, CTR e posizione media confrontati con il periodo precedente, con grafico giornaliero
Dashboard di Search Console in PrestaShop

Questo modulo non è affiliato a Google né approvato da Google. Google Search Console è un marchio di Google LLC. Il modulo non prevede alcun aumento di clic o di posizione: misura e classifica, i risultati dipendono da Google e dai concorrenti.

Installazione

  1. Scaricare dfsearchconsole-2.0.0.zip dal proprio account cliente DataFirefly.
  2. Nel back office: Moduli → Gestione moduli → Carica un modulo, quindi scegliere il file.
  3. Aprire Migliora → Opportunità SEO → Connessione e impostazioni.

Il modulo crea le proprie tabelle ps_dfsrch_*, le proprie chiavi di configurazione DFSRCH_* e le proprie schede AdminDfSrch*. Non condivide alcuna tabella, chiave o scheda con il modulo DataFirefly Search Console Connect (dfgscconnect): i due possono essere installati insieme e disinstallati separatamente.

Requisiti: PrestaShop da 1.7.8 a 9.x, PHP da 7.4 a 8.5 (testato su PHP 7.4, 8.1 e 8.5), estensioni cURL e OpenSSL, una proprietà verificata in Google Search Console.

Connessione a Google

La scheda Connessione e impostazioni presenta una Procedura guidata di connessione in cinque passaggi. La prima volta occorrono circa dieci minuti.

Procedura di connessione in 5 passaggi: client OAuth Google Cloud, URI di reindirizzamento da copiare, accesso in sola lettura, proprietà e test
Procedura di connessione in 5 passaggi

1. Creare il client OAuth in Google Cloud Console

  1. Su console.cloud.google.com, creare un progetto (o sceglierne uno esistente).
  2. API e servizi → Libreria: abilitare Google Search Console API.
  3. Schermata consenso OAuth (Google Auth Platform): tipo di utente Esterno (o Interno con Google Workspace), aggiungere l’ambito https://www.googleapis.com/auth/webmasters.readonly e, finché l’app è nello stato «Test», aggiungere il proprio account Google come utente di test.
  4. Credenziali (Client): creare un ID client OAuth di tipo Applicazione web e incollare in URI di reindirizzamento autorizzati l’URI mostrato dal modulo (pulsante Copia).

L’URI deve essere identico carattere per carattere (protocollo, www, prefisso della lingua). In caso contrario Google mostra l’errore redirect_uri_mismatch. Non è necessaria alcuna origine JavaScript autorizzata. Se il dominio, l’HTTPS o la lingua predefinita del negozio cambiano, cambia anche l’URI: il modulo lo segnala ed è necessario dichiararlo di nuovo.

2. Inserire l’ID client e il client secret

Incollare l’ID client e il Client secret, quindi Salva il client OAuth. Il secret viene memorizzato in forma crittografata e non viene più visualizzato; lasciare il campo vuoto per mantenerlo durante una modifica.

3. Collegarsi con Google

Collega con Google apre la schermata di consenso di Google. Selezionare l’accesso a Search Console: senza questa casella, il modulo rifiuta la connessione e lo spiega. La richiesta è monouso, legata al dipendente e al negozio, e protetta da PKCE; lo scambio del codice avviene nel back office.

Stato «Test» dell’app Google Cloud: Google invalida l’autorizzazione dopo 7 giorni. Il modulo mostra allora Connessione Google da rinnovare in tutte le sue pagine; fare clic su Ricollega. Per evitare queste riconnessioni, impostare l’app su «In produzione» nella Schermata consenso OAuth; Google potrebbe quindi richiedere una verifica dell’app.

4. Scegliere la proprietà di questo negozio

L’elenco riporta le proprietà accessibili con il proprio account e il proprio livello di accesso. Quella corrispondente al dominio del negozio è contrassegnata da una stella. Una proprietà di dominio (sc-domain:) copre tutti i sottodomini; le pagine che non appartengono al negozio sono indicate come «Altro sito». Se si cambia proprietà, i dati della proprietà precedente vengono eliminati.

5. Testare, poi sincronizzare

Testa la connessione verifica l’URI di reindirizzamento, l’autorizzazione Google (token rinnovato), l’elenco delle proprietà e la lettura dei dati degli ultimi 28 giorni. Sincronizza ora avvia la prima sincronizzazione con una barra di avanzamento.

Sincronizzazione

La prima sincronizzazione importa i totali giornalieri degli ultimi 16 mesi, poi le pagine e le query del periodo analizzato (7, 28, 90 o 180 giorni) e del periodo precedente di pari durata, i dispositivi e i paesi. Procede per fasi: le schermate continuano a mostrare gli ultimi dati completi fino al termine. Risincronizzazione completa reimporta tutto, anche in assenza di un nuovo giorno.

  • I giorni sono conteggiati secondo l’ora del Pacifico (Los Angeles), come in Search Console.
  • I dati arrivano con 2-3 giorni di ritardo; il modulo importa solo i giorni definitivi.
  • In seguito vengono importati solo i giorni mancanti. Se non è disponibile alcun nuovo giorno, l’analisi non viene ricalcolata.
  • Google anonimizza alcune query rare: i totali per query sono inferiori ai totali del sito.
  • Quota Google (errore 429) o indisponibilità (errori 5xx): il modulo riprova con un’attesa crescente, poi mette la sincronizzazione in attesa; questa riprende dalla stessa fase all’esecuzione successiva (Sincronizzazione in attesa).
  • Cataloghi di grandi dimensioni: l’importazione avviene a blocchi di 25.000 righe, entro il limite di Righe importate per periodo.

Sincronizzazione automatica (cron)

Richiamare ogni ora l’URL mostrato in Sincronizzazione automatica (cron). Non fa nulla finché i dati sono aggiornati, riprende una sincronizzazione in attesa e si interrompe dopo circa cinquanta secondi. Un blocco impedisce due esecuzioni simultanee.

7 * * * * curl -fsS "https://votre-boutique.example/module/dfsearchconsole/cron?token=…" >/dev/null 2>&1

L’URL è specifico di ogni negozio e funziona come una password: solo i dipendenti autorizzati a modificare la scheda possono vederlo. Genera un nuovo URL invalida immediatamente quello precedente. La risposta contiene solo uno stato, mai dati.

Dashboard

Scegliere la durata (da 7 giorni a 16 mesi) e il confronto (vs periodo precedente o vs anno precedente). I quattro indicatori (clic, impressioni, CTR medio, posizione media) e la curva provengono dai totali giornalieri del sito, query anonimizzate incluse; la linea tratteggiata rappresenta il periodo di confronto.

Clic di marca e non di marca, dispositivi, paesi, principali opportunità e numero di query per fascia di posizione
Clic di marca e non di marca

Sotto la curva: Di marca e non di marca (a partire dai nomi di marca inseriti nelle impostazioni), Dispositivi, Paesi, Opportunità principali, Query per posizione (1-3, 4-10, 11-20, 21-50, oltre) e le pagine che guadagnano o perdono più clic.

Opportunità

Dopo ogni sincronizzazione, il modulo calcola sei tipi di opportunità. La regola di ogni tipo, con le soglie impostate, è mostrata in cima all’elenco (Come vengono rilevate le opportunità?).

Opportunità SEO per tipo: vicine alla top 10, CTR basso, pagine che perdono clic, cannibalizzazione, URL da sistemare, meta tag mancanti
Opportunità SEO per tipo
Tipo Regola (soglie predefinite)
Vicino alla top 10 Query non di marca con posizione media da 11 a 20, almeno 50 impressioni nel periodo.
CTR basso per la posizione Query non di marca nella top 10 il cui CTR è inferiore al 50% del CTR mediano delle query non di marca del negozio alla stessa posizione. Se il negozio ha meno di 8 query confrontabili, viene utilizzata una curva di riferimento indicativa, che viene segnalata.
Pagine in calo di clic Pagina che ha perso almeno il 30% dei clic (e ne aveva almeno 20); causa probabile dedotta da posizione, impressioni e CTR, oppure pagina non disponibile.
Cannibalizzazione Query non di marca per cui almeno due oggetti diversi ricevono ciascuno il 15% o più delle impressioni. Gli URL dello stesso prodotto o della stessa categoria (combinazioni, paginazione, parametri) vengono raggruppati.
URL da ripulire URL visto da Google che non è l’URL attuale del relativo oggetto: vecchio URL, URL di combinazione, parametri di tracciamento, prodotto o pagina eliminati o disattivati.
Meta tag mancanti Prodotto, categoria o pagina CMS in posizione 20 o migliore il cui meta title o la cui meta description è vuoto nella lingua dell’URL.

Ogni scheda mostra i Dati misurati (posizioni prima e ora, CTR mediano di confronto, parole della query assenti dal meta title, lunghezza della descrizione…) e Cosa si può fare, con un pulsante verso la modifica del prodotto, della categoria o della pagina CMS.

Query con CTR basso per la sua posizione, confrontato con il CTR mediano delle query del negozio, con fatti misurati e azioni
Query con CTR basso per la sua posizione
Pagina che perde clic: causa probabile (posizione peggiore), query che hanno perso di più e verifiche suggerite
Pagina che perde clic
Cannibalizzazione: una query condivisa tra una categoria e un prodotto, quota di impressioni di ogni pagina e azioni
Cannibalizzazione

La Priorità serve solo a ordinare l’elenco (impressioni interessate e distanza dall’obiettivo); non è una previsione. Segna come completata (con una nota facoltativa) conserva le misurazioni del momento: la scheda Monitoraggio delle azioni completate le confronta con le sincronizzazioni successive. Ignora rimuove l’opportunità dall’elenco Da fare; Riapri la ripristina. Questi stati vengono conservati da una sincronizzazione all’altra.

Le opportunità vengono ricalcolate non appena si modifica una soglia o i nomi di marca, senza una nuova chiamata a Google. Gli elenchi e l’esportazione CSV seguono i filtri visualizzati.

Pagine

Ogni URL visto da Google viene associato al relativo oggetto PrestaShop in base alle regole degli URL del negozio (comprese le regole personalizzate), alla lingua, alle combinazioni e ai parametri. Filtri: tipo (prodotto, categoria, pagina CMS, marca, fornitore, home page…), andamento (in crescita, in calo, nuova, scomparsa) e osservazione (Non è l’URL attuale, URL di combinazione, parametri, Oggetto eliminato, Disattivato, Altro sito).

Pagine viste in Google associate a prodotti, categorie e pagine CMS, con variazione dei clic, CTR, posizione e link di modifica
Pagine viste in Google associate a prodotti

Il Dettaglio pagina mostra gli indicatori a confronto, le query della pagina, i tag SEO nella lingua dell’URL e le opportunità che la riguardano.

Dettaglio di una pagina prodotto: KPI confrontati, query della pagina, tag SEO della lingua e opportunità
Dettaglio di una pagina prodotto

Query

Le query sono raggruppate per tutte le pagine. Filtri: di marca o non di marca, fascia di posizione (top 3, da 4 a 10, da 11 a 20, oltre), andamento e Su più pagine. Il Dettaglio query elenca le pagine che compaiono per quella query.

Query non di marca ordinate per impressioni, con filtri per posizione, tendenza e query presenti su più pagine
Query non di marca ordinate per impressioni

Impostazioni di analisi

Impostazione Predefinito Effetto
Periodo analizzato 28 giorni 7, 28, 90 o 180 giorni, confrontati con il periodo precedente di pari durata. Si applica dalla sincronizzazione successiva.
Impressioni minime 50 Al di sotto, una query o una pagina non costituisce un’opportunità.
Posizioni «Vicino alla top 10» da 11 a 20 Intervallo di posizioni della regola «Vicino alla top 10».
Soglia CTR basso (% della mediana) 50 CTR inferiore a questa percentuale del CTR mediano alla stessa posizione.
Pagina in calo di clic 30% e 20 clic Perdita minima e numero minimo di clic nel periodo precedente.
Cannibalizzazione: quota minima per pagina (%) 15 Quota delle impressioni che ogni pagina deve ricevere.
Righe importate per periodo 100.000 Limite massimo di righe pagina × query per periodo (da 5.000 a 1.000.000).
Storico giornaliero conservato (mesi) 16 I giorni più vecchi vengono eliminati a ogni sincronizzazione.
Nomi di marca vuoto Separati da virgole (accenti e maiuscole ignorati). Le query di marca sono escluse dalle opportunità e dal CTR mediano di confronto.

Permessi, multinegozio e sicurezza

  • Permessi PrestaShop per scheda: la visualizzazione consente di consultare ed esportare in CSV; la modifica consente di collegare, sincronizzare, configurare e cambiare gli stati; l’eliminazione consente di cancellare i dati importati. Un dipendente con accesso in sola lettura vede i campi disattivati e non vede l’URL cron. Tutte le azioni passano attraverso un modulo protetto da un token di sicurezza.
  • Multinegozio: connessione, proprietà, URL cron, impostazioni e dati sono specifici di ogni negozio. Selezionare un negozio nel selettore; il contesto «Tutti i negozi» mostra Selezionare un negozio.
  • Client secret, token OAuth e token cron sono crittografati in AES-256-GCM con la chiave del negozio; non compaiono mai nelle pagine né nei messaggi di errore.
  • I dati transitano solo tra il server del negozio e Google. Nessuna terza parte, nessuna IA esterna.

Risoluzione dei problemi

«Connessione Google da rinnovare»

Google rifiuta l’autorizzazione salvata: revocata, scaduta oppure app nello stato «Test» (7 giorni). Fare clic su Ricollega. I dati già importati restano disponibili.

«La Google Search Console API non è abilitata»

Abilitare Google Search Console API in API e servizi → Libreria del progetto, attendere qualche minuto, quindi riprovare.

Questo account Google non ha accesso alla proprietà

Aggiungere l’account come utente della proprietà in Search Console (Impostazioni → Utenti e autorizzazioni) oppure scegliere un’altra proprietà.

Sincronizzazione in attesa

Google limita temporaneamente le richieste (quota) oppure non è disponibile. La sincronizzazione riprende alla successiva esecuzione del cron, oppure subito con Riprendi ora.

Le chiavi DFSRCH_TEST_API_BASE / DFSRCH_TEST_AUTH_BASE reindirizzano le chiamate verso un simulatore locale di sviluppo. Sono vuote per impostazione predefinita e non hanno un campo nel modulo; svuotarle prima di un utilizzo reale.

Aggiornamento dalla versione 1.x

Caricare lo zip 2.0.0 sopra la versione installata. L’aggiornamento riprende le impostazioni, l’ID client e il client secret, i token (non è necessario ricollegarsi), la proprietà, l’URL cron (stesso token), le pagine, le query e gli stati «completata / ignorata». Elimina poi le vecchie tabelle ps_dfgsc_sync, ps_dfgsc_page, ps_dfgsc_query e ps_dfgsc_opportunity (solo se la loro struttura è quella della 1.x), le vecchie chiavi di configurazione della 1.x, le sue vecchie schede e i suoi vecchi file. La chiave DFGSC_CRON_TOKEN viene lasciata al suo posto se è installato il modulo DataFirefly Search Console Connect. Avviare quindi una sincronizzazione per caricare lo storico giornaliero, i dispositivi e i paesi.

Disinstallazione

La disinstallazione revoca l’autorizzazione Google, quindi elimina solo le tabelle ps_dfsrch_*, le chiavi DFSRCH_* e le schede del modulo. È possibile anche rimuovere l’accesso dell’app nelle impostazioni di sicurezza del proprio account Google.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza