Statistiche QR Code per API: ottenere gli scan nei propri report
Cosa viene conteggiato
Same-QR conta per ogni codice dinamico quante volte è stato scansionato. Non si crea un profilo degli scanner. Il conteggio diventa significativo grazie a una buona suddivisione: un codice per luogo, supporto pubblicitario o filiale. La statistica di un codice include gli scan totali, la data di creazione, quante volte è stato modificato il target e se il codice è inattivo, ad esempio perché l'account ha superato il limite del proprio tariffario.
Passo 1: creare la chiave di lettura
Per i report non servono mai i permessi di scrittura. Nella dashboard, sotto Account, "Accesso per CLI, script e agenti", crea una chiave con "solo lettura" e nominarla in base al tuo scopo, ad esempio "Report mensile". Puoi interrogare i numeri, ma non puoi modificare o eliminare nulla. Questo è importante soprattutto per le attività che vengono eseguite senza supervisione.
Passo 2: recuperare i numeri
Tramite REST-API, l'elenco di tutti i codici include già il numero di scan per codice; la statistica di un singolo codice può essere recuperata specificamente:
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>/statsCon la riga di comando è più breve:
sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>Passo 3: costruire il report
Poiché i numeri di scan sono somme, si memorizza ogni mese un saldo e lo si confronta con il mese precedente. La differenza è il numero di scan del mese. Report tipici:
- Report mensile per un cliente di un'agenzia con tutti i codici del progetto del cliente.
- Confronto tra più filiali, quando ogni filiale ha codici propri e un'etichetta propria.
- Valutazione di una campagna di poster per località.
Non è necessario un programma proprio: un assistente come ChatGPT o Claude, con Same-QR come connettore, risponde direttamente alla domanda "Quali cinque codici sono stati scansionati più frequentemente?" nel corso della conversazione.
Limiti dei numeri
- Una scansione non significa che qualcuno abbia letto la pagina.
- Poche scansioni possono dipendere dalla posizione, ad esempio da una scarsa illuminazione o da un codice troppo piccolo.
- Per il comportamento sul sito web è necessaria l'analisi web. Le campagne con parametri utm collegano entrambi gli aspetti.
Conclusione: perché Same-QR
Same-QR conta in modo pulito e rispettoso dei dati, e tu puoi accedere ai numeri come preferisci: nella dashboard, tramite API, tramite CLI o in conversazione con un assistente. Una chiave di lettura è sufficiente e l'API è inclusa in ogni tariffa.
Inizi subito: registrati gratuitamente su sameqr.com, due codici QR dinamici sono gratuiti per sempre. API, CLI e server MCP sono inclusi in ogni piano, la documentazione è su sameqr.com/entwickler.
Domande frequenti
Scansioni totali, data di creazione, numero di modifiche alla destinazione e se il codice è inattivo. Same-QR non raccoglie dati personali sugli scanner.
Sì, memorizzando una snapshot ogni mese e calcolando la differenza. Uno script con chiave di lettura esegue automaticamente questa operazione.
No. "solo lettura" è sufficiente ed è la scelta più sicura.
Prenota il tuo posto prima del lancio.
Una e-mail appena lo strumento parte — con i prezzi e il piano gratuito. Niente spam, cancellabile in qualsiasi momento.
- Il tuo accesso gratuito è prenotato — al momento non c’è comunque nulla da pagare
- 90 giorni di modifiche della destinazione illimitate invece di 30, solo per chi si registra ora
- Prezzo di lancio garantito, anche se in futuro aumenteremo
Iscrivendoti acconsenti a ricevere la newsletter. Puoi revocare il consenso in qualsiasi momento tramite il link di cancellazione presente in ogni e-mail.