Statystyki kodu QR przez API: pobieraj skanowania do własnych raportów
Co jest liczone
Same-QR liczy dla każdego dynamicznego kodu QR, ile razy został zeskanowany. Profil skanujących przy tym nie powstaje. Liczba skanowań nabiera wartości dzięki dobremu podziałowi: jeden kod QR na miejsce, materiał reklamowy lub oddział. Statystyka kodu QR zawiera łączną liczbę skanowań, datę założenia, ile razy zmieniono cel oraz informację, czy kod QR jest nieaktywny, na przykład dlatego, że konto przekracza limit swojej taryfy.
Krok 1: utwórz klucz do odczytu
Do raportów nigdy nie potrzebujesz uprawnień do zapisu. Utwórz w panelu w sekcji Konto, „Dostęp dla CLI, skryptów i agentów”, klucz z uprawnieniem „tylko odczyt” i nazwij go zgodnie z celem, na przykład „Raport miesięczny”. Może pobierać liczby, ale niczego zmieniać ani usuwać. Szczególnie przy zadaniach działających bez nadzoru jest to ważne.
Krok 2: pobierz liczby
Przez REST API lista wszystkich kodów QR zawiera już liczbę skanowań dla każdego kodu QR, a statystykę pojedynczego kodu QR pobierasz celowo:
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>/statsW wierszu poleceń jest krócej:
sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>Krok 3: zbuduj raport
Ponieważ liczby skanowań są sumami, co miesiąc zapisujesz stan i porównujesz go z poprzednim miesiącem. Różnica to liczba skanowań w miesiącu. Typowe raporty:
- Raport miesięczny dla klienta agencji ze wszystkimi kodami QR jego projektu.
- Porównanie kilku oddziałów, gdy każdy oddział ma własne kody QR i własną etykietę.
- Analiza kampanii plakatowej według lokalizacji.
Można też bez własnego programu: asystent taki jak ChatGPT lub Claude z Same-QR jako konektorem odpowie na pytanie „Które pięć kodów QR skanowano najczęściej?” wprost w rozmowie.
Ograniczenia liczb
- Skanowanie nie oznacza, że ktoś przeczytał stronę.
- Mało skanowań może wynikać z miejsca, na przykład ze słabego światła lub zbyt małego kodu QR.
- Do zachowania na stronie potrzebujesz analityki webowej. Kampanie z parametrami utm łączą jedno z drugim.
Podsumowanie: dlaczego Same-QR
Same-QR liczy rzetelnie i oszczędnie pod względem danych, a do liczb docierasz tak, jak ci wygodnie: w panelu, przez API, przez CLI lub w rozmowie z asystentem. Wystarczy klucz do odczytu, a API jest w każdej taryfie.
Zacznij od razu: zarejestruj się za darmo na sameqr.com, 20 dynamicznych kodów QR jest na stałe bezpłatne. API, CLI i serwer MCP są w każdej taryfie, dokumentacja jest na sameqr.com/entwickler.
Najczęściej zadawane pytania
Łączną liczbę skanowań, datę założenia, liczbę zmian celu i informację, czy kod QR jest nieaktywny. Danych osobowych skanujących Same-QR w tym celu nie zbiera.
Tak, zapisując co miesiąc stan i obliczając różnicę. Skrypt z kluczem do odczytu robi to automatycznie.
Nie. „Tylko odczyt” wystarcza i jest bezpieczniejszym wyborem.
Nowe artykuły prosto na Twoją skrzynkę
Wskazówki o dynamicznych kodach QR, nowości, bez spamu. Wypisać się można w każdej chwili.
Zapisując się, wyrażasz zgodę na otrzymywanie newslettera. Zgodę możesz w każdej chwili wycofać za pomocą linku do wypisania się w każdej wiadomości.