Statistici cod QR prin API: preia scanările în propriile rapoarte

Ce se numără

Same-QR numără, pentru fiecare cod QR dinamic, de câte ori a fost scanat. Nu se creează un profil al celor care scanează. Numărătoarea devine relevantă printr-o bună împărțire: un cod QR pentru fiecare loc, material publicitar sau filială. Statistica unui cod QR conține totalul scanărilor, data creării, de câte ori a fost schimbată destinația și dacă codul QR este inactiv, de exemplu pentru că contul depășește limita tarifului.

Pasul 1: creează o cheie de citire

Pentru rapoarte nu ai nevoie niciodată de drepturi de scriere. În tabloul de bord, la Cont, „Acces pentru CLI, scripturi și agenți”, creează o cheie cu „doar citire” și dă-i un nume după scop, de exemplu „Raport lunar”. Cu ea poți interoga cifrele, dar nu poți modifica sau șterge nimic. Mai ales pentru sarcinile care rulează nesupravegheate, asta contează.

Pasul 2: preia cifrele

Prin API-ul REST, lista tuturor codurilor QR conține deja numărul de scanări pentru fiecare cod QR, iar statistica unui singur cod QR o ceri țintit:

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

Cu linia de comandă merge mai scurt:

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

Pasul 3: construiește raportul

Fiindcă numărul de scanări este un total cumulat, salvezi în fiecare lună o situație și o compari cu luna precedentă. Diferența este numărul de scanări din lună. Rapoarte tipice:

• Raport lunar pentru un client al agenției, cu toate codurile QR din proiectul lui.
• Comparație între mai multe filiale, dacă fiecare filială are coduri QR proprii și o etichetă proprie.
• Evaluarea unei campanii de afișaj pe locații.

Merge și fără program propriu: un asistent precum ChatGPT sau Claude, cu Same-QR ca Connector, răspunde direct în conversație la întrebarea „Care sunt cele cinci coduri QR scanate cel mai des?”.

Limitele cifrelor

• O scanare nu înseamnă că cineva a citit pagina.
• Puține scanări pot depinde de loc, de exemplu de lumina slabă sau de un cod QR prea mic.
• Pentru comportamentul de pe site ai nevoie de analiza web. Campaniile cu parametri utm le leagă pe amândouă.

Concluzie: de ce Same-QR

Same-QR numără corect și cu puține date, iar tu ajungi la cifre cum îți convine: în tabloul de bord, prin API, prin CLI sau în conversație cu un asistent. Îți ajunge o cheie de citire, iar API-ul este inclus în orice tarif.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite permanent. API, CLI și server MCP există în orice tarif, iar documentația se află pe sameqr.com/entwickler.

Întrebări frecvente