Statistiky QR kódů přes API: počty skenů do vlastních reportů

Co se počítá

Same-QR počítá u každého dynamického QR kódu, kolikrát byl naskenován. Profil skenujících přitom nevzniká. Počítání získá výpovědní hodnotu dobrým rozdělením: jeden QR kód na místo, reklamní prostředek nebo pobočku. Statistika jednoho QR kódu obsahuje celkový počet skenů, datum vytvoření, kolikrát se změnil cíl a zda je QR kód neaktivní, třeba protože účet překročil limit svého tarifu.

Krok 1: vytvoř klíč pro čtení

Na reporty nikdy nepotřebuješ práva k zápisu. V dashboardu v části Účet, „Přístup pro CLI, skripty a agenty“, vytvoř klíč s úrovní „jen čtení“ a pojmenuj ho podle účelu, třeba „Měsíční report“. Umí zjišťovat čísla, ale nic změnit ani smazat. Zvlášť u úloh, které běží bez dohledu, je to důležité.

Krok 2: získej čísla

Přes REST API vrací seznam všech QR kódů už u každého QR kódu počet skenů, statistiku jednotlivého QR kódu si vyžádáš cíleně:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>/stats

S příkazovým řádkem je to kratší:

sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>

Krok 3: sestav report

Protože počty skenů jsou součty, ukládej každý měsíc stav a porovnej ho s předchozím měsícem. Rozdíl je počet skenů za měsíc. Typické reporty:

• Měsíční report pro klienta agentury se všemi QR kódy jeho projektu.
• Porovnání více poboček, pokud má každá pobočka vlastní QR kódy a vlastní štítek.
• Vyhodnocení plakátové kampaně podle míst.

Jde to i bez vlastního programu: asistent jako ChatGPT nebo Claude se Same-QR jako konektorem odpoví na otázku „Kterých pět QR kódů se skenovalo nejčastěji?“ přímo v konverzaci.

Meze čísel

• Sken neznamená, že si někdo stránku přečetl.
• Málo skenů může být způsobeno místem, třeba špatným světlem nebo příliš malým QR kódem.
• Na chování na webu potřebuješ webovou analytiku. Kampaně s parametry utm propojí obojí.

Závěr: proč Same-QR

Same-QR počítá čistě a šetrně k datům a k číslům se dostaneš, jak ti to vyhovuje: v dashboardu, přes API, přes CLI nebo v rozhovoru s asistentem. Stačí klíč pro čtení a API je součástí každého tarifu.

Začni hned: zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI a server MCP jsou v každém tarifu, dokumentace je na sameqr.com/entwickler.

Často kladené otázky