# Lista kontrolna przed wysyłką e-maila: 8 testów jakości

Kanoniczny adres URL: https://brew.new/pl/blog/pre-send-email-qa-checklist
Autor: Thomas Park
Opublikowano: 2026-10-11
Zaktualizowano: 2026-10-11

Lista kontrolna jakości przed wysyłką to krótka lista testów, które przeprowadzasz dla każdego e-maila, zanim wyjdzie. Zepsute kampanie zwykle wychodzą z przyciskiem, który wciąż prowadzi do `#`, z grafiką hero podmienioną o 18:00 na PNG ważący 4 MB albo z układem dwukolumnowym, który klasyczny Outlook ignoruje. Każdy z tych błędów można wyłapać w minutę przed wysyłką, a po niej nie da się go już naprawić.

W tym miesiącu przebudowaliśmy audyt e-maili w Brew wokół tych testów, każdy z dokładnym progiem. Możesz je przeprowadzić ręcznie, z Brew lub bez niego.

![Wynik audytu e-maila z oceną punktową, statusem gotowości i wykrytymi problemami pogrupowanymi według wagi.](/images/blog/email-audit-findings.png)

*Wykryte problemy pogrupowane według wagi i jedna ocena gotowości.*

## Najważniejsze wnioski

- Sprawdź osiem obszarów: linki, rozmiar, obrazy, obsługę w programach pocztowych, dostępność, treść, zgodność z przepisami i znaczniki.
- Gmail przycina HTML powyżej ok. 102 KB, ukrywając stopkę i link do wypisania. Brew ostrzega już przy 80 KB, bo śledzenie kliknięć zwiększa rozmiar.
- Kliknij każdy link w dostarczonym teście, ale nigdy nie pozwalaj automatycznemu narzędziu otwierać linków do wypisania ani do ustawień preferencji.
- Audyt Brew przyznaje od 0 do 100 punktów: minus 20 za każdy problem krytyczny, 10 za błąd, 3 za ostrzeżenie. Każdy problem krytyczny lub błąd oznacza, że e-mail nie jest gotowy.
- Audyt nigdy nie blokuje wysyłki i nie testuje trafiania do skrzynki, zrzutów ekranu z renderowania ani trybu ciemnego.

## 1. Linki

Zepsuty link marnuje wysyłkę. Sprawdź, czy:

- każdy przycisk prowadzi do prawdziwego miejsca docelowego, a nie do `#`, `example.com` czy niewypełnionego `{{url}}`
- żaden link nie zwraca 404 ani 410, nie wskazuje domeny, której nie da się rozwiązać, nie ma błędnego certyfikatu, nie odrzuca połączenia i nie zapętla się w przekierowaniach
- każdy link używa `https`
- widoczny tekst linku odpowiada miejscu docelowemu. `brew.new/pricing` prowadzący gdzie indziej wygląda jak phishing
- omijasz publiczne skracacze linków, które dzielą reputację z każdym spamerem, który z nich korzysta

Klikaj każdy link w dostarczonym teście, a nie w edytorze. Twój ESP przepisuje linki na potrzeby śledzenia kliknięć w chwili wysyłki, więc łańcuchy przekierowań i zepsute parametry śledzenia widać dopiero tam.

Nigdy nie pozwalaj automatycznemu narzędziu wysyłać żądań do linków do wypisania ani do ustawień preferencji. Niektórzy dostawcy traktują każde żądanie pod taki adres jako wypisanie. A zabezpieczenie przed botami, na które trafi narzędzie, nie dowodzi, że link nie działa. Kliknij go osobiście.

## 2. Rozmiar

Gmail przycina wiadomości, w których HTML zajmuje więcej niż ok. **102 KB**, i chowa resztę za linkiem „Wyświetl całą wiadomość”. Ukrywa to stopkę, link do wypisania i adres pocztowy, więc przycięty e-mail marketingowy po cichu staje się problemem z punktu widzenia przepisów.

Nasze progi:

- **80 KB** HTML to ostrzeżenie
- **102 KB** HTML to błąd, bo Gmail przytnie taki e-mail
- **3 MB** łącznego rozmiaru do pobrania (HTML i obrazy) to ostrzeżenie
- **5 MB** łącznego rozmiaru do pobrania to błąd

Ostrzegamy już przy 80 KB, bo śledzenie kliknięć zamienia krótkie linki na dłuższe adresy przekierowań, a niektóre ESP dodają własny kod. 98 KB w edytorze może dotrzeć jako 105 KB.

Typowe źródła nadmiaru: style inline powtarzane w każdym elemencie, pozostałości komentarzy z kreatora, ukryte zduplikowane sekcje w wersji mobilnej i desktopowej oraz obrazy osadzone w base64.

## 3. Obrazy

Każdy obraz powinien:

- mieć tekst `alt` albo `alt=""`, jeśli jest czysto dekoracyjny
- mieć atrybuty `width` i `height`, żeby układ się nie rozjeżdżał, gdy obrazy się ładują lub są zablokowane
- ładować się i być obrazem, a nie stroną błędu w HTML
- ważyć mniej niż **1 MB**, a w przypadku GIF-a mniej niż **3 MB**

Jeden duży obraz nad wierszem tekstu jest nieczytelny przy wyłączonych obrazach, niezrozumiały dla czytników ekranu i dla niektórych filtrów stanowi sygnał spamu. Nagłówek i ofertę umieść w zwykłym tekście.

## 4. Obsługa w programach pocztowych

Flexbox, grid, `position`, obrazy tła i SVG osadzone w kodzie psują się w co najmniej jednym popularnym programie pocztowym. [Can I email](https://www.caniemail.com/) śledzi obsługę każdej funkcji w każdym programie i jest najlepszym pojedynczym źródłem.

Najbardziej uważaj na Outlook. W Gmail i Apple Mail usterki są zwykle mało widoczne. Klasyczny Outlook dla Windows renderuje e-maile silnikiem układu programu Word, ignoruje wiele szerokości z CSS, pomija obrazy tła i usuwa dopełnienie (padding) z przycisków zbudowanych jako ostylowane linki.

Funkcję oznaczamy dla rodziny programów pocztowych, np. Gmail lub Outlook, tylko wtedy, gdy nie obsługują jej co najmniej dwa programy z tej rodziny. Ostrzeżenie pojawia się tylko wtedy, gdy funkcja psuje się w Outlook i nie ma wersji zastępczej. Cała reszta to informacje. W przeciwnym razie każdy e-mail dostawałby dwadzieścia ostrzeżeń o programach pocztowych, a ludzie ignorowaliby je wszystkie.

## 5. Dostępność

Najprostsze testy:

- atrybut `lang` w `<html>`, żeby czytniki ekranu poprawnie wymawiały tekst
- element `<title>`
- nagłówki w odpowiedniej kolejności, bez przeskoku z `h1` do `h4`
- tekst alternatywny, który mówi, co przekazuje obraz. „Wykres słupkowy pokazujący podwojenie liczby rejestracji w marcu” pomaga. „image1.png” nie pomaga
- kontrast tekstu głównego, przycisków i jasnoszarego tekstu w stopce, gdzie kryje się większość błędów

Punktem odniesienia jest [WCAG 2.2](https://www.w3.org/TR/WCAG22/). Większość problemów w e-mailach odpowiada jego kryteriom dotyczącym alternatyw tekstowych, kontrastu, języka strony i nagłówków.

## 6. Treść, temat i tekst podglądu

Temat powinien mieć mniej niż ok. **60 znaków** i **9 słów**, inaczej telefony go obetną. Unikaj pisania WIELKIMI LITERAMI, przedrostków „RE:” lub „FWD:” w wiadomościach, które nie są odpowiedzią, i ciągów wykrzykników.

Tekst podglądu powinien mieć mniej niż ok. **90 znaków** i nie powtarzać tematu. Jeśli pole pozostanie puste, wiele programów pocztowych pokaże zamiast niego „Wyświetl w przeglądarce”.

Tag personalizacji bez wartości zastępczej wyśle „Cześć ,” do każdego, kto nie ma podanego imienia. Czytelnicy to zapamiętują.

Każda liczba powinna mieć źródło, które możesz wskazać, zwłaszcza w pierwszych szkicach od AI, które z łatwością podają liczby z dużą pewnością siebie. Więcej o doborze słów znajdziesz we wpisie [Jak pisać e-maile marketingowe](/pl/blog/how-to-write-marketing-emails) i w [poradniku o tematach e-maili](/pl/blog/email-subject-lines).

## 7. Zgodność z przepisami

Zgodnie z [CAN-SPAM](https://www.ftc.gov/business-guidance/resources/can-spam-act-compliance-guide-business) e-mail komercyjny wymaga działającego linku do wypisania i prawidłowego adresu pocztowego. Nadawcy masowi wysyłający do Gmail i Yahoo potrzebują też nagłówków wypisania jednym kliknięciem. Opisujemy je we wpisie [Co nadal obowiązuje, gdy Twoje e-maile wysyła agent](/pl/blog/agent-email-deliverability).

E-maile transakcyjne są zwolnione z części zasad marketingowych, ale nie z tej listy kontrolnej. Potwierdzenie płatności z martwym linkiem i tak skończy się zgłoszeniem do działu wsparcia.

## 8. Znaczniki

Usuń to, co programy pocztowe wycinają lub blokują:

- elementy `<script>`, `<form>` i `<iframe>`
- osadzone SVG i adresy URI `data:`
- obrazy tła bez zastępczego `background-color`, dzięki któremu tekst pozostaje czytelny, gdy obraz się nie załaduje

Zacznij od deklaracji doctype. Bez niej niektóre programy pocztowe renderują e-mail w trybie quirks i odstępy się przesuwają.

## Lista kontrolna w Brew

Audyt e-maili w Brew przeprowadzisz:

- na karcie **Audyt** w oknie wysyłki, obok kart Podgląd i Odbiorcy
- przyciskiem **Audyt** przy krokach e-mail na kanwie automatyzacji
- przez API i MCP, za pomocą `POST /v1/emails/audit` lub narzędzia `audit_email`

Opis wszystkich pól znajdziesz w [dokumentacji audytu](https://docs.brew.new/create-emails/audit-email) i [dokumentacji API](https://docs.brew.new/api-reference/public-v1/emails/audit-an-email).

Bezpłatne **szybkie testy** uruchamiają się automatycznie dla każdej reguły, która potrzebuje wyłącznie kodu HTML: symboli zastępczych, rozmiaru, brakujących tekstów alternatywnych i wymiarów obrazów, kolejności nagłówków, `lang` i `<title>`, długości tematu i tekstu podglądu, tagów personalizacji bez wartości zastępczych oraz blokowanych znaczników.

**Uruchom audyt** dodaje testy, które wymagają dostępu do sieci lub oceny:

- żądanie na żywo do każdego linku, maksymalnie 100 na e-mail, z pominięciem linków do wypisania i ustawień preferencji. Zabezpieczenia przed botami dają wynik „niezweryfikowany”, a nie „martwy link”
- żądanie do każdego obrazu, które wyłapuje niedziałające lub zbyt duże pliki
- obsługę w 15 programach pocztowych z czterech rodzin (Gmail, Apple Mail, Outlook i Yahoo) według reguły z punktu 4
- kontrast i inne reguły dostępności z odwołaniami do WCAG 2.2
- ocenę AI: czy temat nie wprowadza w błąd, czy teksty linków i teksty alternatywne coś znaczą, czy jest adres pocztowy w formacie dowolnego kraju i czy e-mail jest marketingowy, czy transakcyjny

Każdą ocenę AI dostroiliśmy tak, by zgłoszony problem był trafny w co najmniej 95% przypadków na naszych własnych e-mailach. Recenzent AI, który podnosi fałszywe alarmy, jest gorszy niż żaden.

Pełny audyt kosztuje 5 kredytów. Jeśli wymagany test jest niedostępny, dostajesz bezpłatny audyt częściowy bez wyniku, bo wynik, który pomija testy, wprowadzałby w błąd.

## Jak działa wynik

Każdy audyt zwraca wynik od 0 do 100 i status: gotowy do wysyłki, wymaga sprawdzenia lub niegotowy (w aplikacji wyświetlany jako „Gotowy do wysyłki”, „Wymaga sprawdzenia” i „Wykryto problemy”). Każdy wykryty problem ma poziom ważności (Krytyczne, Błąd, Ostrzeżenie lub Informacja) oraz dowód, np. kod HTTP martwego linku.

Wynik zaczyna się od 100. Każdy problem krytyczny kosztuje 20 punktów, każdy błąd 10, każde ostrzeżenie 3, a informacja nic. Liczą się tylko trzy pierwsze wystąpienia dla każdej reguły.

Przykład: przycisk z linkiem do `#`, link w stopce zwracający 404, dwa obrazy bez tekstu alternatywnego, temat liczący 68 znaków i flexbox ignorowany przez dwa programy pocztowe z rodziny Yahoo.

| Problem | Waga | Punkty |
| --- | --- | --- |
| Link przycisku to symbol zastępczy | Krytyczne | −20 |
| Link w stopce zwraca 404 | Błąd | −10 |
| Obraz bez tekstu alternatywnego (×2) | Ostrzeżenie | −6 |
| Temat dłuższy niż 60 znaków | Ostrzeżenie | −3 |
| Flexbox pomijany przez 2 programy Yahoo | Informacja | 0 |
| **Wynik** | | **61** |

Każdy problem krytyczny lub błąd oznacza status „niegotowy”, a same ostrzeżenia – „wymaga sprawdzenia”. Popraw oba linki, a ten e-mail dostanie 91 punktów i status „wymaga sprawdzenia”. Szczerze: wysłałby się bez problemu, a reszta jest warta minuty pracy.

**Popraw na czacie** przekazuje agentowi Brew ostrzeżenia i poważniejsze problemy, a po naprawie ponownie uruchamia bezpłatne szybkie testy.

## Czego audyt nie robi

Nie blokuje wysyłek. Przy problemach krytycznych okno wysyłki wymaga kliknięcia **Wyślij mimo to** i zapisuje to obejście w dzienniku. Wysyłki przez API, MCP i automatyzacje raportują wykryte problemy i idą dalej. To właściwe ustawienie domyślne. Niektóre e-maile, które nie podobają się audytowi, i tak powinny wyjść, a narzędzie do kontroli jakości, które trzyma wysyłki jako zakładników, w końcu zostaje wyłączone.

Nie przepisuje Twojego kodu HTML. Poprawki to osobny krok, który uruchamiasz samodzielnie.

Nie testuje trafiania do skrzynki, nie renderuje zrzutów ekranu i nie sprawdza trybu ciemnego. Aby sprawdzić tryb ciemny, otwórz testowy e-mail na telefonie z włączonym trybem ciemnym. Tak wyłapiesz logo, które znika na czarnym tle.

## Najczęściej zadawane pytania

### Jak długo audyt jest ważny?

W oknie wysyłki 15 minut. Po tym czasie lub po zmianie e-maila panel poprosi o ponowne uruchomienie audytu. Przez MCP zapisany raport możesz bezpłatnie odczytywać ponownie przez 7 dni.

### Czy wysoki wynik oznacza, że e-mail trafi do skrzynki odbiorczej?

Nie. Audyt sprawdza sam e-mail. To, gdzie trafi wiadomość, zależy też od reputacji domeny, uwierzytelniania i wskaźnika zgłoszeń spamu, o czym piszemy w [poradniku o dostarczalności](/pl/blog/email-deliverability).

### Czy mogę przeprowadzić audyt e-maila zbudowanego w innym narzędziu?

Tak, przez API lub MCP. Prześlij `emailHtml` lub `emailJsx` zamiast identyfikatora e-maila w Brew, a dostaniesz ten sam raport, zanim e-mail trafi do Twojego ESP. Jeśli [remiksujesz szablon z galerii i eksportujesz go do ESP](/pl/blog/how-to-remix-a-real-brand-email-template-and-export-it-to-your-esp), przeprowadź audyt w Brew przed eksportem.

### Kto w moim zespole może go uruchomić?

Każdy, kto ma dostęp do marki: administratorzy organizacji i dodani do niej członkowie. W Brew nie ma roli tylko do przeglądania.