TL;DR
- Ein GS1-Digital-Link-Resolver ist der Webdienst hinter der Domain in einem GS1 Digital Link. Er liest die Identifikatoren in einer gescannten Adresse und leitet den Leser zum richtigen Ziel: zu einer Produktseite, einem Rückrufhinweis, einer Anleitung oder zu maschinenlesbaren Daten.
- Er beantwortet drei Arten von Anfragen: Ein einfacher Scan führt zum Standardlink, eine Anfrage nach einem bestimmten Link-Typ führt zu diesem Link, und eine Anfrage nach dem Linkset liefert alle Links, die er für das Produkt hinterlegt hat.
- Resolver können von Marken, GS1-Mitgliedsorganisationen, Händlern oder Lösungsanbietern betrieben werden. Weil jeder unabhängig ist und demselben GS1-Standard folgt, kann jede konforme App jeden Resolver nutzen.
Ein GS1-Digital-Link-Resolver ist ein Webserver, der einen GS1-Identifikator, etwa den GTIN eines Produkts, mit den Informationen dazu im Web verbindet. Wenn ein Smartphone einen QR-Code mit einem GS1 Digital Link scannt, geht die Anfrage an den Resolver unter der Domain des Codes. Der Resolver prüft die Adresse, findet die Links, die für dieses Produkt, diese Charge oder diesen Artikel hinterlegt sind, und leitet auf den weiter, der zur Anfrage passt. So kann ein einziger Code Kunden, Geschäftspartner und Systeme bedienen, jeden mit etwas anderem.
Der Resolver auf einen Blick
| Was er ist | Ein Webserver, der GS1-Identifikatoren zu Online-Ressourcen auflöst |
| Eingabe | Eine GS1-Digital-Link-URI: Domain, Primärschlüssel, Qualifikatoren und Attribute |
| Ausgabe | Eine Weiterleitung zu einem Ziel, eine Liste von Links oder ein Fehler, der erklärt, warum es keines gibt |
| Wer ihn betreibt | Marken, GS1-Mitgliedsorganisationen, Händler oder Lösungsanbieter |
| Standard | Die GS1-Spezifikation für konforme Resolver, neben der URI-Syntax von GS1 Digital Link |
| Protokoll | HTTPS, mit Antworten auf GET-, HEAD- und OPTIONS-Anfragen und mit CORS, damit Web-Apps ihn abfragen können |
Die drei Arten, einen Resolver abzufragen
| Anfrage | Was der Resolver tut | Typischer Leser |
|---|---|---|
| Ein einfacher Scan der Adresse | Leitet zum Standardlink weiter, meist der Produktseite | Das Smartphone eines Kunden |
Die Adresse mit einem Parameter linkType, etwa ?linkType=gs1:recallStatus | Leitet zum Link dieses Typs weiter, sofern es einen gibt | Eine App oder ein Geschäftspartner, die etwas Bestimmtes suchen |
Die Adresse mit linkType=linkset | Liefert die vollständige Liste der Links, die er für diesen Identifikator hinterlegt hat, in einem maschinenlesbaren Format | Systeme und Apps, die alles Verfügbare entdecken wollen |
Links lassen sich auch nach Sprache und Kontext auswählen. Eine Kundin in Frankreich kann auf die französische Seite geleitet werden und ein Kunde in Deutschland auf die deutsche, mit demselben Code.
Was ein Resolver mit jeder Anfrage macht
- Dekomprimieren. Trägt der Code die komprimierte Form, die der Standard für kleine Symbole erlaubt, entpackt der Resolver sie.
- Prüfen. Er prüft die Syntax: einen gültigen GS1-Primärschlüssel, Schlüsselqualifikatoren in der richtigen Reihenfolge und gültige Datenattribute.
- Nachschlagen. Er findet die Links, die für diesen Identifikator hinterlegt sind, auf der genauesten Ebene, die er hat: Artikel, Charge oder Produkt.
- Auswählen. Er wählt den Link, der zur Anfrage passt: den Standardlink, den angefragten Link-Typ oder das Linkset.
- Antworten. Er liefert eine Weiterleitung, die Liste der Links oder einen Fehler mit Erklärung.
Die Metadaten zu jedem Link
| Attribut | Pflicht | Beispiel |
|---|---|---|
| Ziel-URL | Ja | Die Adresse einer Seite zu diesem Produkt, keine Startseite und keine Suchergebnisse |
| Link-Typ | Ja | Eine Produktinformationsseite, gs1:pip |
| Titel | Ja | „Produktinformationen“, angezeigt, wenn eine App die Optionen auflistet |
| Sprache | Nein | en, fr, de |
| Medientyp | Nein | text/html für eine Seite, application/json für Daten |
| Kontext | Nein | Ein Gebiet oder ein Verwendungszweck, für die Weiterleitung nach Markt |
Ein Ziel kann mehr als einen Link-Typ tragen, wenn eine Seite mehrere Rollen erfüllt, zum Beispiel eine Produktseite, die auch Allergeninformationen zeigt.
Wie ein Resolver antwortet
| Situation | Antwort |
|---|---|
| Ein passender Link existiert | Eine Weiterleitung dorthin (307 Temporary Redirect), mit dem Linkset im HTTP-Header Link |
| Der Resolver hat keine Informationen, ein anderer Resolver aber vielleicht | Eine Weiterleitung zum alternativen Resolver (307) |
| Der Resolver hat keine Informationen | 404 Not Found |
| Der Resolver weiß, warum er den Identifikator nicht bedienen kann | 303 See Other, mit Verweis auf eine Erklärung |
| Die Adresse ist fehlerhaft | Eine Fehlerantwort, die sagt, was falsch ist |
Werte im Query-String der ursprünglichen Adresse, etwa das Verfallsdatum, werden bei der Weiterleitung unverändert weitergegeben. Jede zusätzliche Weiterleitung kostet die scannende Person Zeit, deshalb sollten Ketten von Resolvern kurz bleiben.
So richten Sie einen GS1-Digital-Link-Resolver ein: fünf Schritte
- Wählen Sie die Domain. Eine eigene Subdomain, etwa
id.yourbrand.com, sorgt dafür, dass die Codes Ihnen gehören, egal welcher Anbieter den Resolver betreibt, und zeigt Kunden Ihre Marke in der Adresse. - Bauen Sie ihn selbst oder nutzen Sie einen Anbieter. Mit genug Zeit und Entwicklungsaufwand kann jeder einen konformen Resolver bauen. Ein Anbieter stellt Ihnen einen einsatzbereiten zur Verfügung. Prüfen Sie in beiden Fällen, dass er dem GS1-Resolver-Standard folgt, damit jede konforme App Ihre Codes lesen kann.
- Laden Sie Ihre Produkte und deren Standardlinks. Legen Sie jeden GTIN mit seinem Standardziel an, und ergänzen Sie Einträge auf Chargen- oder Artikelebene, wo Sie andere Ziele brauchen, zum Beispiel für einen Rückruf.
- Ergänzen Sie Link-Typen, Sprachen und Kontext. Geben Sie jedem Link seinen Typ und Titel, fügen Sie Sprachversionen hinzu und leiten Sie nach Markt weiter, wo sich die Inhalte unterscheiden.
- Testen Sie jeden Weg. Prüfen Sie einen einfachen Scan, eine Anfrage für jeden Link-Typ, das Linkset, einen unbekannten GTIN und eine fehlerhafte Adresse, und beobachten Sie nach dem Start die Scans. Der Leitfaden zur Fehlerbehebung zeigt, was zu prüfen ist, wenn sich ein Code nicht öffnet.
Der Resolver auf der Plattform Digital Link
Digital Link, die Plattform hinter dieser Website, betreibt einen GS1-konformen Resolver für Ihre Codes, auf ihrer eigenen Domain oder über einen CNAME-Eintrag auf Ihrer Subdomain. Jedes Produkt erhält ein Standardziel, mit Versionen nach Sprache und Land und Varianten für Chargen oder Artikel. Jeder Link lässt sich jederzeit ändern, ohne neu zu drucken.
Erstellen Sie Ihren ersten GS1-Digital-Link-QR-Code
Häufig gestellte Fragen
Was ist ein GS1-Digital-Link-Resolver?
Der Webdienst hinter der Domain in einem GS1 Digital Link. Er liest die Identifikatoren in einer gescannten Adresse, findet die Links, die für dieses Produkt, diese Charge oder diesen Artikel hinterlegt sind, und leitet zu dem Ziel weiter, das zur Anfrage passt.
Wer betreibt GS1-Digital-Link-Resolver?
Marken, GS1-Mitgliedsorganisationen, Händler und Lösungsanbieter können alle einen betreiben. Jeder ist unabhängig, und weil alle demselben GS1-Standard folgen, kann eine App jeden von ihnen abfragen.
Was ist ein Link-Typ?
Die Kategorie eines Ziels, das ein Resolver für ein Produkt anbieten kann, etwa die Produktinformationsseite, gs1:pip, oder der Rückrufstatus, gs1:recallStatus. Eine App fragt einen Link-Typ an, um statt der Standardseite eine bestimmte Ressource zu erhalten.
Was ist ein Linkset?
Die vollständige Liste der Links, die ein Resolver für einen Identifikator hinterlegt hat, in einem maschinenlesbaren Format geliefert, wenn eine App linkType=linkset anfragt. Damit können Systeme alles entdecken, was zu einem Produkt verfügbar ist.
Brauche ich einen eigenen Resolver?
Sie brauchen einen konformen Resolver hinter Ihren Codes, aber nicht unbedingt einen, den Sie selbst gebaut haben. Die meisten Marken nutzen einen Anbieter und legen die Codes auf ihre eigene Subdomain, damit sie ihnen gehören.
Nutzt eine Kasse den Resolver?
Nein. Eine 2D-fähige Kasse liest GTIN, Charge und Verfallsdatum direkt aus dem Code, ohne Internet. Nur Smartphones und Apps, die die Adresse öffnen, erreichen den Resolver.
