Risorse · 38
Mantenere la coerenza delle varianti di prodotto dall'URL al carrello
Allineare l'opzione selezionata, l'identità, l'immagine, il prezzo, la disponibilità, il ricarico e l'acquisto.
Aggiornato · 7 min
Obiettivi di questa guida
- Identificare ogni variante.
- Testare i link diretti.
- Sincronizzare l'offerta.
- Gestire le rotture di stock.
Verifica rapida
- Ogni combinazione venduta ha un identificatore stabile?
- Un link diretto preseleziona l'opzione corretta?
- Immagine, prezzo e stock corrispondono al carrello?
- Il markup descrive la stessa offerta?
- Cosa succede dopo una rottura di stock?
Metodo passo passo
- 1
Modellare gruppi e opzioni.
Separare gli attributi comuni del prodotto dalle differenze di ogni variante. Definire identificatori, dimensioni selezionabili e combinazioni effettivamente vendute.
Risultato: matrice di prodotti, gruppi e varianti.
- 2
Testare gli URL diretti
Aprire ogni URL di variante senza una sessione. Verificare l'opzione preselezionata, l'immagine, il prezzo, la disponibilità e l'azione di aggiunta al carrello.
Risultato: set di link diretti verificato.
- 3
Unificare i dati visualizzati
Tracciare la fonte di verità per prezzo, valuta, stock e promozioni. Confrontare contemporaneamente pagina, carrello, feed e dati strutturati.
Risultato: mappa del flusso di dati e discrepanze con timestamp.
- 4
Descrivere il gruppo in modo accurato
Se si utilizza il markup ProductGroup, associare varianti e ID secondo le linee guida di Google e rendere ogni pagina comprensibile singolarmente.
Risultato: esempi di markup verificati.
- 5
Gestire stati anomali
Riprodurre lo stock esaurito, lo sconto scaduto, l'opzione non disponibile e il reso dal carrello. Evita di mostrare offerte non acquistabili. Risultato
Risultato: casi di transizione e correzioni.
- 6
Monitoraggio delle divergenze.
Campionamento delle varianti pubblicate dopo le modifiche al catalogo. Misurazione del ritardo di propagazione e assegnazione delle correzioni.
Risultato: dashboard delle discrepanze.
Indicatori di gestione
| Indicatore | Cosa misura | Prima azione |
|---|---|---|
| Identità | Varianti con ID e attributi distintivi | Correzione del modello |
| Collegamento diretto | URL che selezionano l'opzione desiderata | Correzione della selezione |
| Accordo | Prezzo e disponibilità allineati nel carrello | Correzione dei flussi di dati |
| Propagazione | Ritardo dopo le modifiche al catalogo | Riduzione delle copie obsolete |
Errori comuni
- Un URL che non attiva la sua variante
- Offerta strutturata diversa da quella del carrello
- Confusione tra una scelta visiva e una variante acquistabile
- Inventario obsoleto in un feed esterno
Domande frequenti
Ogni variante necessita di una pagina dedicata?
La struttura del sito varia, ma Google si aspetta che ogni variante sia preselezionabile tramite un URL distinto.
Il markup può correggere dati di catalogo errati?
No. Deve descrivere fedelmente l'offerta visibile e acquistabile.
Perché testare senza una sessione?
Per confermare che un link condiviso apra la variante corretta senza fare affidamento su una scelta salvata localmente.
Identità prodotto: GTIN e varianti
Le note dettagliate di questa edizione sono disponibili in inglese.
A reliable catalog lets visitors find the same variant on the page, in the feed, in the cart and through support. Start by separating the trade-item identifier, internal reference, variant group and selling terms. A check digit can detect a composition error; alone it cannot resolve identity or offer inconsistencies.
Sources consulted on 23 October 2026. Calculation follows the GS1 modulo-10 algorithm; the 2017 NZ guide is cited only for that algorithm. Illustrative lengths and representations are checked against GS1 guideline 1.1.0 of December 2025. CIE test cases are distinguished from GS1 documentation examples.
GS1 · 2D Barcodes at Retail POS Implementation Guideline · Release 1.1.0 · ratified December 2025 · §4.3 / Table 4-2
Six concepts to separate in the data model
| Concept | Catalog role | Pitfall to avoid |
|---|---|---|
| GTIN | Identifies a trade item under GS1 rules. | A coherent check digit attests neither allocation, authenticity nor availability. |
| SKU | Internal reference used to manage a variant in a merchant system. | An internal reference is not automatically a GTIN; document its scope and rules. |
| ProductGroup | Describes common properties and variant grouping in markup. | The group does not replace the Product entities needed for variants. |
| productGroupID / inProductGroupWithID | Links variants to a consistent group identifier. | If both levels supply this identifier, they must match under Google guidance. |
| Product | Describes a variant using specific attributes and a distinct identifier. | Do not show the group color or size when the page selects another variant. |
| Offer | Describes selling terms attached to the offered product. | Price, currency and availability must match the choice that can actually be bought. |
Six variesBy properties recognized in Google documentation
This list records the six properties supported by Google for variesBy on the review date. It is not an inventory of all Schema.org. Describe only axes actually offered by the catalog.
| Full property | Acceptance use |
|---|---|
https://schema.org/color | Color genuinely selectable on the page. |
https://schema.org/size | Size consistent with the selection and cart. |
https://schema.org/suggestedAge | Suggested age, without inferring a legal permission or regulatory compliance. |
https://schema.org/suggestedGender | Suggested gender audience, when relevant to this catalog. |
https://schema.org/material | Material distinguishing the sold variants. |
https://schema.org/pattern | Pattern distinguishing the sold variants. |
Google Search Central · Product variant structured data · Updated 2026-09-08 · consulted 2026-10-23
Controllo locale della cifra GTIN
Enter a complete string of 8, 12, 13 or 14 digits 0–9, including its final check digit. Spaces, hyphens, GS1 AI prefixes, compressed barcodes and Digital Link URLs are not accepted. The reader preserves leading zeros and shows the weights applied to every digit before the check digit.
Local length and modulo-10 check only. No GS1 registry query, GTIN allocation, brand identification, barcode reading or offer validation. Fourteen-position representation formats the same identifier; it creates no new GTIN. The result remains an arithmetic check. Multi-digit changes can preserve the same check digit: this check does not detect every input error.
GS1 New Zealand · Bar coding basic user guide · Version 3.1 · September 2017 · printed p.57 / PDF p.61 · check-digit algorithm
Risultato aritmetico
| Position from left | Digit | Weight | Product |
|---|
Eight documentation examples and acceptance cases
I01 · Eight-digit GS1 example
95200002
Check digit matches the entered digits. Allocation and product not verified.
Illustrative GS1 Table 4-2 example. The last digit is 2; a coherent key describes neither price nor stock.
- Received length
8- Weighted sum
38- Reached multiple of 10
40- Expected check digit
2- Received check digit
2- Fourteen-position representation
00000095200002
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 9 | 3 | 27 |
| 2 | 5 | 1 | 5 |
| 3 | 2 | 3 | 6 |
| 4 | 0 | 1 | 0 |
| 5 | 0 | 3 | 0 |
| 6 | 0 | 1 | 0 |
| 7 | 0 | 3 | 0 |
GS1 · 2D Barcodes at Retail POS Implementation Guideline · Release 1.1.0 · ratified December 2025 · §4.3 / Table 4-2
I02 · Twelve digits with a leading zero
012345000058
Check digit matches the entered digits. Allocation and product not verified.
GS1 example: retain the leading zero in the string. Integer conversion would erase part of the received representation.
- Received length
12- Weighted sum
42- Reached multiple of 10
50- Expected check digit
8- Received check digit
8- Fourteen-position representation
00012345000058
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 0 | 3 | 0 |
| 2 | 1 | 1 | 1 |
| 3 | 2 | 3 | 6 |
| 4 | 3 | 1 | 3 |
| 5 | 4 | 3 | 12 |
| 6 | 5 | 1 | 5 |
| 7 | 0 | 3 | 0 |
| 8 | 0 | 1 | 0 |
| 9 | 0 | 3 | 0 |
| 10 | 0 | 1 | 0 |
| 11 | 5 | 3 | 15 |
GS1 · 2D Barcodes at Retail POS Implementation Guideline · Release 1.1.0 · ratified December 2025 · §4.3 / Table 4-2
I03 · Thirteen-digit GS1 example
9521101530001
Check digit matches the entered digits. Allocation and product not verified.
Illustrative GS1 example. The expected check digit is 1. Then link the identifier to the variant actually offered.
- Received length
13- Weighted sum
49- Reached multiple of 10
50- Expected check digit
1- Received check digit
1- Fourteen-position representation
09521101530001
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 9 | 1 | 9 |
| 2 | 5 | 3 | 15 |
| 3 | 2 | 1 | 2 |
| 4 | 1 | 3 | 3 |
| 5 | 1 | 1 | 1 |
| 6 | 0 | 3 | 0 |
| 7 | 1 | 1 | 1 |
| 8 | 5 | 3 | 15 |
| 9 | 3 | 1 | 3 |
| 10 | 0 | 3 | 0 |
| 11 | 0 | 1 | 0 |
| 12 | 0 | 3 | 0 |
GS1 · 2D Barcodes at Retail POS Implementation Guideline · Release 1.1.0 · ratified December 2025 · §4.3 / Table 4-2
I04 · Same identifier represented in fourteen positions
09521101530001
Check digit matches the entered digits. Allocation and product not verified.
The GS1 table prefixes the previous example with zero. This 14-position representation creates no new trade item and must not be confused with a newly allocated GTIN-14.
- Received length
14- Weighted sum
49- Reached multiple of 10
50- Expected check digit
1- Received check digit
1- Fourteen-position representation
09521101530001
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 0 | 3 | 0 |
| 2 | 9 | 1 | 9 |
| 3 | 5 | 3 | 15 |
| 4 | 2 | 1 | 2 |
| 5 | 1 | 3 | 3 |
| 6 | 1 | 1 | 1 |
| 7 | 0 | 3 | 0 |
| 8 | 1 | 1 | 1 |
| 9 | 5 | 3 | 15 |
| 10 | 3 | 1 | 3 |
| 11 | 0 | 3 | 0 |
| 12 | 0 | 1 | 0 |
| 13 | 0 | 3 | 0 |
GS1 · 2D Barcodes at Retail POS Implementation Guideline · Release 1.1.0 · ratified December 2025 · §4.3 / Table 4-2
I05 · Final digit changed for testing
9521101530002
Check digit differs from that expected for the entered digits.
CIE case derived from I03: only the last digit changes from 1 to 2. Arithmetic must flag the mismatch without inventing another product.
- Received length
13- Weighted sum
49- Reached multiple of 10
50- Expected check digit
1- Received check digit
2
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 9 | 1 | 9 |
| 2 | 5 | 3 | 15 |
| 3 | 2 | 1 | 2 |
| 4 | 1 | 3 | 3 |
| 5 | 1 | 1 | 1 |
| 6 | 0 | 3 | 0 |
| 7 | 1 | 1 | 1 |
| 8 | 5 | 3 | 15 |
| 9 | 3 | 1 | 3 |
| 10 | 0 | 3 | 0 |
| 11 | 0 | 1 | 0 |
| 12 | 0 | 3 | 0 |
I06 · Length not accepted by the reader
9521101530
Input rejected: 8, 12, 13 or 14 digits 0–9, with no spaces or separators.
Ten digits match none of the four accepted lengths. The reader does not complete a truncated reference.
I07 · Leading space to fix at the source
9521101530001
Input rejected: 8, 12, 13 or 14 digits 0–9, with no spaces or separators.
The reader rejects separators and spaces without silent normalization. Examine the import rule before bulk-changing identifiers.
I08 · Limit of an arithmetic-only check
00000000000000
Check digit matches the entered digits. Allocation and product not verified.
All-zero CIE case: sum and check digit are mathematically coherent. The reader proves no GS1 allocation or product existence; this example is not an identifier to use in a catalog.
- Received length
14- Weighted sum
0- Reached multiple of 10
0- Expected check digit
0- Received check digit
0- Fourteen-position representation
00000000000000
| Position from left | Digit | Weight | Product |
|---|---|---|---|
| 1 | 0 | 3 | 0 |
| 2 | 0 | 1 | 0 |
| 3 | 0 | 3 | 0 |
| 4 | 0 | 1 | 0 |
| 5 | 0 | 3 | 0 |
| 6 | 0 | 1 | 0 |
| 7 | 0 | 3 | 0 |
| 8 | 0 | 1 | 0 |
| 9 | 0 | 3 | 0 |
| 10 | 0 | 1 | 0 |
| 11 | 0 | 3 | 0 |
| 12 | 0 | 1 | 0 |
| 13 | 0 | 3 | 0 |
Direct URL and markup: check the right model
| Architecture | Google guidance | Journey check |
|---|---|---|
| Single page with selectors | One distinct canonical URL for the ProductGroup; every variant remains preselectable by URL. | Open a shared link without remembered choices: correct image, price, availability and the right variant added to cart. |
| Variants across multiple pages | No single canonical URL represents the ProductGroup; each page independently defines the entities it describes. | Check group identity on each page and references to other variants without relying on a remote page to understand the local entity. |
| Variant change | Selected content must stay consistent with the variant recoverable through its URL. | Check back navigation, reload, copied link and cart; retain an understandable unavailable state after stockout. |
Six checks connecting identity and purchase
| CIE case | Evidence to collect | Decision criterion |
|---|---|---|
| C-ID · Catalog import | Raw value, field type, length and any check-digit error. | Preserve the string and zeros; isolate rejected records for source correction without automatically allocating new identifiers. |
| C-GROUP · Same family | Group ID and variant identifiers on two pages. | Do not mix groups; repeated relationships agree even after partial synchronization. |
| C-OFFER · Price and currency | Page, markup, feed and cart observed for one variant at one time. | Amount and currency remain consistent; discrepancies prevent a consistency conclusion. |
| C-STOCK · Stockout after selection | Stock-change journey and the actual displayed message. | An unavailable variant is not silently replaced with another cart reference. |
| C-CACHE · Shared variant | Link opened without a session and after selecting another option. | Cache and local state do not substitute another variant’s image, price or identity. |
| C-KEYBOARD · Variant selector | Keyboard journey, focus and selection announcement. | Selection is accessible, useful updates are understandable and focus remains usable after change. |
For search and visitor experience, stable entities and understandable offers matter more than accumulating identifiers. Markup must describe real data; this reader grants no Google eligibility and guarantees no rich result. Tie fixes to the source catalog, then retest the direct link and cart.
Provenance, editions and credits
Six-property selection and variant guidance adapted from the cited Google documentation under CC BY 4.0 unless otherwise noted. GS1 is credited for facts and numeric examples; original CIE explanations, acceptance cases and code. No GS1 or Google endorsement is implied. Google · CC BY 4.0
GS1 New Zealand · Bar coding basic user guide · SHA-256: 4c7dcaac8453a588e917d7571c908b7058153c65679f42a8359b1455149da4a2
GS1 · 2D Barcodes at Retail POS Implementation Guideline · SHA-256: aadf1b655dd9866a24befef1486ee50a9bd10f3447bda8c35346eb2cb8844b50
Google Search Central · Product variant structured data · SHA-256: f793d8e2d48afe66ef0cdd796fe2401e05913a21fd219c1931cb7f1ef0dae5fe
Google Developers · Site Policies · Google documentation attribution and licensing
Riferimenti ufficiali
I riferimenti supportano il metodo. Adattare i controlli al proprio contesto; non costituiscono una certificazione. I titoli dei riferimenti originali e i documenti di origine potrebbero essere in un'altra lingua.
Riferimenti consultati il .
