Co potwierdza raport, a czego nie rozstrzyga
Obserwacja systemu, deklaracja wykonawcy, wynik i interpretacja są oznaczone osobno. Brak wykrytej zmiany nie jest dowodem braku pracy.
Każda informacja ma swoje miejsce.
Obserwacja
Pobrane zdarzenie lub stan ze wskazanego źródła.
Przykład: Nagłówek oferty różni się między pomiarami z 4 i 5 listopada.
Deklaracja
Informacja o pracy podana przez człowieka. Nie jest niezależnym odczytem.
Przykład: Wykonawca zgłosił aktualizację opisu oferty.
Wynik
Metryka o zdefiniowanej jednostce i okresie.
Przykład: 120 kliknięć w tygodniu według Search Console.
Interpretacja
Wniosek lub pytanie z odniesieniem do danych. Nie rozstrzyga przyczyny.
Przykład: Pytanie do wykonawcy: czy zmiana nagłówka była jedyną zmianą w ofercie?
- „Odebrane przez klienta” to stan odbioru deklaracji, a nie niezależna obserwacja.
- Liczby w raporcie oblicza kod według definicji ze słownika metryk. Interpretacja może postawić pytanie, ale nie przypisuje winy i nie rozstrzyga przyczyny.
- Raport nie ocenia uczciwości wykonawcy.
Czas: kiedy coś się stało, a kiedy to odczytaliśmy
Przy każdej informacji zapisujemy czas zdarzenia lub okres, czas obserwacji i czas pobrania ze źródła.
Gdy czas zmiany nie jest znany, piszemy „nastąpiła między pomiarami”. Nie podajemy godziny pobrania jako godziny zmiany.
Własna historia zaczyna się od pierwszego udanego pomiaru, a zmiana powstaje dopiero po dwóch porównywalnych pomiarach. Import historii zachowuje źródło i czas importu — nie jest wcześniejszym monitoringiem.
Okresy liczymy według strefy czasowej projektu. Tygodnie porównujemy od poniedziałku do niedzieli, z poprzednim analogicznym tygodniem. Miesiące mają różną długość, dlatego pokazujemy łączny wynik i średnią na dzień; z dwóch punktów nie wyciągamy wniosków o sezonowości.
Każde źródło ma własne opóźnienie. Raport pokazuje, do kiedy sięgają dane, i oznacza dane wstępne.
Pokrycie: ile danych naprawdę mamy
Pokrycie pomiarów to liczba wykonanych porównywalnych pomiarów względem zaplanowanych w uzgodnionym zakresie. Osobno pokazujemy liczbę dostępnych wymaganych źródeł względem wszystkich wymaganych. Tych dwóch wskaźników nie uśredniamy.
Wyłączenie źródła zmienia zakres dopiero od nowej wersji — nie poprawia wstecz pokrycia wcześniejszego raportu. Brak kolejnego pomiaru oznacza niepełne porównanie, nawet gdy pierwszy punkt jest zapisany.
Przykład komunikatu: „Raport obejmuje 2 z 3 wymaganych źródeł. GA4 nie dostarczyło danych za ten okres.”
Statusy danych
- kompletnePoprawny odczyt za cały okres.
- wstępneŹródło może jeszcze skorygować te dane. Raport oznacza je jako wstępne.
- nieaktualneOstatni poprawny odczyt jest starszy niż okres raportu. Pokazujemy jego datę.
- brak odczytuŹródło nie odpowiedziało lub zwróciło błąd. To nie oznacza braku zmian.
- brak uprawnieńDostęp wygasł lub został cofnięty. Połącz źródło ponownie.
- nieobsługiwaneTen rodzaj danych nie jest obsługiwany albo źródło nie jest skonfigurowane.
Zero to nie to samo co brak danych
Co oznacza brak danych? Źródło nie dostarczyło wartości dla danego zakresu. To inny stan niż zero.
Zero jest wartością tylko przy poprawnym odczycie. Gdy danych nie ma, raport pokazuje brak wartości z powodem — nigdy zero.
„Bez zmian” piszemy wyłącznie po poprawnym porównaniu dwóch porównywalnych stanów.
- Zmianę procentową liczymy tylko wtedy, gdy wcześniejsza wartość jest większa od zera. Przy wzroście z 0 do 5 piszemy: „5 więcej; brak procentu względem zera”.
- Gdy CTR rośnie z 2% do 3%, to +1 punkt procentowy i względnie +50%. Te dwie wartości oznaczamy osobno.
- Walut nie sumujemy automatycznie; przy kwotach podajemy, czy są netto, czy brutto.
Korekty i wersje raportu
Wersja raportu jest niezmienna. Utrwala moment odcięcia danych, definicje i pobrane wartości.
Korekta danych tworzy nową wersję z opisem zmian. Wcześniejszy plik PDF pozostaje oznaczony swoją wersją, a przy jego otwarciu widać, że istnieje nowsza.
Każda wysyłka wskazuje konkretną wersję. Wysłanego pliku nie podmieniamy.
Słownik metryk
| Metryka | Jak liczymy | Granice |
|---|---|---|
| Udział udanych sprawdzeń stronywww.success_ratio.v1 | 100 × udane próby / wykonane próby. | To udział udanych sprawdzeń, a nie dokładny procent czasu dostępności. Obok pokazujemy liczbę wykonanych i zaplanowanych prób. |
| Zaobserwowane zmianywww.observed_changes.v1 | Liczba różnic między porównywalnymi zapisami stanu strony. | Jedna zmiana nie mówi, ile prac wykonano. Wyłączenia i reguły porównania mają wersje. |
| Kliknięcia (Search Console)gsc.clicks.v1 | Suma kliknięć dla tej samej agregacji. | Nie sumujemy jednocześnie wartości łącznej i rozbicia. Zapytania nie muszą pokrywać całości. |
| CTR (Search Console)gsc.ctr.v1 | Kliknięcia / wyświetlenia × 100. | Przy zerowej liczbie wyświetleń nie ma ilorazu. To nie jest średnia CTR z wierszy. |
| Średnia pozycja (Search Console)gsc.position.v1 | Średnia pozycji zwrócona przez źródło dla zakresu. | Bez obietnicy pozycji w mieście. To nie jest średnia ze średnich. |
| Sesje (Analytics 4)ga4.sessions.v1 | Wynik zwrócony przez Analytics 4 dla zakresu. | Porównujemy tylko przy identycznej konfiguracji wymiarów. Filtr i strefa czasowa są jawne. |
| Kluczowe zdarzenia (Analytics 4)ga4.key_events.v1 | Kluczowe zdarzenia według konfiguracji źródła. | To nie jest liczba klientów ani zapłat. |
| Odebrane pracework.accepted.v1 | Liczba unikalnych odbiorów aktualnej wersji prac. | To licznik działań, a nie procent ukończenia bez uzgodnionego zakresu. |
| Pozycje po terminieproject.overdue.v1 | Zadania niewycofane i nieodebrane, z terminem przed momentem odcięcia danych. | Zmiana terminu pozostaje w historii. |
| Czas pierwszej odpowiedzihelpdesk.first_response.v1 | Mediana czasu od utworzenia zgłoszenia do pierwszej odpowiedzi człowieka. | Godziny kalendarzowe albo uzgodnione robocze. Bez odpowiedzi automatycznych. |
| Otwarte zgłoszeniahelpdesk.backlog.v1 | Zgłoszenia otwarte w momencie odcięcia danych. | To nie „utworzone minus rozwiązane w okresie”, gdy sprawy istniały wcześniej. |
Metryki obsługi zgłoszeń liczymy dziś z pliku CSV — nie z bezpośredniego połączenia z systemem zgłoszeń.
Najpierw zobacz, jak wygląda odpowiedź.
Przejrzyj demonstracyjny raport strony, projektu albo obsługi zgłoszeń. Otwórz źródło, sprawdź zakres i zobacz, jak oznaczamy brak danych.