SEO Rich Data - installazione e configurazione
Scopo del modulo
Il modulo Kowal_SeoRichData aggiunge a Magento 2 dati strutturati schema.org in formato JSON-LD. I dati generati possono includere prodotti, offerte, prezzi, disponibilità, valutazioni, recensioni, breadcrumbs, dati dell'organizzazione, nome del sito, search box, profili social, FAQ e video.
La configurazione del modulo si trova nel pannello di amministrazione Magento:
Stores > Configuration > Kowal > SEO Rich Data
Requisiti
- Magento 2.
- Accesso alla CLI Magento.
- Accesso al Composer repository con il pacchetto
kowal/module-seo-rich-data. - Pacchetto base richiesto:
kowal/base. - Permessi per eseguire i comandi
bin/magento.
Installazione tramite Composer
- Aggiungi il repository del pacchetto:
I dati di accesso al repository Composer (indirizzo e-mail del cliente e token di licenza) verranno ricevuti via e-mail dopo l'acquisto. Sono disponibili anche nell'area cliente dopo l'accesso a kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l'indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.
composer config repositories.kowal composer https://repo.kowal.store
- 2. Configura i dati di accesso al repository Composer Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
composer require kowal/module-seo-rich-data
php bin/magento module:enable Kowal_SeoRichData
- 5. Esegui l'aggiornamento di Magento:
php bin/magento setup:upgrade
- 6. In ambiente di produzione esegui la compilazione DI:
php bin/magento setup:di:compile
- 7. In ambiente di produzione, se il progetto lo richiede, genera i file statici:
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Installazione manuale
- Copia il modulo nella directory:
app/code/Kowal/SeoRichData
php bin/magento module:enable Kowal_SeoRichData
- 3. Esegui l'aggiornamento di Magento:
php bin/magento setup:upgrade
php bin/magento cache:flush
Attività post-installazione
Dopo l'installazione il modulo aggiunge l'attributo prodotto:
| Attributo | Significato |
|---|
offer_item_condition | Condizione del prodotto usata per generare itemCondition in offers. |
L'attributo supporta i valori:
| Valore in Magento | Valore JSON-LD |
|---|
DamagedCondition | https://schema.org/DamagedCondition |
NewCondition | https://schema.org/NewCondition |
RefurbishedCondition | https://schema.org/RefurbishedCondition |
UsedCondition | https://schema.org/UsedCondition |
Se il prodotto non ha impostato il valore dell'attributo, il modulo lo considera come NewCondition.
Ambito della configurazione
Tutti i campi di configurazione sono disponibili per gli ambiti Default, Website e Store View, in conformità con le impostazioni Magento.
I campi di tipo Enabled, Show ... e simili usano i valori standard Magento:
| Valore | Significato |
|---|
Yes | La funzione è abilitata e può generare dati JSON-LD. |
No | La funzione è disabilitata. |
Breadcrumbs
La sezione gestisce i dati strutturati del percorso di navigazione.
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione dei dati BreadcrumbList. | Yes, No |
Fixed Category Path | Nella pagina prodotto usa il percorso di categoria più specifico quando Magento non fornisce il contesto completo della categoria. | Yes, No |
Type | Definisce la lunghezza del percorso breadcrumbs generato per il motore di ricerca. | Default (Long), Short |
Valori del campo Type:
| Valore | Significato |
|---|
Default (Long) | Percorso completo, ad es. Store > Category > Subcategory > Product. |
Short | Percorso abbreviato, ad es. Store > Subcategory > Product. |
Include Your Site Name in Search Results
La sezione gestisce i dati di tipo WebSite, che possono aiutare Google a riconoscere il nome del sito.
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione dei dati WebSite. | Yes, No |
Website Name | Nome del sito/store trasmesso nei dati strutturati. | Testo, ad es. nome dello store. |
Organization
La sezione gestisce i dati di tipo Organization.
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione dei dati dell'organizzazione. | Yes, No |
Organization Name | Nome dell'azienda o dello store. | Testo; campo obbligatorio dopo l'abilitazione della sezione. |
Logo Url | URL completo del logo dell'organizzazione. | URL del file grafico. |
Description | Descrizione dell'organizzazione. | Testo. |
Description Length | Numero massimo di caratteri della descrizione. | Numero; vuoto significa nessun troncamento. |
Country | Paese dell'organizzazione. | Codice paese dall'elenco Magento. |
Region/State | Regione o provincia. | Testo. |
ZIP/Postal Code | Codice postale. | Testo. |
City | Città. | Testo. |
Street Address | Via e numero civico. | Testo. |
Sales | Telefono del reparto vendite. | Numero in formato internazionale, ad es. +48.... |
Technical Support | Telefono del supporto tecnico. | Numero in formato internazionale. |
Customer Service | Telefono del servizio clienti. | Numero in formato internazionale. |
Il paese di questa sezione può essere usato come fallback per il paese di spedizione e il paese della politica dei resi, se i rispettivi campi nella sezione prodotto restano vuoti.
Social Profiles
La sezione aggiunge i profili social dell'organizzazione. Affinché i dati abbiano senso, la sezione Organization dovrebbe essere abilitata.
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione dei link ai profili social. | Yes, No |
Facebook | URL del profilo Facebook. | URL completo. |
Twitter | URL del profilo Twitter / X. | URL completo. |
Google+ | URL del profilo Google+. | URL completo; campo di configurazione storico. |
Instagram | URL del profilo Instagram. | URL completo. |
YouTube | URL del canale YouTube. | URL completo. |
LinkedIn | URL del profilo LinkedIn. | URL completo. |
Myspace | URL del profilo Myspace. | URL completo; campo di configurazione storico. |
Pinterest | URL del profilo Pinterest. | URL completo. |
SoundCloud | URL del profilo SoundCloud. | URL completo. |
Tumblr | URL del profilo Tumblr. | URL completo. |
I campi vuoti vengono ignorati.
Search Box
La sezione gestisce i dati SearchAction, che possono consentire la visualizzazione del campo di ricerca dello store nei risultati Google.
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione dei dati del motore di ricerca del sito. | Yes, No |
Category Rich Data
La sezione gestisce la generazione dei dati dei prodotti sulle pagine di categoria.
| Campo | Significato | Valori |
|---|
Show Products Data | Aggiunge dati strutturati per i prodotti visibili nella pagina di categoria. | Yes, No |
L'attivazione di questa opzione può peggiorare le prestazioni delle pagine di categoria, perché il modulo deve raccogliere i dati di molti prodotti.
Product Rich Data
La sezione gestisce i principali dati prodotto di tipo Product e i dati offers.
Campi prodotto di base
| Campo | Significato | Valori |
|---|
Enabled | Abilita la generazione del JSON-LD del prodotto nella pagina prodotto. | Yes, No |
Show Availability | Aggiunge availability in offers. | Yes, No |
priceValidUntil Default Value | Data predefinita di validità del prezzo. | Data. |
Use “Special Price To” Value for priceValidUntil Snippet | Se il prodotto ha un prezzo speciale attivo e una data Special Price To, questa data sostituisce il valore predefinito. | Yes, No |
Show Condition | Aggiunge itemCondition in offers. | Yes, No |
Description | Definisce la fonte della descrizione del prodotto in JSON-LD. | None, Product Short Description, Product Full Description, Page Meta Description |
Valori del campo Description:
| Valore | Significato |
|---|
None | Non prende la descrizione dalla configurazione; il codice può usare il nome del prodotto come fallback se la descrizione è vuota. |
Product Short Description | Usa la descrizione breve del prodotto. |
Product Full Description | Usa la descrizione completa del prodotto. |
Page Meta Description | Usa la meta description della pagina. |
Prodotti configurabili e raggruppati
| Campo | Significato | Valori |
|---|
Show Configurable Products as | Definisce il modo di generare le offerte per i prodotti configurabili. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Show Grouped Products as | Definisce il modo di generare le offerte per i prodotti raggruppati. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Valori:
| Valore | Significato |
|---|
Main Offer | Genera una singola offerta per il prodotto principale. |
List of Associated Products Offers | Genera un'offerta separata per ogni prodotto semplice o associato. |
Aggregate Offer | Genera AggregateOffer con prezzo minimo, prezzo massimo e numero di offerte. |
Valutazioni e recensioni
| Campo | Significato | Valori |
|---|
Show Rating | Aggiunge aggregateRating e review ai dati prodotto. | Yes, No |
Use Yotpo Reviews instead of Magento Reviews | Preleva le recensioni da Yotpo invece che da Magento Reviews. | Yes, No |
Rating Format | Definisce la scala delle valutazioni. | Percentage Scale, Numeric Scale |
Number of Reviews | Limite del numero di recensioni più recenti aggiunte a JSON-LD. | Numero; vuoto significa tutte le recensioni. |
Valori del campo Rating Format:
| Valore | Significato |
|---|
Percentage Scale | Le valutazioni sono interpretate su scala percentuale. |
Numeric Scale | Le valutazioni sono interpretate su scala numerica. |
L'integrazione con Yotpo richiede la disponibilità di un modulo che gestisce Yotpo. Se il modulo non è installato, la configurazione Yotpo non deve essere abilitata.
Brand, manufacturer e identificatori del prodotto
| Campo | Significato | Valori |
|---|
Brand | Attributo prodotto usato per generare la proprietà brand. | Qualsiasi attributo prodotto dall'elenco. |
EAN / GTIN Attribute | Attributo prodotto usato come identificatore globale del prodotto. | Qualsiasi attributo prodotto dall'elenco. |
Manufacturer | Attributo prodotto usato per generare la proprietà manufacturer. | Qualsiasi attributo prodotto dall'elenco. |
Il campo EAN / GTIN Attribute genera la proprietà in base al numero di cifre:
| Numero di cifre | Proprietà JSON-LD |
|---|
| 8 | gtin8 |
| 12 | gtin12 |
| 13 | gtin13 |
| 14 | gtin14 |
| Altro numero positivo di cifre | gtin |
Il modulo rimuove i caratteri diversi dalle cifre dal valore EAN / GTIN prima di generare JSON-LD.
Shipping details
La sezione spedizione gestisce la generazione di shippingDetails in offers. I dati vengono aggiunti solo quando la sezione è abilitata e dispone di tutti i valori richiesti.
| Campo | Significato | Valori |
|---|
Show Shipping Details | Abilita la generazione di shippingDetails. | Yes, No |
Shipping Country | Paese di consegna. | Codice paese dall'elenco Magento; se vuoto, viene usato il paese della sezione Organization. |
Shipping Price | Costo di consegna. | Numero uguale o maggiore di 0; 0 indica consegna gratuita. |
Handling Time Min Days | Tempo minimo di gestione dell'ordine. | Numero intero, giorni. |
Handling Time Max Days | Tempo massimo di gestione dell'ordine. | Numero intero, giorni. |
Transit Time Min Days | Tempo minimo di trasporto. | Numero intero, giorni. |
Transit Time Max Days | Tempo massimo di trasporto. | Numero intero, giorni. |
La valuta del costo di spedizione viene presa dalla valuta dell'offerta del prodotto.
Esempio di significato dei valori:
| Campo | Esempio | Significato |
|---|
Shipping Price | 0 | Spedizione gratuita. |
Handling Time Min Days | 0 | L'ordine può essere gestito lo stesso giorno. |
Handling Time Max Days | 1 | La gestione dell'ordine dura al massimo 1 giorno. |
Transit Time Min Days | 1 | La consegna dura almeno 1 giorno. |
Transit Time Max Days | 5 | La consegna dura al massimo 5 giorni. |
Merchant return policy
La sezione politica dei resi gestisce la generazione di hasMerchantReturnPolicy in offers. I dati vengono aggiunti solo quando la sezione è abilitata e dispone dei valori richiesti.
| Campo | Significato | Valori |
|---|
Show Merchant Return Policy | Abilita la generazione di hasMerchantReturnPolicy. | Yes, No |
Return Policy Country | Paese di validità della politica dei resi. | Codice paese dall'elenco Magento; se vuoto, viene usato il paese della sezione Organization. |
Return Policy Category | Tipo di politica di reso. | Finite Return Window, Returns Not Permitted, Unlimited Return Window |
Merchant Return Days | Numero di giorni per il reso. | Numero intero; richiesto per Finite Return Window. |
Return Method | Metodo di reso supportato. | -- Empty --, Return By Mail, Return In Store, Return At Kiosk |
Return Fees | Informazione sulle commissioni di reso. | -- Empty --, Free Return, Customer Responsibility, Return Shipping Fees |
Return Shipping Fee | Importo della commissione per la spedizione di reso. | Numero maggiore di 0; richiesto solo per Return Shipping Fees. |
Valori del campo Return Policy Category:
| Valore | Valore JSON-LD | Significato |
|---|
Finite Return Window | https://schema.org/MerchantReturnFiniteReturnWindow | Reso possibile per un numero definito di giorni. Richiede Merchant Return Days. |
Returns Not Permitted | https://schema.org/MerchantReturnNotPermitted | I resi non sono consentiti. |
Unlimited Return Window | https://schema.org/MerchantReturnUnlimitedWindow | Reso senza un limite di giorni definito. |
Valori del campo Return Method:
| Valore | Valore JSON-LD | Significato |
|---|
-- Empty -- | nessun valore | Il metodo di reso non viene aggiunto a JSON-LD. |
Return By Mail | https://schema.org/ReturnByMail | Reso tramite spedizione. |
Return In Store | https://schema.org/ReturnInStore | Reso in negozio fisico. |
Return At Kiosk | https://schema.org/ReturnAtKiosk | Reso presso punto/kiosk. |
Valori del campo Return Fees:
| Valore | Valore JSON-LD | Significato |
|---|
-- Empty -- | nessun valore | L'informazione sulle commissioni non viene aggiunta a JSON-LD. |
Free Return | https://schema.org/FreeReturn | Il reso è gratuito. |
Customer Responsibility | https://schema.org/ReturnFeesCustomerResponsibility | Il costo del reso è a carico del cliente. |
Return Shipping Fees | https://schema.org/ReturnShippingFees | Il reso prevede una commissione definita per la spedizione di reso. Richiede Return Shipping Fee. |
La valuta del campo Return Shipping Fee viene presa dalla valuta dell'offerta del prodotto.
Custom Properties
Il campo Custom Properties consente di aggiungere proprietà personalizzate al JSON-LD del prodotto.
Formato:
wlasciwosc_jsonld,kod_atrybutu
Se viene indicato un solo elemento, il modulo lo tratta contemporaneamente come nome della proprietà JSON-LD e codice dell'attributo.
Valore predefinito:
skumpn,sku
Significato del valore predefinito:
| Riga | Effetto |
|---|
sku | Aggiunge sku sulla base dell'attributo sku. |
mpn,sku | Aggiunge mpn sulla base dell'attributo sku. |
Esempio di aggiunta di un attributo personalizzato:
color,colormaterial,material
Configurazione minima consigliata per i prodotti
Per limitare gli avvisi di Google Search Console per i dati prodotto, configura almeno:
| Campo | Raccomandazione |
|---|
Product Rich Data > Enabled | Yes |
Show Availability | Yes |
Brand | Seleziona l'attributo con il brand del prodotto. |
EAN / GTIN Attribute | Seleziona l'attributo con EAN / GTIN, se i prodotti hanno un identificatore globale. |
Show Shipping Details | Yes, se lo store ha una politica di spedizione uniforme descrivibile nella configurazione. |
Show Merchant Return Policy | Yes, se lo store ha una politica dei resi uniforme descrivibile nella configurazione. |
Custom Properties | Mantieni almeno sku; opzionalmente aggiungi mpn, se lo store dispone di tale identificatore. |
Pulizia della cache dopo modifiche alla configurazione
Dopo aver modificato la configurazione esegui:
php bin/magento cache:flush
Se lo store utilizza cache HTTP aggiuntiva, Varnish o CDN, svuota anche questi livelli di cache.
Verifica del funzionamento
- Apri la pagina prodotto sul frontend.
- Controlla il sorgente della pagina e trova:
<script type='application/ld+json'>
- 3. Verifica che JSON-LD contenga i campi attesi, ad es.:
{ '@type': 'Product', 'brand': { '@type': 'Brand', 'name': 'Example Brand' }, 'gtin13': '5901234123457', 'offers': [ { '@type': 'Offer', 'shippingDetails': {}, 'hasMerchantReturnPolicy': {} } ]}
- 4. Testa l'URL del prodotto nello strumento Google Rich Results Test o in Google Search Console.
Note di implementazione
- Non abilitare
shippingDetails né hasMerchantReturnPolicy se i valori nella configurazione non corrispondono alla politica reale dello store. - Se le politiche di spedizione o reso differiscono per prodotto, regione, metodo di consegna o carrello, una sola configurazione globale potrebbe non essere sufficiente.
- Dopo aver modificato gli attributi
Brand, Manufacturer o EAN / GTIN Attribute, conviene reindicizzare i dati prodotto se lo store usa cache o indici che influiscono sulla lettura degli attributi. - Negli store multilingua e multivaluta controlla la configurazione separatamente per ogni Store View.
