Dizionario JSON-LD Prodotto: MPN, GTIN13, Brand, Prezzo e Stock

Q: Qual è la differenza tra SKU, MPN e GTIN?

Lo SKU è un identificatore interno creato dal venditore, il MPN è un codice parte del produttore e il GTIN è un identificatore prodotto standardizzato a livello globale. In pratica, tutti e tre possono coesistere, ma non hanno la stessa funzione.

Q: Quali valori devo usare per availability?

I valori più comuni sono https://schema.org/InStock, https://schema.org/OutOfStock, https://schema.org/PreOrder e https://schema.org/BackOrder. L’importante è usare un valore coerente con la reale disponibilità mostrata nella pagina.

Dizionario JSON-LD Prodotto: 25 proprietà essenziali per Schema.org Product

Cerchi una spiegazione chiara delle proprietà Product JSON-LD come mpn, gtin13, brand, sku o availability?
Questa pagina spiega le proprietà più utili del markup Product con definizioni semplici, esempi pratici ed errori comuni da evitare.

JSON-LD è il formato raccomandato da Google per i dati strutturati, soprattutto nelle pagine prodotto, e le proprietà trattate qui si basano sulla documentazione di Google Search Central, Merchant Center e Schema.org.

Che cos’è il Product JSON-LD?

Il Product JSON-LD è un formato di dati strutturati usato per descrivere una pagina prodotto in modo leggibile dai motori di ricerca all’interno dell’HTML della pagina.
Google raccomanda questo formato per aiutare i suoi sistemi a identificare informazioni importanti come nome del prodotto, brand, prezzo, disponibilità e recensioni.

Nelle pagine ecommerce, i tipi più comuni sono Product, Offer, AggregateRating e Review.
Google indica anche che i product snippets richiedono almeno uno dei seguenti elementi: offers, review oppure aggregateRating.

Proprietà Product JSON-LD da conoscere

Qui sotto trovi alcune delle proprietà più utili per una pagina prodotto WordPress o WooCommerce ben strutturata.
Alcune proprietà descrivono il prodotto stesso, mentre altre riguardano l’offerta commerciale mostrata nella pagina.

Proprietà	Funzione
`name`	Nome del prodotto
`brand`	Marca del prodotto
`mpn`	Codice parte del produttore
`gtin13`	Codice identificativo globale a 13 cifre
`sku`	Codice interno di magazzino del venditore
`offers`	Blocco dell’offerta commerciale
`availability`	Disponibilità di stock
`itemCondition`	Condizione del prodotto

@context

Definizione: indica il vocabolario usato, di solito https://schema.org/.

Perché è importante: aiuta i motori di ricerca a interpretare correttamente i dati strutturati.

"@context": "https://schema.org/"

@type

Definizione: specifica il tipo di entità descritta, in questo caso Product.

Perché è importante: Google può distinguere una pagina prodotto da altri tipi di contenuto.

"@type": "Product"

name

Definizione: il nome del prodotto mostrato agli utenti.

Buona pratica: mantienilo identico al titolo principale visibile della scheda prodotto.

"name": "Scarpe da running Nike Air Zoom"

description

Definizione: una breve descrizione del prodotto.

Buona pratica: scrivi una descrizione chiara, coerente con il contenuto visibile e utile per l’utente.

"description": "Scarpe da running leggere con ammortizzazione reattiva per l'allenamento quotidiano."

image

Definizione: uno o più URL delle immagini del prodotto.

Buona pratica: usa immagini reali, accessibili e coerenti con il prodotto o la variante mostrata nella pagina.

"image": [
  "https://www.esempio.com/images/air-zoom-front.jpg",
  "https://www.esempio.com/images/air-zoom-side.jpg"
]

brand

Definizione: il brand del prodotto, spesso fornito come oggetto Brand.

Buona pratica: non confondere il marchio del prodotto con il nome del tuo negozio.

"brand": {
  "@type": "Brand",
  "name": "Nike"
}

sku

Definizione: il tuo codice interno di magazzino.

Buona pratica: usalo per la gestione del catalogo, ma non considerarlo un sostituto di GTIN o MPN.

"sku": "NK-AZ-42-BLK"

mpn

Definizione: Manufacturer Part Number, cioè il codice parte del produttore.

Buona pratica: usa solo un codice reale fornito dal produttore e non inventarlo mai.

"mpn": "AIRZOOM-447-B"

gtin13

Definizione: identificatore globale del prodotto a 13 cifre, comunemente usato come EAN-13 in molti mercati.

Buona pratica: usalo solo se possiedi un identificatore ufficiale valido.

"gtin13": "3001234567892"

gtin

Definizione: proprietà più generica per gli identificatori GTIN.

Buona pratica: scegli una strategia coerente se usi gtin oppure gtin13.

"gtin": "00012345600012"

color

Definizione: il colore del prodotto o della variante selezionata.

Buona pratica: assicurati che corrisponda esattamente alla variante visibile o selezionata nella pagina.

"color": "Nero"

size

Definizione: la taglia o misura del prodotto.

Buona pratica: particolarmente utile per scarpe, abbigliamento e prodotti con varianti.

"size": "42"

material

Definizione: il materiale o la composizione principale del prodotto.

Buona pratica: utile per descrizioni tecniche e prodotti in cui il materiale influisce sulla decisione di acquisto.

"material": "Mesh traspirante e suola in gomma"

pattern

Definizione: il motivo del prodotto, per esempio tinta unita, rigato o floreale.

Buona pratica: è particolarmente rilevante per moda, tessili e articoli decorativi.

"pattern": "Tinta unita"

weight

Definizione: il peso del prodotto.

Buona pratica: usa un oggetto QuantitativeValue con valore numerico e unità chiara.

"weight": {
  "@type": "QuantitativeValue",
  "value": 0.85,
  "unitText": "kg"
}

width, height, depth

Definizione: le dimensioni fisiche del prodotto.

Buona pratica: aggiungi sempre un’unità di misura quando inserisci dimensioni tecniche.

"width": {
  "@type": "QuantitativeValue",
  "value": 32,
  "unitText": "cm"
},
"height": {
  "@type": "QuantitativeValue",
  "value": 12,
  "unitText": "cm"
},
"depth": {
  "@type": "QuantitativeValue",
  "value": 18,
  "unitText": "cm"
}

audience

Definizione: il pubblico di riferimento del prodotto.

Buona pratica: utile per cataloghi in cui età o genere fanno parte della definizione del prodotto.

"audience": {
  "@type": "PeopleAudience",
  "suggestedGender": "male",
  "suggestedMinAge": 18
}

offers

Definizione: l’oggetto che contiene le informazioni commerciali dell’offerta.

Buona pratica: in una pagina prodotto che vende online, questa è spesso una delle parti più importanti del markup.

"offers": {
  "@type": "Offer",
  "price": "129.90",
  "priceCurrency": "EUR"
}

price

Definizione: il prezzo del prodotto all’interno dell’offerta.

Buona pratica: il prezzo nei dati strutturati deve corrispondere al prezzo visibile nella pagina.

"price": "129.90"

priceCurrency

Definizione: la valuta del prezzo nel formato ISO 4217.

Buona pratica: usa codici come EUR, USD o TND, non il nome completo della valuta.

"priceCurrency": "EUR"

availability

Definizione: la disponibilità a magazzino dell’offerta prodotto.

Buona pratica: usa valori standardizzati come https://schema.org/InStock oppure https://schema.org/OutOfStock.

"availability": "https://schema.org/InStock"

https://schema.org/InStock
https://schema.org/OutOfStock
https://schema.org/PreOrder
https://schema.org/BackOrder
https://schema.org/LimitedAvailability

itemCondition

Definizione: la condizione del prodotto al momento della vendita.

Buona pratica: specifica se l’articolo è nuovo, usato o ricondizionato con un valore standardizzato.

"itemCondition": "https://schema.org/NewCondition"

priceValidUntil

Definizione: la data fino alla quale il prezzo rimane valido.

Buona pratica: particolarmente utile per promozioni o prezzi temporanei.

"priceValidUntil": "2026-12-31"

url

Definizione: l’URL della pagina prodotto o dell’offerta.

Buona pratica: usa l’URL canonico del prodotto o della variante effettivamente visibile.

"url": "https://www.esempio.com/scarpe-running-nike-air-zoom"

seller

Definizione: il venditore dell’offerta prodotto.

Buona pratica: identifica l’organizzazione o la persona che vende realmente il prodotto.

"seller": {
  "@type": "Organization",
  "name": "Il Mio Negozio"
}

aggregateRating

Definizione: la valutazione media basata sulle recensioni dei clienti.

Buona pratica: usa questa proprietà solo se valutazioni e numero di recensioni sono reali e visibili nella pagina.

"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.6",
  "reviewCount": "128"
}

review

Definizione: una recensione individuale del prodotto.

Buona pratica: le recensioni strutturate devono riflettere contenuti autentici e visibili nella pagina.

"review": {
  "@type": "Review",
  "author": {
    "@type": "Person",
    "name": "Luca"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "5"
  },
  "reviewBody": "Scarpe molto comode con un'ottima ammortizzazione."
}

Esempio completo di Product JSON-LD

Ecco un esempio completo che combina diverse proprietà importanti di Product e Offer.
Puoi usarlo come base di partenza prima di sostituire i dati di esempio con le informazioni reali del tuo prodotto.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Scarpe da running Nike Air Zoom",
  "description": "Scarpe da running leggere con ammortizzazione reattiva per l'allenamento quotidiano.",
  "image": [
    "https://www.esempio.com/images/air-zoom-front.jpg",
    "https://www.esempio.com/images/air-zoom-side.jpg"
  ],
  "brand": {
    "@type": "Brand",
    "name": "Nike"
  },
  "sku": "NK-AZ-42-BLK",
  "mpn": "AIRZOOM-447-B",
  "gtin13": "3001234567892",
  "category": "Scarpe sportive",
  "color": "Nero",
  "size": "42",
  "material": "Mesh traspirante e suola in gomma",
  "pattern": "Tinta unita",
  "weight": {
    "@type": "QuantitativeValue",
    "value": 0.85,
    "unitText": "kg"
  },
  "audience": {
    "@type": "PeopleAudience",
    "suggestedGender": "male",
    "suggestedMinAge": 18
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "128"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.esempio.com/scarpe-running-nike-air-zoom",
    "price": "129.90",
    "priceCurrency": "EUR",
    "priceValidUntil": "2026-12-31",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "seller": {
      "@type": "Organization",
      "name": "Il Mio Negozio"
    }
  }
}

FAQ sul Product JSON-LD

Qual è la differenza tra SKU, MPN e GTIN?

Lo SKU è un identificatore interno creato dal venditore, il MPN è un codice parte del produttore e il GTIN è un identificatore prodotto standardizzato a livello globale.
In pratica, tutti e tre possono coesistere, ma non hanno la stessa funzione.

È meglio usare gtin13 o gtin?

Se sai che il tuo identificatore è specificamente un codice a 13 cifre, gtin13 è la scelta più logica.
Se lavori con GTIN di lunghezze diverse, gtin può essere più flessibile.

Posso inventare un MPN o un GTIN se non lo possiedo?

No. Non dovresti mai inventare identificatori di prodotto.
Se non hai un GTIN o un MPN reale, è meglio lasciare la proprietà vuota piuttosto che inserire dati errati.

Quali valori devo usare per availability?

I valori più comuni sono https://schema.org/InStock, https://schema.org/OutOfStock, https://schema.org/PreOrder e https://schema.org/BackOrder.
L’importante è usare un valore coerente con la reale disponibilità mostrata nella pagina.

I dati strutturati Product bastano per ottenere un rich result?

Non automaticamente. I dati strutturati aiutano Google a comprendere la pagina, ma l’idoneità ai rich results dipende anche dalla qualità del contenuto, dal rispetto delle linee guida e dalla validità del markup.

I valori dei dati strutturati devono essere visibili nella pagina?

I dati strutturati devono corrispondere al contenuto realmente mostrato agli utenti.
In particolare per le FAQ, Google specifica che domande e risposte devono essere visibili nella pagina, anche se presenti in sezioni espandibili.

Come posso validare il markup Product JSON-LD?

Dopo l’implementazione, testa la pagina con il Rich Results Test di Google e controlla i report di miglioramento in Google Search Console.
È il modo migliore per trovare errori critici e migliorare la qualità del markup.