GS1 Digital Link Nasıl Kurulur

Tüketiciye dönük kod yazımızda GS1 Digital Link'in ne olduğunu anlattık: ürün numarasını bir web adresinin içine yerleştiren, böylece aynı kodun hem kasada hem telefonda çalışmasını sağlayan yapı.

Bu yazı onun devamı ve "nasıl" tarafı. Kurulum beş karardan oluşuyor ve bunların hiçbiri teknik olarak zor değil — zor olan, hangisinin geri dönüşü olmadığını bilmek.

Çünkü şu gerçek her şeyi belirliyor: ambalaj basıldıktan sonra koddaki adres değişmez. Sunucu tarafını istediğiniz zaman değiştirirsiniz, ama kodun içindeki karakterler artık sabittir.

Adım 1: URL'yi Kur

Standart hiçbir alan adını zorunlu kılmıyor. Dokümanlardaki example.org yalnızca bir örnek; kendi alan adınızı kullanabilirsiniz — ve kullanmalısınız.

Ama uygulama rehberi net bir tavsiye veriyor: kısa alan adı kullanın, çünkü kısa URL demek.

Bunun sebebi estetik değil. URL uzadıkça QR kodun modül sayısı artar; aynı fiziksel alana daha çok modül sığdırmak demek, her modülün küçülmesi demek. Küçük ambalajda bu doğrudan okunmama sonucunu verir. Etiket ölçüleri yazımızdaki mantık burada da geçerli.

Üç kural

1. Alan adından sonrası büyük/küçük harfe duyarlıdır. Standart bunu açıkça söylüyor: alan adının ardından gelen kısım case sensitive. Parti kodunu bir yerde LOT2026A, başka yerde lot2026a yazarsanız bunlar iki farklı kaynak olur. Baştan bir yazım kuralı belirleyin.
2. Kimlik alanları yolda, betimleyici veriler sorguda. GTIN ve parti numarası yol segmentine, son kullanma tarihi ve ağırlık gibi alanlar sorgu dizesine gider.
3. Kendi alan adınızı kullanın. Üçüncü taraf bir kısaltma servisi kapanırsa basılmış bütün ambalaj ölü bağlantıya döner. Bu, listedeki geri dönüşü olmayan tek hatadır.

Adım 2: Çözümleyiciyi Seç

Çözümleyici (resolver), gelen isteği doğru sayfaya yönlendiren sunucudur. Uygulama rehberi üç seçenek tanımlıyor:

Kendi sunucunuz

GS1'in Resolver Community Edition adlı açık kaynak yazılımı var; Apache-2.0 lisanslı ve Docker ile kuruluyor. Tam kontrol sizde olur.

İki uyarı: yazılım GS1 tarafından aktif olarak bakımlanmıyor, topluluk tarafından geliştiriliyor. Ve güvenlik ile kişisel veri uyumluluğu incelemesi tamamen sizin sorumluluğunuzda.

GS1 üye kuruluşu

Yerel GS1 örgütünün işlettiği bir çözümleyici hizmeti olabilir. Kurulum ve bakım yükü ortadan kalkar, standarda uygunluk doğrudan kaynağından gelir.

Hizmetin kapsamı ülkeye göre değişiyor, dolayısıyla bunu kendi GS1 kuruluşunuza sormanız gerekir.

Ticari sağlayıcı

En hızlı başlangıç. Genelde analitik ve yönetim paneli de birlikte gelir.

Buradaki risk bağımlılık. Sözleşme yaparken tek bir şeyi doğrulayın: kendi alan adınızı kullanabiliyor musunuz? Kullanabiliyorsanız çıkışınız her zaman açıktır.

Kilitlenmeyin

Standart, çözümleyicilerin birbirine yönlendirebileceğini söylüyor. Yani bugün ticari bir hizmetle başlayıp yarın kendi sunucunuza taşınmanız mümkün.

Şartı yukarıda: alan adı sizin olsun. Alan adı sizdeyse çözümleyici bir uygulama detayıdır; değilse stratejik bir bağımlılıktır.

Adım 3: Bağlantıları Tanımla

İşin asıl düşünmeyi gerektiren yeri burası.

Bir Digital Link URI'si tek bir sayfaya sabitlenmek zorunda değil. İsteyen taraf, linkType sorgu parametresiyle hangi tür içeriği aradığını söyleyebilir:

.../01/08691234567807?linkType=gs1:instructions

Değerler GS1 Web Sözlüğü'nden gelir. Sık kullanılanlardan birkaçı:

• gs1:pip — ürün bilgi sayfası
• gs1:instructions — kullanım kılavuzu
• gs1:nutritionalInfo — beslenme bilgisi
• gs1:allergenInfo — alerjen bilgisi
• gs1:epil — hasta bilgi broşürü
• gs1:certificationInfo — sertifika bilgisi

Varsayılan bağlantı zorunludur

Bu, kurulumda en sık atlanan nokta. Standart, tanımlanan her varlık için tam olarak bir varsayılan bağlantı bulunmasını şart koşuyor.

Neden önemli: müşterinin telefonu linkType göndermez. Kamerayla kodu okutur, tarayıcı adrese gider, hepsi bu. Yani gerçek tüketici trafiğinin tamamı varsayılan bağlantıya düşer.

Varsayılanı tanımlamazsanız, bütün kurulum teknik olarak doğru görünürken kodu okutan kişi hiçbir yere gitmez.

Dil gibi tercihlere göre incelmiş varsayılanlar için ayrıca defaultLinkMulti tanımlanabiliyor.

Çözümleyici Ne Döndürür?

Kurulumu test ederken doğru cevabın ne olduğunu bilmek gerekir:

• 3xx — yönlendirme. İstenen bağlantı türü bulundu, tarayıcı hedefe gönderiliyor. Beklenen normal davranış budur.
• 404 — bulunamadı. İstenen linkType bu ürün için tanımlı değil. Testlerde bunu görüyorsanız çoğu zaman varsayılan bağlantı eksiktir.
• 300 — çoklu seçenek. Aynı türden birden fazla kaynak var ve hangisinin isteneceği belirsiz; seçenekler listeleniyor.

Dile ve bağlama göre yönlendirme

Çözümleyici, tarayıcının gönderdiği Accept-Language başlığına bakarak aynı bağlantı türünün farklı dildeki sürümüne yönlendirme yapabilir. Türkçe ve İngilizce sayfanız varsa bunu kullanın — ayrı kod basmanıza gerek yok.

Benzer şekilde coğrafya ya da perakendeci gibi bağlamlara göre de farklı kaynak seçilebiliyor. İhracat yapıyorsanız bunu planınıza baştan ekleyin.

Adım 4: Kodu Üret

Standart veri taşıyıcı konusunda tarafsız — Digital Link URI'sini istediğiniz koda koyabilirsiniz. Ama tüketiciye dönük kullanımda uygulama rehberi net:

• QR kod — akıllı telefonla doğrudan taranır, ayrı uygulama gerekmez.
• GS1 DataMatrix ve doğrusal barkodlar — Digital Link'i anlayan bir uygulama gerektirir.

Yani müşteri okutacaksa QR. Terim karışıklığı için karekod mu, QR kod mu yazımıza bakabilirsiniz.

Kodu üretirken QR kod nasıl oluşturulur yazımızdaki genel kurallar geçerli: sessiz bölge bırakın, kontrastı düşürmeyin, ambalajdaki gerçek boyutunu hesaba katın.

Bir not: sıkıştırılmış biçim

Standart, Digital Link URI'sinin sıkıştırılmış bir biçimini de tanımlıyor. Bu biçim özellikle NFC etiketi gibi veri taşıyıcıları için düşünülmüş — yani sınırlı alana daha az karakter yazmak gerektiğinde. QR ile başlıyorsanız buna girmenize gerek yok.

Adım 5: Yayına Almadan Önce Test

Basılan ambalaj geri alınamaz. Sıra şu:

1. Çözümleyici uygunluk testi. GS1'in açık kaynak test paketi, çözümleyicinizin standarda uygun davranıp davranmadığını ölçüyor. Kendi sunucunuzu kurduysanız bu adımı atlamayın.
2. Varsayılan bağlantıyı ayrıca test edin. linkType belirtmeden istekte bulunun — müşterinin telefonu tam olarak bunu yapıyor.
3. Gerçek telefonla okutun. iOS ve Android'de ayrı ayrı. Kamera uygulaması kodu tanıyor mu, açılan sayfa mobilde düzgün görünüyor mu?
4. Kasadaki okuyucuda deneyin. 2D okuyabilen bir okuyucu URL'den GTIN'i ayıklayabiliyor mu? Ayıklayamıyorsa doğrusal barkodu kaldırmak söz konusu bile olamaz.
5. Küçük boyutta basıp okutun. Ekranda okunan kod, ambalajdaki gerçek boyutunda okunmayabilir. Bu, ekran üzerinde yapılan testlerin en sık yanılttığı yer.
6. Hedef sayfayı değiştirip tekrar deneyin. Kod aynı kalırken içeriği güncelleyebildiğinizi doğrulayın — bütün yatırımın karşılığı bu.

Geçiş: Eski Sözdizimi Kaybolmuyor

Kurulumda çok rahatlatan bir gerçek var: uygulama rehberine göre geleneksel AI sözdizimi ile Digital Link sözdizimi tamamen birbirine çevrilebilir.

Yani GS1-128 etiketlerinizde kullandığınız (01), (10), (17) yapısı ile Digital Link URL'i aynı verinin iki gösterimi. GS1 bu çeviriyi yapan açık kaynak araçlar da yayımlıyor.

Pratik sonucu şu: sistemlerinizi baştan yazmanız gerekmiyor. Mevcut ürün verinizi tutan yapı aynı kalır, üzerine bir dönüşüm katmanı eklersiniz.

Sık Yapılan Beş Hata

1. Varsayılan bağlantıyı tanımlamamak. Test ederken linkType ile istek yaparsanız her şey çalışıyor görünür; gerçek müşteri trafiği ise 404 alır.
2. Başkasının alan adını kullanmak. Ambalaj basıldıktan sonra bu karar geri alınamaz.
3. Büyük/küçük harf tutarsızlığı. Aynı partiyi iki farklı yazımla kaydetmek, sessizce iki ayrı kayıt üretir.
4. Doğrusal barkodu erken kaldırmak. Zincirdeki bütün okuyucuların 2D okuduğundan emin olmadan bunu yapmayın.
5. Yalnızca ekranda test etmek. Kod ambalajda basılı hâliyle, gerçek boyutunda ve gerçek telefonlarla denenmeden yayına alınmamalı.

Sıkça Sorulan Sorular

Çözümleyici kurmadan Digital Link kullanabilir miyim?

Teknik olarak URL'yi kendi web sunucunuzda basit bir yönlendirme kuralıyla da karşılayabilirsiniz. Ancak linkType, dil ve bağlam yönlendirmesi gibi yetenekleri kaybedersiniz. Tek bir sayfaya gidecekseniz bu yeterli olabilir; ilerisi için çözümleyici gerekir.

Her ürün için ayrı kayıt mı girmem gerekiyor?

Çözümleyicide her GTIN için bağlantıların tanımlanması gerekir. Ürün sayısı fazlaysa bunu elle değil, ürün veri tabanınızdan besleyecek bir aktarımla kurun — çözümleyicilerin veri giriş servisleri bunun için var.

Parti ve seri numarası eklemek zorunda mıyım?

Hayır. En basit hâliyle yalnızca GTIN yeterli: alanadi/01/08691234567807. Parti ve seri numarası, izlenebilirlik ya da tazelik bilgisi gibi ihtiyaçlar varsa eklenir. Uygulama rehberi de kademeli ilerlemeyi öneriyor — önce mevcut dijital varlıklarınızı bağlayın, ayrıntıyı sonra ekleyin.

QR kodu ambalajda nereye koymalıyım?

Doğrusal barkodun bulunduğu yüzeyde ama ondan ayrı bir alanda. İki kodun birbirinin sessiz bölgesini yememesi gerekir; yerleşim kuralları için barkod etiketi ölçüleri ve yerleşim kuralları yazımıza bakın.

Kodun sahtesi yapılırsa ne olur?

Basılı bir QR'ın üstüne başka bir etiket yapıştırmak kolaydır. Kendi alan adınızı kullanmak burada da işe yarar: müşteri açılan adreste markanızın adını görür. Ayrıntısı QR kod dolandırıcılığı yazımızda.

Bu kurulum kasadaki sistemi etkiler mi?

Hayır — doğrusal barkodu yerinde bıraktığınız sürece kasa tarafında hiçbir şey değişmez. Digital Link'i ekleme olarak düşünün, değiştirme olarak değil.

Sonuç

Beş adımın dördü geri alınabilir. Çözümleyiciyi değiştirebilir, bağlantıları yeniden tanımlayabilir, hedef sayfaları güncelleyebilir, testleri tekrarlayabilirsiniz.

Geri alınamayan tek şey ambalaja basılan adres. O yüzden zamanınızın çoğunu birinci adıma ayırın: kısa, sizin olan, uzun ömürlü bir alan adı seçin.

Ve kurulumu bitirmeden önce tek bir şeyi iki kez kontrol edin: varsayılan bağlantı tanımlı mı? Çünkü kodu okutan gerçek insanların tamamı oraya düşecek.

Kavramın kendisi için NFC ve barkod: tüketiciye dönük kullanım, numaralandırmanın temeli için GTIN nedir yazımıza göz atabilirsiniz.