Statistiche QR Code per API: ottenere gli scan nei propri report

Cosa viene conteggiato

Same-QR conta per ogni codice QR dinamico quante volte è stato scansionato. Non si crea un profilo degli scanner. Il conteggio diventa significativo grazie a una buona suddivisione: un codice QR per luogo, supporto pubblicitario o filiale. La statistica di un codice QR include gli scan totali, la data di creazione, quante volte è stato modificato il target e se il codice QR è 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 QR include già il numero di scan per codice QR; la statistica di un singolo codice QR 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>/stats

Con 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 QR del progetto del cliente.
• Confronto tra più filiali, quando ogni filiale ha codici QR 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 QR 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 QR 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, 20 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