Come aggiungere schema markup su Shopify senza rompere il tema

Cos'è il markup schema e cosa include già Shopify?

Il markup schema è un dato strutturato, un blocco JSON-LD che classifica il contenuto di una pagina in modo che i motori di ricerca e i motori di risposta possano leggerlo senza fare congetture. Su una pagina prodotto indica: questo è un Product, ecco il prezzo, ecco la valutazione, ecco le recensioni. Google lo usa per mostrare la valutazione a stelle, il prezzo e la disponibilità sotto il risultato di ricerca.

I temi Shopify includono già alcuni dati strutturati, di solito un blocco Product di base, ma raramente includono Review o aggregateRating, perché il tema non ha recensioni proprie da descrivere. Questa è la lacuna da colmare: collegare i dati delle tue recensioni al markup Product in modo che le stelle possano comparire.

Quali tipi di schema servono per le recensioni prodotto?

Per i rich snippet, Google ha bisogno di un Product che contenga Review, aggregateRating, o entrambi. Il blocco Product include nome, immagine e offerta. L'aggregateRating include il punteggio medio e il numero di recensioni. Ogni Review include autore, valutazione e testo della recensione.

La regola che sorprende molti: le recensioni e la valutazione nel markup devono essere visibili sulla pagina. Non puoi inserire un aggregateRating di 4,8 su 200 recensioni se la pagina non mostra nessuna recensione. Google lo tratta come ingannevole e rimuove il rich snippet per l'intera pagina.

• Product: nome, immagine e offerta (prezzo, valuta, disponibilità).
• aggregateRating: ratingValue e reviewCount, coerenti con quello che la pagina mostra.
• Review: autore, reviewRating e reviewBody, per le recensioni singole visibili sulla pagina.

Meglio modificare il JSON-LD del tema, usare un'app o un generatore?

Esistono tre approcci concreti, ciascuno con un diverso equilibrio tra controllo e sicurezza. Modificare il JSON-LD del tema a mano offre il massimo controllo, ma significa intervenire sul codice Liquid, dove una virgola fuori posto rompe il blocco senza dare errori visibili. Lasciare che un'app di recensioni inserisca il markup è la strada meno impegnativa, ma erediti la struttura che l'app produce, e alcune app lo inseriscono lato applicativo dove i bot di ricerca possono non vederlo. Un generatore di schema si colloca nel mezzo: inserisci i tuoi valori reali, ottieni un JSON-LD valido e inserisci un blocco pulito nella pagina.

Se non sei a tuo agio con il codice del tema, inizia dal generatore. È il modo con il rischio più basso per ottenere un blocco corretto sulla pagina, e puoi incollare il risultato direttamente in una sezione Custom Liquid senza riscrivere il tema.

• JSON-LD del tema: massimo controllo, rischio più alto di errori di sintassi silenziosi.
• App: meno impegno, ma verifica che il markup sia nel codice sorgente della pagina, non solo nel navigatore.
• Generatore: inserisci i valori reali, ottieni JSON-LD validato, incolla un blocco unico.

Come aggiungere il markup senza rompere il tema?

Non incollare mai il markup schema all'interno di un blocco JSON-LD già esistente. Aggiungilo come blocco autonomo e separato. Nell'editor del tema, aggiungi una sezione Custom Liquid (o modifica il modello prodotto) e inserisci un nuovo tag di tipo application/ld+json contenente il tuo blocco Product. Tenerlo separato significa che un errore nel tuo blocco non può corrompere il blocco del tema, e viceversa.

Prima di salvare, duplica il tema per avere un ripristino pulito. Poi aggiungi il blocco, salva e visualizza il sorgente della pagina prodotto live per verificare che il JSON-LD sia presente nell'HTML grezzo, non solo dopo l'esecuzione dei codici. Se le tue recensioni vengono inserite da un'app dopo il caricamento, il pattern più sicuro è far renderizzare l'app lato server, oppure legare il risultato del generatore a valori già stampati sulla pagina.

Come verificare il markup e come riconoscere un errore?

Verifica ogni modello prodotto con due strumenti: il Rich Results Test di Google per l'idoneità, e il validatore di Schema.org per la sintassi. Il Rich Results Test indica se il Product è idoneo per le stelle e segnala i campi obbligatori mancanti. Il validatore di Schema.org individua il JSON malformato che il Rich Results Test a volte non rileva.

L'errore più frequente non è un problema di sintassi. È un avviso che la valutazione non ha recensioni visibili, o che i valori nel markup non corrispondono alla pagina. È di nuovo la regola della corrispondenza. Correggi facendo in modo che il markup descriva esattamente quello che un cliente vede, poi riconvalida prima di procedere.

• Rich Results Test: conferma l'idoneità del Product e indica i campi mancanti.
• Validatore Schema.org: individua il JSON malformato che il Rich Results Test può non rilevare.
• Visualizza il sorgente della pagina live: verifica che il blocco sia nell'HTML grezzo.

Quali errori invalidano il markup schema in silenzio?

La maggior parte dei markup schema invalidati è tecnicamente valida e ancora rifiutata, perché descrive qualcosa che la pagina non mostra. I casi classici: un aggregateRating senza recensioni renderizzate sulla pagina, un numero di recensioni nel markup che non corrisponde a quello visibile, o markup Product o Review su una pagina che non è un singolo prodotto.

Il problema più profondo è la leggibilità. Molte app di recensioni sono state costruite per l'acquirente sulla pagina e si fermano lì: le stelle sembrano corrette nel navigatore, ma il testo e la valutazione delle recensioni sono racchiusi in un Widget lato applicativo che i bot di ricerca e i motori di risposta AI non riescono a leggere, quindi il markup descrive contenuti che la macchina non vede mai. Rendere le tue recensioni leggibili, verificabili e citabili nella ricerca e nell'AI è la lacuna specifica che BeyondReviews è costruita per colmare.

• aggregateRating presente, ma nessuna recensione effettivamente renderizzata sulla pagina.
• Numero di recensioni o media nel markup non corrispondente ai numeri visibili.
• Markup Product o Review su una pagina che non è un singolo prodotto.
• Recensioni bloccate in un Widget lato applicativo che il bot di ricerca non riesce a leggere.

Il risultato finale

Un markup Shopify pulito è fatto di tre elementi: un blocco Product autonomo, recensioni reali visibili sulla pagina, e un markup in cui ogni valore corrisponde a quello che un cliente vede. Aggiungilo come blocco separato per non rischiare di rompere il tema, generalo dai tuoi dati reali invece di digitarlo a mano, e valida ogni modello prima di considerarlo completato.

Fai tutto questo e stelle, prezzo e numero di recensioni diventano idonei per il risultato su Google. Salta la regola di corrispondenza e il markup è valido ma ignorato: lavoro fatto, niente mostrato.