Categorie di prodotto Google — Download della tassonomia
Prima di poter assegnare le categorie di prodotto Google alle categorie del tuo negozio, devi scaricare la lista ufficiale della tassonomia Google. Questo download in un clic recupera la lista direttamente da Google e la salva in locale, in modo che il completamento automatico delle categorie funzioni anche offline.
Disponibile dalla v1.0.3
Panoramica
Google mantiene una lista standardizzata di categorie di prodotto — nota come Google Product Taxonomy — che Facebook e Instagram utilizzano per classificare i prodotti nel tuo catalogo. Ogni categoria ha un ID numerico e un percorso leggibile come Apparel & Accessories > Clothing > Dresses.
Il modulo ha bisogno di una copia locale di questa lista per alimentare il campo di completamento automatico nel pannello Associazione categorie di prodotto Google. Senza di essa, il pannello non è disponibile e non è possibile mappare le categorie del negozio a quelle Google.
Il file della tassonomia viene scaricato dai server pubblici di Google e salvato nella cartella del modulo come downloads/{lang}.txt. Il modulo tenta prima di recuperare la tassonomia nella lingua predefinita del negozio (ad esempio fr-FR.txt per i negozi in francese), per poi ricorrere all'inglese (en-US.txt) se non è disponibile una versione localizzata.
Come scaricare o aggiornare la lista
- Vai su Moduli > Gestione moduli, trova Facebook & Instagram Product Catalogue Feed Pro e clicca su Configura.
- Nel menu di navigazione a sinistra, clicca su Lista categorie di prodotto Google (la scheda con l'icona di download).
- Se la lista non è mai stata scaricata, il pannello mostra un messaggio che ti invita a farlo. Se è già presente una lista, il pannello mostra la data dell'ultimo aggiornamento.
- Clicca su Scarica categorie di prodotto Google.
- Il modulo recupera il file più recente dai server di Google e lo salva. Al termine del download viene mostrato un banner verde di conferma.
Una volta completato il download, il pannello Associazione categorie di prodotto Google diventa attivo e puoi iniziare a mappare le categorie del tuo negozio.
Quando aggiornare la lista
Google aggiorna la sua tassonomia più volte l'anno — vengono aggiunte nuove categorie, alcune vengono rinominate e quelle obsolete vengono rimosse. Il pannello mostra la data del file corrente, così puoi valutare quanto è aggiornato.
Aggiorna la lista quando:
- Il file attuale ha più di qualche mese.
- Noti che una categoria di cui hai bisogno non compare nei suggerimenti del completamento automatico.
- Google annuncia un aggiornamento della tassonomia (pubblica le note di rilascio nel Commerce Help Center).
- Hai appena installato il modulo per la prima volta — la routine di installazione tenta un download automatico, ma aggiornare manualmente conferma che il file sia corrente.
Scaricare la lista più spesso non comporta alcun problema. L'operazione richiede pochi secondi, sostituisce il file locale e non influisce sulle associazioni di categorie già salvate.
Note importanti
Fallback della lingua. Il modulo tenta prima di scaricare la tassonomia nella lingua predefinita del negozio. Ad esempio, un negozio impostato in spagnolo scarica es-ES.txt. Se Google non pubblica un file per quella lingua, il modulo ricorre a en-US.txt. In entrambi i casi il completamento automatico funziona, ma i nomi delle categorie saranno nella lingua del file scaricato con successo.
Connettività del server. Il download si connette a https://www.google.com/basepages/producttype/taxonomy-with-ids.{lang}.txt. Se il tuo server ha restrizioni HTTP/HTTPS in uscita o un firewall che blocca le richieste verso host esterni, il download fallirà. In questo caso, chiedi al tuo provider di hosting di consentire le connessioni in uscita verso www.google.com, oppure scarica manualmente il file da quell'URL e caricalo in modules/facebookproductsfeed/downloads/en-US.txt.
Permessi dei file. Se il modulo non riesce a scrivere nella cartella downloads/, verrà mostrato un errore che ti chiede di verificare i permessi di scrittura su file e cartelle. La directory downloads/ all'interno del modulo deve essere scrivibile dall'utente del server web (in genere www-data).
Le associazioni di categorie vengono preservate. Aggiornare la lista della tassonomia aggiorna soltanto il file di testo locale usato per il completamento automatico. Non modifica né rimuove nessun ID categoria Google già assegnato alle categorie del negozio nel database.
Multi-shop. Il file scaricato è condiviso tra tutti i negozi. Le associazioni di categorie di ciascun negozio sono salvate separatamente, ma tutti usano lo stesso file di tassonomia per i suggerimenti del completamento automatico.
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Il download fallisce con un errore di rete | Verifica che il tuo server possa raggiungere www.google.com sulla porta 443. Contatta il tuo provider se le connessioni in uscita sono bloccate. |
| Errore "Impossibile creare il file" | La cartella downloads/ non è scrivibile. Imposta i permessi a 755 (o 775) e assicurati che sia di proprietà dell'utente del server web. |
| Il completamento automatico delle categorie non mostra risultati dopo il download | Svuota la cache del Back Office di PrestaShop (Parametri avanzati > Prestazioni > Svuota la cache) e ricarica la pagina di configurazione. |
| Il pannello mostra ancora "devi scaricare" dopo un download riuscito | La conferma è stata mostrata ma la pagina non è stata ricaricata. Premi F5 o torna alla scheda Lista categorie di prodotto Google. |
| Il file scaricato è in inglese ma il mio negozio è in un'altra lingua | Google potrebbe non pubblicare un file di tassonomia per la lingua del tuo negozio. La lista in inglese viene utilizzata come fallback — tutti gli ID categoria sono universali indipendentemente dalla lingua. |
Domande frequenti
Devo scaricare nuovamente la lista della tassonomia dopo aver aggiornato il modulo?
No. Il file viene mantenuto attraverso gli aggiornamenti del modulo. Scarica una copia aggiornata solo quando vuoi recuperare categorie nuove o rinominate da Google.
Cosa succede alle mie mappature di categorie esistenti se aggiorno la lista della tassonomia?
Nulla. Le tue mappature sono salvate nel database tramite l'ID categoria Google, non tramite il nome. Aggiornare il file di testo locale non modifica quegli ID né rimuove alcuna associazione.
Posso usare il pannello Associazione categorie di prodotto Google senza scaricare la lista?
No. L'albero delle categorie e il completamento automatico nel pannello Associazione vengono visualizzati solo quando è presente un file di tassonomia in downloads/. Il download è un prerequisito da eseguire una sola volta.
Il modulo mi notifica quando Google aggiorna la tassonomia?
No. Non è prevista alcuna notifica automatica. Controlla periodicamente la data dell'ultimo aggiornamento mostrata nel pannello e aggiorna la lista quando ha più di qualche mese.
Perché il completamento automatico mostra i nomi delle categorie in inglese anche se il mio negozio è in francese?
Google pubblica file di tassonomia localizzati solo per alcune lingue. Se non è disponibile un file per la lingua francese (fr-FR.txt), il modulo scarica en-US.txt. Gli ID categoria sono gli stessi in tutte le lingue, quindi il tuo feed rimane valido indipendentemente dalla lingua del file locale.