TL;DR
- Un resolver GS1 Digital Link è il servizio web che sta dietro al dominio di un GS1 Digital Link. Legge gli identificativi in un indirizzo scansionato e invia chi legge alla destinazione giusta: una pagina prodotto, un avviso di richiamo, un manuale o dati leggibili da una macchina.
- Risponde a tre tipi di richiesta: una scansione semplice porta al link predefinito, la richiesta di un tipo di link specifico porta a quel link, e la richiesta del linkset restituisce tutti i link che il resolver ha per il prodotto.
- I resolver possono essere gestiti da marchi, organizzazioni membro GS1, rivenditori o fornitori di soluzioni. Poiché ognuno è indipendente e segue lo stesso standard GS1, qualsiasi app conforme può usare qualsiasi resolver.
Un resolver GS1 Digital Link è un server web che collega un identificativo GS1, come il GTIN di un prodotto, alle informazioni che lo riguardano online. Quando un telefono scansiona un codice QR GS1 Digital Link, la richiesta arriva al resolver del dominio del codice. Il resolver controlla l'indirizzo, trova i link registrati per quel prodotto, lotto o articolo, e reindirizza a quello adatto alla richiesta. È questo che permette a un solo codice di servire acquirenti, partner commerciali e sistemi, offrendo a ciascuno qualcosa di diverso.
Il resolver in sintesi
| Che cos'è | Un server web che risolve gli identificativi GS1 in risorse online |
| Input | Un URI GS1 Digital Link: dominio, chiave primaria, qualificatori e attributi |
| Output | Un reindirizzamento a una destinazione, un elenco di link o un errore che spiega perché non ce n'è una |
| Chi lo gestisce | Marchi, organizzazioni membro GS1, rivenditori o fornitori di soluzioni |
| Standard | La specifica GS1 per i resolver conformi, insieme alla sintassi dell'URI GS1 Digital Link |
| Protocollo | HTTPS, con risposta alle richieste GET, HEAD e OPTIONS e supporto CORS perché le app web possano interrogarlo |
I tre modi di interrogare un resolver
| Richiesta | Che cosa fa il resolver | Chi la invia di solito |
|---|---|---|
| Una scansione semplice dell'indirizzo | Reindirizza al link predefinito, di solito la pagina prodotto | Il telefono di un acquirente |
L'indirizzo con un parametro linkType, come ?linkType=gs1:recallStatus | Reindirizza al link di quel tipo, se ne ha uno | Un'app o un partner commerciale che cerca qualcosa di specifico |
L'indirizzo con linkType=linkset | Restituisce l'elenco completo dei link che ha per quell'identificativo, in un formato leggibile da una macchina | Sistemi e app che vogliono scoprire tutto ciò che è disponibile |
I link si possono scegliere anche in base alla lingua e al contesto. Un acquirente in Francia può essere inviato alla pagina francese e uno in Germania a quella tedesca, dallo stesso codice.
Che cosa fa un resolver con ogni richiesta
- Decomprimere. Se il codice contiene la forma compressa che lo standard consente per i simboli piccoli, il resolver la espande.
- Convalidare. Controlla la sintassi: una chiave primaria GS1 valida, qualificatori di chiave nell'ordine giusto e attributi di dati validi.
- Cercare. Trova i link registrati per quell'identificativo, al livello più specifico che ha: articolo, lotto o prodotto.
- Scegliere. Seleziona il link che corrisponde alla richiesta: il link predefinito, il tipo di link richiesto o il linkset.
- Rispondere. Restituisce un reindirizzamento, l'elenco dei link o un errore con una spiegazione.
I metadati registrati con ogni link
| Attributo | Obbligatorio | Esempio |
|---|---|---|
| URL di destinazione | Sì | L'indirizzo di una pagina dedicata a quel prodotto, non una homepage o dei risultati di ricerca |
| Tipo di link | Sì | Una pagina di informazioni sul prodotto, gs1:pip |
| Titolo | Sì | «Informazioni sul prodotto», mostrato quando un'app elenca le opzioni |
| Lingua | No | en, fr, de |
| Tipo di media | No | text/html per una pagina, application/json per i dati |
| Contesto | No | Un territorio o un uso, per l'instradamento per mercato |
Una destinazione può avere più di un tipo di link quando una sola pagina svolge più ruoli, ad esempio una pagina prodotto che mostra anche le informazioni sugli allergeni.
Come risponde un resolver
| Situazione | Risposta |
|---|---|
| Esiste un link corrispondente | Un reindirizzamento a quel link (307 Temporary Redirect), con il linkset esposto nell'header HTTP Link |
| Il resolver non ha informazioni, ma un altro resolver potrebbe averle | Un reindirizzamento al resolver alternativo (307) |
| Il resolver non ha informazioni | 404 Not Found |
| Il resolver sa perché non può servire l'identificativo | 303 See Other, che rimanda a una spiegazione |
| L'indirizzo non è ben formato | Una risposta di errore che indica che cosa non va |
I valori della query string nell'indirizzo originale, come la data di scadenza, vengono trasmessi invariati quando il resolver reindirizza. Ogni reindirizzamento in più allunga l'attesa per chi scansiona, quindi le catene di resolver dovrebbero restare brevi.
Come configurare un resolver GS1 Digital Link: cinque passi
- Scegli il dominio. Un sottodominio tuo, come
id.yourbrand.com, mantiene i codici di tua proprietà qualunque sia il fornitore che gestisce il resolver, e mostra agli acquirenti il tuo marchio nell'indirizzo. - Costruiscilo o affidati a un fornitore. Chiunque può costruire un resolver conforme con abbastanza tempo e competenze tecniche. Un fornitore te ne mette a disposizione uno pronto all'uso. In entrambi i casi, verifica che segua lo standard GS1 per i resolver, così che qualsiasi app conforme possa leggere i tuoi codici.
- Carica i prodotti e i loro link predefiniti. Aggiungi ogni GTIN con la sua destinazione predefinita, e aggiungi voci a livello di lotto o di articolo dove servono destinazioni diverse, ad esempio per un richiamo.
- Aggiungi tipi di link, lingue e contesto. Assegna a ogni link il suo tipo e il suo titolo, aggiungi le versioni linguistiche e instrada per mercato dove i contenuti cambiano.
- Prova ogni percorso. Controlla una scansione semplice, una richiesta per ogni tipo di link, il linkset, un GTIN sconosciuto e un indirizzo non ben formato, poi monitora le scansioni dopo il lancio. La guida alla risoluzione dei problemi spiega che cosa controllare quando un codice non si apre.
Il resolver sulla piattaforma Digital Link
Digital Link, la piattaforma dietro questo sito, gestisce un resolver conforme a GS1 per i tuoi codici, sul proprio dominio o sul tuo sottodominio tramite un record CNAME. Ogni prodotto ha una destinazione predefinita, con versioni per lingua e paese, e varianti per lotti o articoli. Ogni link si può cambiare in qualsiasi momento senza ristampare.
Crea il tuo primo codice QR GS1 Digital Link
Domande frequenti
Che cos'è un resolver GS1 Digital Link?
Il servizio web che sta dietro al dominio di un GS1 Digital Link. Legge gli identificativi in un indirizzo scansionato, trova i link registrati per quel prodotto, lotto o articolo, e reindirizza alla destinazione adatta alla richiesta.
Chi gestisce i resolver GS1 Digital Link?
Marchi, organizzazioni membro GS1, rivenditori e fornitori di soluzioni possono gestirne uno. Ognuno è indipendente e, poiché seguono tutti lo stesso standard GS1, un'app può interrogare uno qualsiasi di essi.
Che cos'è un tipo di link?
La categoria di una destinazione che un resolver può offrire per un prodotto, come la pagina di informazioni sul prodotto, gs1:pip, o lo stato di richiamo, gs1:recallStatus. Un'app chiede un tipo di link per ottenere una risorsa specifica invece della pagina predefinita.
Che cos'è un linkset?
L'elenco completo dei link che un resolver ha per un identificativo, restituito in un formato leggibile da una macchina quando un'app chiede linkType=linkset. Permette ai sistemi di scoprire tutto ciò che è disponibile su un prodotto.
Mi serve un resolver mio?
Ti serve un resolver conforme dietro ai tuoi codici, ma non necessariamente uno costruito da te. La maggior parte dei marchi si affida a un fornitore e mette i codici sul proprio sottodominio, così che restino suoi.
La cassa usa il resolver?
No. Una cassa abilitata al 2D legge GTIN, lotto e data di scadenza direttamente dal codice, senza internet. Solo i telefoni e le app che aprono l'indirizzo raggiungono il resolver.
