Toplu QR Kod Üretimi: CSV'den Baskıya Hazır Dosyalara

Toplu QR kod üretimi, satır başına iki API çağrısı ve sonunda bir klasördür. Her hedef için bir kısa bağlantı oluşturun, o kısa bağlantı için bir QR kodu üretin, SVG ve PNG'yi diske yazın. 5.000 ürünlük bir elektronik tablo, birkaç dakikada 5.000 baskıya hazır dosyaya dönüşür.

Karar araçta değil. Karar, kodun neyi kodladığında. Hedefi doğrudan kodlarsanız kod, baskıya girdiği anda donar; 5.000 etiketlik bir baskıdaki tek yanlış URL tüm baskıyı hurdaya çevirir. Kontrol ettiğiniz bir kısa bağlantıyı kodlarsanız hedef sonsuza dek düzenlenebilir kalır ve her kod sessizce kendi taramalarını raporlar.

Binlerce yerine tek bir kod mu yapıyorsunuz? QR kodu nasıl oluşturulur daha basit anlatım, sıfırdan QR kod kampanyası ise yerleşim ve ölçümü kapsıyor.

Dört Aşamalı Hat

CSV'de gereksiz görünse bile bir id sütunu tutun. Dosya adı, idempotency anahtarı ve tasarım ekibi "412 numaralı kod yanlış" diye döndüğünde eşleştireceğiniz şey olur. Onsuz URL'lerle eşleştirirsiniz ve URL'ler uzundur, yanlış yazması kolaydır.

import csv, base64, hashlib, pathlib, os, requests

API = "https://api.elido.app"
HEAD = {"Authorization": f"Bearer {os.environ['ELIDO_API_KEY']}"}
out = pathlib.Path("qr-out")
out.mkdir(exist_ok=True)

with open("products.csv") as f:
    for row in csv.DictReader(f):        # columns: id, destination
        key = hashlib.sha256(row["destination"].encode()).hexdigest()

        link = requests.post(
            f"{API}/v1/links",
            headers={**HEAD, "Idempotency-Key": key},
            json={"destination_url": row["destination"]},
            timeout=10,
        )
        link.raise_for_status()
        short_url = link.json()["short_url"]

        qr = requests.post(
            f"{API}/v1/qr/generate",
            headers=HEAD,
            json={
                "content": short_url,          # the short link, never the destination
                "formats": ["svg", "png"],
                "size": 1024,
                "error_correction": "M",
            },
            timeout=20,
        )
        qr.raise_for_status()
        payload = qr.json()

        (out / f"{row['id']}.svg").write_text(payload["svg"])
        (out / f"{row['id']}.png").write_bytes(base64.b64decode(payload["png"]))
        print(row["id"], short_url)

Idempotency anahtarı hedeften türetildiği için, üç satırı düzelttikten sonra dosyayı yeniden çalıştırmak hiçbir şeyi iki kez oluşturmaz ve hiçbir maliyeti yoktur. Bir toplu işi tekrarlanabilir kılan bu özellik ve bunu 5.000 satıra yöneltmeden önce düzgün anlamaya değer: hız sınırları ve idempotency mekaniği anlatıyor.

Yukarıdaki döngü sıralı; birkaç yüz satıra kadar sorun değil. Ötesinde yaklaşık sekizini paralel çalıştırın; Python ve JavaScript rehberlerinin ikisinde de doğrudan alabileceğiniz sınırlı eşzamanlılık kalıbı var.

Çalıştırmak ister misiniz? Ücretsiz planda bir anahtar oluşturun, ELIDO_API_KEY değişkenini dışa aktarın ve gerçek dosyaya yöneltmeden önce betiği beş satırlık bir CSV'ye yöneltin.

Ölçekte Statik mi Dinamik mi

Statik kodun tam olarak bir avantajı var: hiçbir şeye bağımlı değil. Canlı tutulacak alan adı yok, ödemeye devam edilecek servis yok. Bu, satıcı sözleşmenizden daha uzun yaşayacak bir makineye kazınmış kod için önemli, başka neredeyse hiçbir yerde önemli değil.

Geri kalan her şey dinamikten yana. Kod başına tarama sayıları: raf yerleşimlerini veya mağaza konumlarını karşılaştırmanın tek yolu. Kampanya sayfası taşındığında düzeltebileceğiniz bir hedef. Ve daha küçük, daha seyrek kodlar, çünkü kısa bağlantı etiketli bir ürün URL'sinin karakterlerinin yalnızca bir kesri kadar. Dinamik ve statik QR kodları tam karşılaştırmayı veriyor.

Gerçekten Önemli Baskı Ayarları

Toplu işin gerçek dünyada taranıp taranmayacağını üç parametre belirler.

Hata düzeltme. M düzeyi yaklaşık yüzde 15 hasardan kurtarır ve kodu seyrek tutar. Ortada bir logo varsa ya da kod elle tutulacak, aşınacak veya eğri bir yüzeye basılacaksa Q'ya geçin. H daha güvenli gibi duyulur ve genellikle değildir: ek yedeklilik daha fazla modül sığdırır ve daha yoğun kodlar küçük boyutlarda daha zor taranır. QR standardı dört düzeyi de belgeliyor.

Biçim. Baskı için SVG, çünkü modül kenarlarını yumuşatmadan bir posteri dolduracak kadar ölçeklenir. Slaytlar, pazar yerleri ve vektör reddeden her şey için PNG. Tek istekte ikisini birden isteyin, başkası diğerine ihtiyaç duyduğunda gidiş gelişi atlarsınız.

Sessiz bölge. Kodun çevresindeki boş kenar boşluğu kodun parçasıdır. Dört modül belirtilen asgari değerdir ve tasarımcılar boşa yer gibi göründüğü için onu düzenli olarak kırpar. Dar kenarlıklı bir kod ucuz telefon kameralarında kötü taranır ve kimse ikisini birbirine bağlamaz.

Tüm toplu iş için bir boyut belirlemeden önce bilmeye değer bir şey daha: veri miktarı sürümü, sürüm ise kodun kaç modülü olacağını belirler. Biçimi icat eden Denso Wave, sürüm ve kapasite tablosunu yayımlıyor. 30 karakterlik bir kısa bağlantı tablonun alt kısmına yakın durur; 180 karakterlik etiketli bir ürün URL'si durmaz ve fark, aynı basılı boyutta gözle görülür biçimde daha yoğun bir kod olarak ortaya çıkar.

Dosyadaki boyut, nesnedeki boyuttan daha az önemli. Bir QR kodu ne kadar büyük olmalı yazısında, fiziksel boyutu belirleyen tarama mesafesi kuralı var.

Baskıya Girmeden Önce Doğrulayın

Bir toplu iş üretin, sonra rastgele beş kodu kontrol edin. Masanızda tam ekran parlaklıkta değil: tam basılacakları boyutta yazdırın, birini rafa veya ambalaja bantlayın ve bir müşterinin duracağı yerden tarayın.

Sonra yönlendirmenin kendisini kontrol edin. Üç kısa bağlantıda curl -sI, doğru hedefe bir yönlendirme döndürdüklerini doğrular; CSV'nin ikinci sütununun üçüncü sütun olarak okunduğu ve her kodun komşu ürüne işaret ettiği klasik bir birim kayması hatasını yakalar. O hata sessizdir, her görsel kontrolden sağ çıkar ve yalnızca hedefte görünür.

Toplu işi üreten CSV'yi, içinde id, hedef, kısa bağlantı ve dosya adıyla birlikte saklayın. Altı ay sonra biri hangi kodun hangi paletde olduğunu sorduğunda cevap o dosyadır ve onu panodan yeniden üretmek, saklamaktan çok daha fazla iştir.

Taramalar Nerede Görünür

Kodlar yayına girdikten sonra her biri ayrı raporlanır. Paylaşılan tek kod yerine öğe başına bir kodun tüm nedeni bu: tek kod kampanyanın işe yaradığını söyler, öğe başına kodlar hangi mağazanın, rafın veya SKU'nun işe yaradığını söyler.

QR kodu taramaları nasıl takip edilir bu veriyi okumayı, bağlantı olayları için webhook'lar ise taramaları bir panoya bakmak yerine kendi sistemlerinize itmeyi anlatıyor. Özellikle fiziksel ürün bağlamı için, dijital ürün pasaportu QR kodları aynı hattın düzenleyici sürümünü kapsıyor.

Temel Seriyi Okuyun

Bu yazı özellikler kümesinde yer alıyor. Tek kod sürümü için QR kodu nasıl oluşturulur ile başlayın, kampanya tasarımı için ardından sıfırdan QR kod kampanyası yazısına geçin. QR kodları özellik sayfası, bu betiğin atladığı stil seçeneklerini kapsıyor.

Blogda İlgili Yazılar

• Dinamik ve statik QR kodları: hangisine ihtiyacınız var
• Baskı için QR kodu ne kadar büyük olmalı?
• QR kodu taramaları nasıl takip edilir
• Google Sheet'ten toplu kısa bağlantı içe aktarma