# Guide all'acquisto PrestaShop 8 e 9: documentazione > Presentazione Il modulo crea pagine di guida all'acquisto a partire dal tuo catalogo. Ogni guida risponde a una domanda del cliente, per esempio «Quale robot aspirapolvere scegliere per un appartamento… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/buying-guide-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/buying-guide-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/buying-guide-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/buying-guide-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/buying-guide-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/buying-guide-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/buying-guide-prestashop/index.md) - Indice: ## Presentazione Il modulo crea pagine di guida all'acquisto a partire dal tuo catalogo. Ogni guida risponde a una domanda del cliente, per esempio «Quale robot aspirapolvere scegliere per un appartamento con animali?». Scegli i prodotti confrontati e i criteri, il modulo calcola un punteggio su 100 per ogni prodotto, individua tre selezioni e genera classifica, tabella comparativa, statistiche e FAQ. La classifica viene ricalcolata quando il catalogo cambia. ## Installazione 1. In **Moduli > Gestione moduli**, fai clic su **Carica un modulo** e seleziona `dfbuyingguide-1.1.0.zip`. 2. L'installazione crea la scheda **Catalogo > Guide all'acquisto**, le tabelle del modulo e la cartella `img/dfbuyingguide/` per le immagini di copertina. 3. Il pulsante **Configura** del modulo apre direttamente questa scheda. Dalla versione 1.0.0 basta caricare lo ZIP 1.1.0: lo script di aggiornamento aggiunge le colonne e le tabelle delle statistiche senza toccare le tue guide. ## Impostazioni generali Il pannello **Impostazioni**, sotto l'elenco delle guide, contiene: - **Prefisso URL**: `guides` di default. Le guide si trovano in `/guides/url-della-guida` e l'indice di tutte le guide in `/guides`. - **Età massima di una classifica**: 12 ore di default. Superato questo tempo, la classifica viene ricalcolata alla visita successiva anche senza modifiche al catalogo, così segue le promozioni programmate. - **Prodotti analizzati per guida**: 300 di default. I prodotti più venduti del perimetro vengono analizzati per primi. Aumentalo per le categorie grandi, fino a 5.000. - **Mostra il badge della guida nelle pagine prodotto**: i prodotti con una selezione o un posto nei primi 3 mostrano un link alla guida. - **Mostra le guide nelle pagine categoria**: un blocco in fondo alle categorie elenca le guide il cui perimetro contiene la categoria. - **Misura pubblico e vendite**: attiva le statistiche e il cookie di attribuzione `dfbg_attr` (vedi sotto). ## Creare una guida Fai clic su **Aggiungi una guida all'acquisto**. I campi principali: - **Titolo**: scrivilo come la domanda del cliente. Una guida è pubblicata solo nelle lingue in cui ha un titolo. - **URL semplificato**: generato dal titolo se resta vuoto. - **Immagine di copertina**: mostrata in cima alla guida, nella pagina delle guide e nelle condivisioni social. Formato orizzontale, almeno 1.200 px di larghezza. Viene ridimensionata a 1.600 px di larghezza al massimo. - **Autore** e **Ruolo dell'autore**: mostrati sotto il titolo e inclusi nei dati strutturati. - **Introduzione**: a chi si rivolge la guida e cosa conta per questo uso. - **Prodotti confrontati**: le categorie del perimetro. Nessuna categoria selezionata significa tutto il catalogo. **Includi sottocategorie** è attivo di default. - **Prezzo minimo** e **Prezzo massimo**: 0 significa nessun limite. Il prezzo è quello mostrato ai visitatori, nella valuta predefinita. Utile per una guida come «i migliori modelli sotto i 300 €». - **Solo prodotti disponibili**: esclude i prodotti esauriti quando la gestione delle giacenze è attiva. - **Prodotti in classifica**: da 1 a 20, 5 di default. Le selezioni sono sempre mostrate, anche fuori da questa classifica. - **Soglia della scelta budget ridotto**: 50% di default (vedi «Le tre selezioni»). - **Consenti ai visitatori di adattare la classifica**, **Mostra la tabella comparativa**, **Mostra le FAQ**. - **Domande aggiuntive**: una domanda per riga, nel formato `Domanda | Risposta`. Vengono aggiunte dopo le domande generate. - **Conclusione**, **Meta titolo** e **Meta descrizione**: il titolo e l'inizio dell'introduzione fanno da valori di default. - **Pubblicata**: una guida non pubblicata resta visibile in anteprima dal back office. Fai clic su **Salva e resta**: sotto il modulo compaiono i pannelli dei criteri, della classifica attuale, del pubblico e dello storico. ## I criteri Senza criteri, i prodotti sono ordinati per vendite. Fai clic su **Aggiungi un criterio** e scegli un tipo. ### Tipi di criteri - **Caratteristica: valori preferiti**: assegni da 0 a 100 punti a ogni valore di una caratteristica, per esempio Materiale: acciaio inox 100, alluminio 70, plastica 30. Dopo il primo salvataggio il modulo mostra tutti i valori della caratteristica con un cursore e pulsanti per compilare tutti i valori in una volta. Un prodotto con più valori conserva il migliore. - **Caratteristica: valore numerico**: il modulo legge il numero contenuto nel valore («90 min», «1.200 W», «2,5 kg») e confronta i prodotti. Scegli in **Valori da preferire** se è meglio il più alto o il più basso. **Valore minimo** e **Valore massimo** escludono i prodotti fuori intervallo o senza valore. **Unità** viene aggiunta ai numeri delle statistiche. - **Prezzo (più basso è meglio)**. - **Vendite (popolarità)**: basato sulle quantità vendute. - **Prodotti recenti**: basato sulla data di inserimento del prodotto. ### Peso, obbligo e testi - **Peso**: da 0 a 10. Il peso 0 mostra il criterio nella tabella comparativa senza usarlo nel punteggio. - **Obbligatorio** (criteri di caratteristica): i prodotti senza questa caratteristica, o con un valore a 0 punti, sono esclusi dalla guida. - **Etichetta mostrata ai visitatori**: se resta vuota si usa il nome della caratteristica. - **Consiglio d'acquisto**: spiega perché il criterio conta. Compare nella sezione «Come scegliere», sopra le statistiche del catalogo. Le frecce dell'elenco dei criteri cambiano il loro ordine nella tabella comparativa e nella sezione «Come scegliere». ## Calcolo del punteggio Per ogni criterio, i valori dei prodotti vengono riportati su una scala da 0 a 100: il miglior prodotto del perimetro ottiene 100 e il peggiore 0 per i criteri numerici, prezzo, vendite e novità, mentre per i criteri di valori valgono i punti che hai assegnato. Il punteggio globale è la media dei punteggi pesata sui pesi dei criteri. I prezzi sono confrontati nella valuta predefinita. Il pannello **Classifica attuale** mostra i primi 20 prodotti con punteggio globale, prezzo, selezione e una colonna di punteggio per criterio. Usalo per regolare i pesi prima di pubblicare. ## Le tre selezioni - **Migliore in assoluto**: il prodotto primo in classifica. - **Miglior rapporto qualità-prezzo**: tra i prodotti meno cari del migliore in assoluto con un punteggio pari almeno al 60% del suo, quello con il miglior rapporto tra punteggio e prezzo. - **Migliore con budget ridotto**: il prodotto meno caro che raggiunge la percentuale impostata in **Soglia della scelta budget ridotto** del punteggio del migliore in assoluto, se costa meno delle altre due selezioni. Una selezione compare solo se un prodotto soddisfa la condizione. I punti di forza di un prodotto sono i criteri con 70 o più (massimo 3), gli aspetti da valutare quelli con 30 o meno (massimo 2). ## Aggiornamento delle classifiche La modifica di un prodotto, di un prezzo specifico, di un valore di caratteristica o di una categoria segna le classifiche da ricalcolare. Un cambio di giacenza segna solo le guide impostate su «Solo prodotti disponibili». Il ricalcolo avviene: - alla visita successiva della guida; - con il cron, se lo programmi; - con il pulsante **Ricalcola ora** di una guida o **Ricalcola ora tutte le classifiche** dell'elenco. ### Cron L'URL del cron è mostrato sopra l'elenco delle guide. Richiamalo ogni ora perché i visitatori non attendano mai un ricalcolo. Aggiungi `&force=1` per ricalcolare tutte le guide. Il pulsante **Nuovo token** sostituisce il token e il vecchio URL smette di funzionare. Esempio: ``` 0 * * * * curl -s "https://tuo-negozio.it/index.php?fc=module&module=dfbuyingguide&controller=cron&token=TUO_TOKEN" > /dev/null ``` ### Data mostrata e storico La data «Classifica aggiornata il» mostrata ai visitatori cambia solo se cambiano i primi posti o le selezioni. Il pannello **Storico delle raccomandazioni** elenca questi cambiamenti con i primi 5 prodotti a ogni data. Gli hook di un modulo non vengono eseguiti per un dipendente il cui profilo non ha il permesso «Visualizza» sul modulo. Se il tuo team modifica il catalogo con un profilo simile, il cron e l'età massima delle classifiche fanno da rete di sicurezza. ## La pagina della guida Nell'ordine: titolo, autore, numero di prodotti confrontati e data di aggiornamento, immagine di copertina, introduzione, sommario, selezioni, classifica, tabella comparativa, sezione «Come scegliere», conclusione, FAQ, una nota sul metodo e le guide correlate (guide pubblicate che condividono una categoria). ### Adattare la classifica Se l'opzione è attiva e la guida ha almeno 2 criteri con peso, un pannello sopra la classifica offre un cursore di importanza per criterio e un cursore di budget massimo. La classifica viene ricalcolata nel browser tra i 20 migliori prodotti, senza ricaricare, e un link riporta alla classifica della guida. Senza JavaScript il pannello resta nascosto. I motori di ricerca vedono sempre la classifica della guida. ### Aggiungi al carrello I prodotti che si aggiungono direttamente al carrello, senza combinazione da scegliere, mostrano un pulsante **Aggiungi al carrello** che usa l'aggiunta al carrello del tema. Gli altri mostrano **Vedi il prodotto**. In modalità catalogo non è mostrato alcun pulsante carrello. ### Anteprima di una guida non pubblicata Il pulsante **Anteprima della guida** apre la pagina con un avviso di anteprima. Il link contiene un token proprio della guida, la pagina è in `noindex` e le statistiche non vengono conteggiate. ### Personalizzare i colori I colori sono definiti da variabili CSS che il tuo tema può sovrascrivere: `--dfbg-accent`, `--dfbg-accent-soft`, `--dfbg-muted`, `--dfbg-line`, `--dfbg-surface`, `--dfbg-low` e `--dfbg-radius`. I caratteri sono quelli del tema. ## Posizionamenti e SEO - **Indice delle guide**: `/guides`, con l'immagine di copertina o il primo prodotto in classifica di ogni guida. - **Pagine categoria**: hook `displayFooterCategory`. - **Pagine prodotto**: hook `displayProductAdditionalInfo`, badge di selezione o «Posizione n. X» con link alla guida. - **Posizione libera**: `{hook h='displayDfBuyingGuides' id_category=12}` in un template del tema. Senza `id_category` vengono elencate tutte le guide. - **Sitemap**: se il modulo nativo gsitemap è installato, l'indice e le guide vengono aggiunti con la data dell'ultimo cambiamento di raccomandazione. - **Dati strutturati**: Article (con autore e immagine), ItemList della classifica e FAQPage. I tag Open Graph sono aggiunti nell'head. - **Multilingua**: canonical, hreflang verso ogni lingua in cui la guida ha un titolo e redirect 301 quando un URL viene aperto in un'altra lingua. ## Pubblico e vendite L'elenco delle guide mostra visualizzazioni e fatturato degli ultimi 30 giorni, e quattro indicatori globali in alto. Ogni guida ha un pannello **Pubblico e vendite** su 30 giorni e dall'inizio: - **Visualizzazioni**: una per visitatore, per guida e per giorno, robot esclusi. - **Clic sui prodotti** e tasso di clic rispetto alle visualizzazioni. - **Clic di aggiunta al carrello** dalla classifica. - **Visitatori che hanno adattato la classifica**. - **Ordini** e tasso di conversione rispetto alle visualizzazioni. - **Fatturato IVA esclusa**: importo IVA esclusa dei prodotti arrivati dalla guida, convertito nella valuta predefinita. ### Attribuzione delle vendite Quando un visitatore clicca su un prodotto da una guida, il cookie proprietario `dfbg_attr` ricorda il prodotto e la guida per 30 giorni. Quando il prodotto entra nel carrello, l'attribuzione viene copiata sul carrello. Alla convalida dell'ordine, anche tramite webhook di pagamento, l'ordine e l'importo IVA esclusa di quel prodotto sono attribuiti alla guida. Sono conteggiati solo gli ordini convalidati (stato pagato o equivalente). Il cookie `dfbg_attr` viene impostato al clic senza passare dal tuo gestore del consenso. Indicalo nella tua cookie policy oppure disattiva **Misura pubblico e vendite**. ## Duplicare una guida L'azione **Duplica** dell'elenco copia la guida con i criteri, i punti per valore, i negozi e l'immagine. La copia viene creata non pubblicata, con un URL con suffisso, e si apre subito per la modifica. ## Multinegozio Ogni guida è associata ai negozi scelti nel suo modulo. Classifiche, storico e statistiche sono calcolati negozio per negozio. ## Risoluzione dei problemi - **«Nessun prodotto corrisponde a questa guida»**: controlla le categorie, la fascia di prezzo, l'opzione di disponibilità e i criteri obbligatori o con soglie. - **Manca un prodotto atteso**: deve essere attivo, visibile nel catalogo e tra i prodotti analizzati. Aumenta «Prodotti analizzati per guida» per le categorie grandi. - **La guida restituisce un errore 404**: non è pubblicata, non ha un titolo in questa lingua o non è associata a questo negozio. - **La classifica non segue una modifica**: fai clic su «Ricalcola ora» e programma il cron. - **L'immagine di copertina viene rifiutata**: verifica che la cartella `img/dfbuyingguide/` sia scrivibile.