Biblioteka Dealyo

Szablon raportu Dealyo

Status: propozycja do uzupełnienia. Plik report.html jest pustym szablonem, a nie raportem wyników. Nie zawiera danych klientów ani przykładowych wyników.

Układ opiera się na referencji raportu z REFERENCES.md: podsumowanie, wskaźniki, porównanie okresów, wykres, szczegóły kont i plan działań. Dodatkowe pola źródła, odpowiedzialności, terminów oraz rozdzielenie faktów i hipotez są propozycją uzupełnienia szablonu. Kolory, lokalny General Sans i proste narożniki pochodzą z STYLE-GUIDE.md.

Jak używać

  1. Skopiuj report.html i nadaj kopii nazwę projektu. Zostaw ją w tym samym katalogu, aby zachować ścieżki do report.css, ../library.css oraz ../assets/dealyo-logo.svg. Przy przenoszeniu raportu przenieś też te pliki i lokalne fonty użyte przez bibliotekę; popraw ścieżki.
  2. Otwórz kopię w edytorze tekstowym. Zastąp wszystkie pola [w nawiasach kwadratowych] własną treścią. Edycja odbywa się w HTML; wpisywanie w przeglądarce nie zapisuje zmian.
  3. Zaktualizuj tytuł strony w <title>. Sprawdź, czy nagłówek, karty, tabele, wykres i wnioski pokazują te same dane.
  4. Powiel blok article.report-account dla kolejnych kont. Powiel wiersze tabeli planu, jeśli potrzebujesz więcej działań. Zmień domyślne nazwy wskaźników w kartach i obu tabelach, jeśli raport dotyczy innego wyniku niż zgłoszenia.
  5. Otwórz plik w przeglądarce. Sprawdź widok na komputerze i telefonie. Tabele przewijają się poziomo; można też ustawić na nich fokus klawiaturą.
  6. Przed przekazaniem gotowego raportu usuń baner aside.report-template-notice, nawigację biblioteki .report-library-nav i instrukcje w polach. Wyszukaj [ oraz ], aby znaleźć pozostałe pola. Zachowaj źródła, definicje i ograniczenia danych. Pusty wykres zastąp rzeczywistym wykresem albo usuń całą sekcję figure.report-chart.

Szablon nie ma skryptów, formularzy ani zewnętrznych fontów. Odczytuje lokalne pliki i sam nie wysyła danych. Nie zapisuje też danych automatycznie. Ewentualna publikacja gotowego raportu jest osobnym krokiem.

Pola do uzupełnienia

Miejsce w HTML Co uzupełnić
<title> i .report-hero Nazwa projektu, data raportu, główny wniosek i cel analizy. Wniosek w tytule musi mieć potwierdzenie w danych.
.report-meta Nazwa projektu lub klienta, dokładny badany okres i dokładny okres porównawczy.
#podsumowanie Najważniejsza zmiana oraz jej znaczenie dla firmy.
.report-method-grid Źródło danych, moment odczytu i strefa czasowa, uwzględnione konta i kampanie, wykluczenia, definicja wyniku, waluta, netto / brutto oraz sposób przypisania wyniku do reklamy.
.report-metric Nazwa wskaźnika, wartość, jednostka, poprzednia wartość oraz zmiana. Każda karta musi używać tego samego okresu i zakresu co podsumowanie.
#porownanie .report-table Dwa dokładnie nazwane okresy, wartości tych samych wskaźników i zmiana. W razie różnic zakresu opisz ograniczenia pod tabelą.
.report-chart Tytuł wskaźnika, jednostka, okresy, rzeczywisty wykres i opis jego przebiegu.
.report-account Konto lub kanał, obserwacja, ocena, kampanie i ich wyniki, następna decyzja z uzasadnieniem.
.report-findings Osobno potwierdzony fakt, hipoteza z planem sprawdzenia i brakujące informacje. Usuń niepotrzebną kartę zamiast wymyślać treść.
.report-action-table Priorytet, konkretne działanie, osoba odpowiedzialna, termin oraz kryterium i data oceny efektu.
.report-next-review i .report-footer Data kolejnego przeglądu, wymagane dane, autor, data i wersja dokumentu.

Porównania i brakujące dane

Jak dodać wykres

Pusty stan celowo nie zawiera słupków, punktów ani wartości osi. Nie przedstawia wyników.

  1. Przygotuj dane z tego samego źródła i zakresu co tabela. Do szeregu czasowego dodaj w tabeli wszystkie przedstawione okresy, zamiast zostawiać wyłącznie porównanie dwóch okresów.
  2. Wstaw lokalny plik wykresu w miejsce całego div.report-chart-empty, np. <img src="wykres.svg" alt="[Krótki opis wykresu i najważniejszej zmiany]" width="1000" height="400" style="display:block;width:100%;height:auto">. Zastąp także pole w alt.
  3. Podpisz jednostkę i okresy na wykresie. Wyjaśnij serię i kolory. Dla słupków zacznij oś wartości od zera; nie ukrywaj brakujących okresów. Przy linii z przerwą danych pokaż przerwę.
  4. W #opis-wykres opisz rzeczywisty przebieg, źródło i ograniczenia. Zachowaj tabelę z tymi samymi danymi, aby wynik był dostępny bez odczytywania obrazu.
  5. Użyj grafitu i pomarańczu #FE4A23; nie opieraj znaczenia wyłącznie na kolorze. Nie wstawiaj zewnętrznych widżetów, skryptów ani linkowanych obrazów.

Drukowanie

Arkusz zawiera układ do druku. W przeglądarce użyj polecenia Drukuj, sprawdź podgląd i ewentualnie zapisz do PDF. Nawigacja biblioteki, spis treści i baner szablonu są ukrywane w druku. To nie usuwa nieuzupełnionych pól — sprawdź je przed eksportem. Długie tabele i treści wymagają kontroli podziału stron po uzupełnieniu.