Utilizza il markup dei dati strutturati nelle pagine di destinazione dei prodotti per consentire a Google di recuperare informazioni aggiornate sui tuoi prodotti e sulle tue offerte direttamente dal tuo sito web. Tutti i markup dei dati strutturati supportati da Merchant Center avranno attributi corrispondenti e valori accettati, come indicato nella specifica dei dati di prodotto. I dati strutturati devono essere abbinati ai valori e agli attributi corrispondenti.
Su questa pagina:
Attributi e annotazioni schema.org
Gli attributi sono uno dei modi in cui vengono organizzati i dati di prodotto che invii a Merchant Center. Ogni attributo contiene una singola informazione su un prodotto, ad esempio il titolo o la descrizione. Se i valori schema.org sono abbinati in modo preciso agli attributi corrispondenti della specifica dei dati di prodotto, verranno riscontrati meno errori al momento della convalida del feed.
Nota: se utilizzi gli aggiornamenti automatici degli articoli, assicurati di specificare le proprietà di schema.org price, priceCurrency, availability e condition per aumentarne il grado di precisione. Scopri di più sugli aggiornamenti automatici degli articoli.
|
Attributo dei dati di prodotto
|
Tipo e descrizione | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
I seguenti attributi sono inclusi nel tipo Product di schema.org |
|||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
| URL | |||||||||||||||||||||||||||||
|
Testo Un codice SKU principale, necessario per raggruppare tutte le varianti appartenenti allo stesso gruppo di prodotti. |
|||||||||||||||||||||||||||||
|
Testo Il codice GTIN che identifica in modo univoco il prodotto. Specifica solo una di queste proprietà di schema.org. Se utilizzi valori GTIN, questi devono essere della lunghezza corretta e contenere la corretta cifra di controllo. |
|||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
|
Testo Utilizza la proprietà |
|||||||||||||||||||||||||||||
|
Testo Utilizza la proprietà
|
|||||||||||||||||||||||||||||
|
E |
Numero (in anni) Usa la proprietà I valori validi sono quelli definiti dall'attributo
|
||||||||||||||||||||||||||||
| Testo | |||||||||||||||||||||||||||||
|
OPPURE |
Testo Utilizza la proprietà |
||||||||||||||||||||||||||||
|
Testo Utilizza la proprietà I valori validi sono quelli del tipo
|
|||||||||||||||||||||||||||||
|
Testo Utilizza la proprietà I valori validi sono quelli del tipo WearableSizeSystemEnumeration. Questi valori sono mappati a quelli del feed nel seguente modo:
|
|||||||||||||||||||||||||||||
|
Utilizza la proprietà |
|||||||||||||||||||||||||||||
|
Utilizza la proprietà |
|||||||||||||||||||||||||||||
|
Utilizza la proprietà |
|||||||||||||||||||||||||||||
|
Utilizza la proprietà |
|||||||||||||||||||||||||||||
|
Le seguenti proprietà di schema.org provengono da Offer type, che deve essere nidificato all'interno di un prodotto |
|||||||||||||||||||||||||||||
| Un URL valido che indirizza al prodotto. | |||||||||||||||||||||||||||||
|
OPPURE: |
price: numero. Inviato senza simboli di valuta, separatori delle migliaia o spazi (ad esempio "1498.99"). priceCurrency: testo. Inviata in un formato ISO 4217 a tre lettere (ad esempio, USD, GBP, EUR), la valuta deve soddisfare i requisiti di lingua e valuta del paese di destinazione. Nota: i valori price e priceCurrency possono essere forniti direttamente nell'istanza Offer oppure indirettamente tramite una proprietà priceSpecification di tipo UnitPriceSpecification. Quando viene specificato l'attributo sale_price, price deve essere fornito utilizzando una proprietà priceSpecification con priceSpecification.priceType="ListPrice". L'attributo sale_price può essere specificato direttamente sotto Offer o tramite una proprietà priceSpecification di tipo UnitPriceSpecification senza un priceSpecification.priceType. |
||||||||||||||||||||||||||||
|
I valori validi sono quelli del tipo
|
|||||||||||||||||||||||||||||
|
I valori validi sono quelli del tipo
|
|||||||||||||||||||||||||||||
| Un URL di pagamento valido che indirizza al prodotto. | |||||||||||||||||||||||||||||
Esempi di utilizzo con codice JSON-LD
Prodotto singolo
Esempio
L'esempio seguente illustra un prodotto di base con un insieme minimo di proprietà.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Bellissimo ciondolo",
"description": "Ciondolo dalle linee essenziali",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
}
L'esempio seguente mostra come specificare il tipo di taglia e il sistema di taglie tramite schema.org. L'esempio specifica la taglia USA "XL" per una t-shirt blu destinata agli adulti (dai 13 anni in su) nel reparto di moda maschile "Misura speciale".
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "12345",
"image": "https://www.example.com/tshirt.jpg",
"name": "T-shirt classica",
"description": "T-shirt in cotone dal taglio classico",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"material": "cotton",
"color": "blue",
"size": {
"@type": "SizeSpecification",
"name": "XL",
"sizeSystem": "https://schema.org/WearableSizeSystemUS",
"sizeGroup": [
"https://schema.org/WearableSizeGroupBig",
"https://schema.org/WearableSizeGroupTall"
]
},
"audience": {
"@type": "PeopleAudience",
"suggestedGender": "male",
"suggestedMinAge": 13
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/tshirt",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 24.99,
"priceCurrency": "USD"
}
}
Più prodotti non correlati sulla stessa pagina di destinazione
Se la tua pagina contiene più prodotti non correlati e ogni prodotto ha una propria annotazione di dati strutturati, ogni annotazione dovrà contenere informazioni che identificano il prodotto a cui fa riferimento.
Ad esempio, è consigliabile fornire il codice SKU (attributo ID [id]) o il codice GTIN (attributo [gtin]) in ogni singola annotazione. Se non fornisci queste informazioni, i prodotti sulla pagina di destinazione potrebbero non essere abbinati ai relativi dati strutturati. Scopri di più sulla creazione di dati strutturati sulle pagine di destinazione.
Esempio
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Bellissimo ciondolo",
"description": "Ciondolo dalle linee essenziali",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
},
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "racket-12345",
"image": "https://www.example.com/racket.jpg",
"name": "Bella racchetta",
"description": "Racchetta da tennis",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/racket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 59.99,
"priceCurrency": "USD"
}
}
]Prezzo scontato
L'esempio seguente illustra un prodotto di base con un prezzo scontato. Per indicare un prezzo scontato, specifica anche il prezzo di listino originale, specificato con la proprietà /priceType.
Esempio
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Bellissimo ciondolo",
"description": "Ciondolo dalle linee essenziali",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 10.00,
"priceCurrency": "USD",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
}
}
Se una proprietà /UnitPriceSpecification viene utilizzata anche per il prezzo non scontato, la codifica contiene semplicemente due valori /UnitPriceSpecifications:
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Bellissimo ciondolo",
"description": "Ciondolo dalle linee essenziali",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": [
{
"@type": "UnitPriceSpecification",
"price": 10.00,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
]
}
}
Spedizione
Per specificare i costi di spedizione (consigliati) per il tuo prodotto, utilizza il tipo schema.org OfferShippingDetails che deve essere nidificato all'interno di un'offerta utilizzando la proprietà shippingDetails e mappato sull'attributo shipping nella specifica dei dati di prodotto. È possibile fornire più proprietà shippingDetails.
|
Attributo dei dati di prodotto
|
Tipo e descrizione |
|---|---|
I seguenti attributi sono inclusi nel tipo OfferShippingDetails di schema.org. |
|
|
|
Testo Codice paese ISO 3166-1 a due cifre Utilizza la proprietà |
|
Testo Codice di sottodivisione ISO 3166-2 a due o tre cifre, senza prefisso del paese. Supportato solo per gli Stati Uniti, l'Australia o il Giappone. Esempi: "NY", "NSW" o "03". Utilizza la proprietà |
|
|
Utilizza la proprietà |
|
|
Numero (non negativo, numero intero) Specifica il numero minimo e massimo di giorni lavorativi per l'elaborazione e il transito di un ordine. Il tempo di elaborazione specifica il tempo che intercorre tra il momento in cui viene effettuato un ordine e la data in cui viene preso in consegna da un corriere. Il tempo di transito specifica il tempo che intercorre tra il momento in cui il prodotto viene preso in consegna da un corriere e la data in cui viene consegnato al cliente. Utilizza la proprietà |
|
Esempio
L'esempio seguente illustra come specificare le informazioni di spedizione utilizzando schema.org. L'esempio specifica un costo di spedizione di 3,49 $ per gli stati della California, del Nevada e dell'Arizona negli Stati Uniti. Il tempo di elaborazione è compreso tra 0 e 1 giorno lavorativo e il tempo di transito è compreso tra 1 e 5 giorni lavorativi.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US",
"addressRegion": [ "CA", "NV", "AZ" ]
},
"shippingRate": {
"@type": "MonetaryAmount",
"value": 3.49,
"currency": "USD"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
}
}
Resi
Per specificare i periodi di reso e i costi per il tuo prodotto, utilizza il tipo MerchantReturnPolicy di schema.org, che deve essere nidificato all'interno di un tipo Offer utilizzando la proprietà hasMerchantReturnPolicy.
|
Attributo dei dati di prodotto
|
Tipo e descrizione |
|---|---|
| Le seguenti proprietà di schema.org provengono da MerchantReturnPolicy, che deve essere nidificato all'interno di un prodotto utilizzando la proprietà offers (consulta gli esempi di seguito). | |
| applicableCountry |
Codice paese ISO 3166-1 alpha-2 a due lettere (ad es. "US") Codice paese ISO 3166-1 alpha-3 a tre lettere (ad es. "USA") Paese a cui si applicano le norme sui resi specifiche di un commerciante. Può essere diverso dal paese da cui è stato spedito il prodotto. È possibile specificare fino a 50 paesi. |
|
I valori validi sono quelli del tipo MerchantReturnEnumeration. Se specificato come MerchantReturnFiniteReturnWindow o MerchantReturnUnlimitedWindow, si consiglia di utilizzare gli attributi returnMethod e returnShippingFeesAmount. Inoltre, se specificato come MerchantReturnFiniteReturnWindow, merchantReturnDays è obbligatorio. |
|
| merchantReturnDays |
Il numero di giorni (dalla data di consegna) entro cui è possibile restituire un prodotto. |
| returnMethod |
I valori validi sono quelli del tipo ReturnMethodEnumeration.
|
| returnFees | Il valore valido è FreeReturn dal tipo ReturnFeesEnumeration. |
| returnShippingFeesAmount |
Informazioni sul costo della spedizione per i resi dei prodotti. |
Esempio
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Bellissimo ciondolo",
"description": "Ciondolo dalle linee essenziali",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": 2.99,
"currency": "USD"
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 60,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn"
}
}
}
Efficienza energetica
Schema.org supporta l'etichettatura dei prodotti per l'efficienza energetica tramite il tipo EnergyConsumptionDetails, che può essere specificato per un prodotto che utilizza la proprietà EnergyConsumptionDetails.
|
Attributo dei dati di prodotto
|
Tipo e descrizione |
|---|---|
Le seguenti proprietà di schema.org provengono dal tipo EnergyConsumptionDetails. |
|
|
I valori validi sono quelli del tipo |
|
Aggiungi l'istanza di EnergyConsumptionDetails che è stata usata per specificare l'attributo energy_efficiency_class e utilizza la stessa tabella di mappatura per selezionare il valore. Se non viene fornito un valore e viene specificato l'attributo energy_efficiency_class, si presume il valore EUEnergyEfficiencyCategoryG. |
|
Aggiungi l'istanza di EnergyConsumptionDetails che è stata usata per specificare l'attributo energy_efficiency_class e utilizza la stessa tabella di mappatura per selezionare il valore. Se non viene fornito un valore e viene specificato l'attributo energy_efficiency_class, si presume il valore EUEnergyEfficiencyCategoryA3Plus. |
|
I valori per energyEfficiencyScale, energyEfficiencyScaleMin ed energyEfficiencyScaleMax provengono dal tipo di enumerazione di schema.org EUEnergyEfficiencyEnumeration e sono mappati ai valori per i tre attributi dell'efficienza energetica nella specifica dei dati di prodotto come segue.
| Valore della specifica dei dati di prodotto | Valore di enumerazione di schema.org dal tipoEUEnergyEfficiencyEnumeration type |
|---|---|
A+++ |
EUEnergyEfficiencyCategoryA3Plus |
A++ |
EUEnergyEfficiencyCategoryA2Plus |
A+ |
EUEnergyEfficiencyCategoryA1Plus |
A |
EUEnergyEfficiencyCategoryA |
B |
EUEnergyEfficiencyCategoryB |
C |
EUEnergyEfficiencyCategoryC |
D |
EUEnergyEfficiencyCategoryD |
E |
EUEnergyEfficiencyCategoryE |
F |
EUEnergyEfficiencyCategoryF |
G |
EUEnergyEfficiencyCategoryG |
Esempio
L'esempio seguente mostra come specificare le informazioni sull'efficienza energetica utilizzando schema.org. L'esempio specifica la classe energetica UE "C" con scala da "A+" a "F" per uno scaldabagno.
{ "@context": "https://schema.org/", "@type": "Product", "sku": "1234-5678", "image": "https://www.example.com/waterheater.jpg", "name": "Scaldabagno", "description": "Scaldabagno ad alta capacità", "gtin": "12345678901231", "mpn": "WH1234", "brand": { "@type": "Brand", "name": "ExampleWaterHeaterBrand" },
"hasEnergyConsumptionDetails": {
"hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
"energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
}, "offers": { "@type": "Offer", "url": "https://www.example.com/hotwaterheater", "itemCondition": "https://schema.org/NewCondition", "availability": "https://schema.org/InStock", "price": 1799.00, "priceCurrency": "EUR" }}Prezzo unitario
Schema.org supporta il prezzo unitario dei prodotti utilizzando la proprietà referenceQuantity nel tipo UnitPriceSpecification, fornito utilizzando la proprietà priceSpecification nell'offerta. Quando specifichi il prezzo unitario, specifica anche il prezzo e la valuta del prodotto utilizzando la proprietà priceSpecification (anziché utilizzare direttamente le proprietà price epriceCurrency nell'offerta).
|
Attributo dei dati di prodotto
|
Tipo e descrizione |
|---|---|
Le seguenti proprietà di schema.org provengono dal tipo UnitPriceSpecification. |
|
|
Specifica la misura per il prezzo unitario utilizzando una proprietà Utilizza la proprietà |
|
|
Specifica la misura di base per il prezzo unitario utilizzando una proprietà Utilizza la proprietà |
|
Esempio
L'esempio seguente illustra un prezzo di 3,99 euro per un sacchetto di riso da 5 kg con un prezzo standardizzato preferito per 1 kg. Ciò significa che il prodotto potrebbe essere mostrato ai consumatori con un prezzo unitario di 0,80 € al chilo.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "basrice12345",
"image": "https://www.example.com/rice.jpg",
"name": "Riso basmati",
"description": "Busta grande di riso bianco basmati biologico, 5 chilogrammi",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "ExampleRiceBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/basrice1kg",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 3.99,
"priceCurrency": "EUR",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 5,
"unitCode": "KGM",
"valueReference": {
"value": 1,
"unitCode": "KGM"
}
}
}
}
}
Testare il markup
Verifica l'implementazione di schema.org con lo strumento dei risultati avanzati (esaminando i report sui dati strutturati "Schede commerciante"). Visita il Centro assistenza Google Search Console per scoprire di più sull'utilizzo di questo strumento, sul debug di eventuali problemi e sull'interpretazione dei risultati all'interno dello strumento. Scopri di più sui dati strutturati dei prodotti.
Requisiti per il markup dei dati strutturati
- Il markup dei dati strutturati deve essere incluso nell'HTML restituito dal server web. Non può essere generato con JavaScript dopo il caricamento della pagina.
- La pagina di destinazione non può cambiare in base ai dati del cliente, ad esempio adattando i prezzi in base all'indirizzo IP o al tipo di browser di un cliente.
- I dati strutturati devono corrispondere ai valori che vengono mostrati al cliente. Fornire dati errati sulle pagine di destinazione dei prodotti rappresenta una violazione delle nostre linee guida per gli sviluppatori web.
- Google consiglia di utilizzare il codice JSON-LD per i dati strutturati.