← Wróć do bloga
AI i automatyzacja2 min czytania

Statystyki kodu QR przez API: pobieraj skanowania do własnych raportów

Zdjęcie z Unsplash

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>/stats

W 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.

Twórz dynamiczne kody QR za darmo
Zacznij od 20 dynamicznych kodów QR, które są darmowe na zawsze. Bez subskrypcji, bez karty kredytowej.
Zacznij za darmo →

Najczęściej zadawane pytania

Jakie dane dostarcza statystyka?

Łą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.

Czy mogę analizować skanowania według miesięcy?

Tak, zapisując co miesiąc stan i obliczając różnicę. Skrypt z kluczem do odczytu robi to automatycznie.

Czy do raportów potrzebuję klucza do zapisu?

Nie. „Tylko odczyt” wystarcza i jest bezpieczniejszym wyborem.

Newsletter

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.

Czytaj dalej