Rozwiązywanie problemów z BIMI: Dlaczego Twoje logo się nie wyświetla (Kompletny przewodnik)

Brand Indicators for Message Identification (BIMI) umożliwia dostawcom skrzynek pocztowych wyświetlanie Twojego logo obok uwierzytelnionych wiadomości e-mail. Gdy logo nie pojawia się, przyczyna prawie zawsze tkwi w jednym z siedmiu dobrze zdefiniowanych problemów. Ten przewodnik omawia każdy z nich w kolejności występowania, podaje dokładne kroki diagnostyczne i wyjaśnia, jak go naprawić.

Zanim zaczniesz: Jak działa wyświetlanie logo BIMI

Gdy odbierający serwer pocztowy przetwarza przychodzącą wiadomość:

1. Sprawdza, czy domena wysyłająca przechodzi weryfikację DMARC z polityką wymuszającą.
2. Wyszukuje rekord BIMI DNS TXT pod adresem default._bimi..
3. Pobiera logo SVG z adresu URL w tagu l=.
4. (W przypadku dostawców, którzy tego wymagają) Waliduje Verified Mark Certificate (VMC) lub Common Mark Certificate (CMC) z adresu URL w tagu a=.
5. Renderuje logo w interfejsie skrzynki odbiorczej.

Błąd na którymkolwiek etapie powoduje ciche ukrycie logo. Żaden błąd nie jest wyświetlany nadawcy ani odbiorcy.

Przyczyna 1: Polityka DMARC nie jest ustawiona na p=quarantine lub p=reject

Jest to najczęstsza przyczyna, dla której logo BIMI się nie wyświetla.

Każdy dostawca skrzynek pocztowych obsługujący BIMI — w tym Google, Yahoo, Apple, Fastmail i inni — wymaga polityki DMARC na poziomie p=quarantine lub p=reject, zanim wyrenderuje logo. Polityka p=none jest traktowana jako brak wymuszania, a BIMI jest całkowicie ignorowane.

Jak zdiagnozować

Wykonaj zapytanie DNS dla swojego rekordu DMARC:

dig TXT _dmarc.twojadomena.com

Sprawdź wartość p= w odpowiedzi. Sprawdź również:

• sp= — polityka dla subdomen. Jeśli Twoja poczta jest wysyłana z subdomeny, sp=none zablokuje BIMI na tej subdomenie, nawet jeśli domena główna ma p=reject.
• pct= — tag procentowy. Niektórzy dostawcy wymagają pct=100. Wartość poniżej 100 może powodować niespójne wyświetlanie logo.

Jak naprawić

1. Upewnij się, że uwierzytelnianie poczty (SPF i DKIM) przechodzi konsekwentnie, zanim podniesiesz poziom polityki.
2. Zmień DMARC z p=none na p=quarantine, monitoruj przez dwa do czterech tygodni.
3. Przejdź na p=reject, gdy masz pewność, że żadna legalna poczta nie jest odrzucana.
4. Ustaw jawnie pct=100.
5. Jeśli wysyłasz z subdomen, dodaj sp=quarantine lub sp=reject.

Przykład prawidłowego rekordu DMARC:

v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:[email protected];

Uwaga: Podniesienie polityki DMARC wpływa na dostarczalność poczty. Nie pomijaj fazy monitorowania.

Przyczyna 2: Plik SVG nie jest dostępny przez HTTPS

Serwery dostawcy skrzynek pocztowych pobierają Twoje logo w momencie renderowania. Jeśli plik zwraca cokolwiek innego niż prawidłową odpowiedź 200 OK przez HTTPS, logo jest ukrywane.

Częste przyczyny szczegółowe

| Objaw | Prawdopodobna przyczyna | |---|---| | 404 Not Found | Błędny URL w tagu l=, plik przeniesiony lub usunięty | | 403 Forbidden | CDN lub WAF blokuje user-agenty niebędące przeglądarkami | | 301/302 Redirect | Niektórzy dostawcy nie podążają za przekierowaniami | | Błąd certyfikatu SSL | Wygasły lub samopodpisany certyfikat TLS na domenie hostującej | | URL HTTP | Zwykły HTTP nie jest akceptowany; HTTPS jest obowiązkowy |

Jak zdiagnozować

1. Skopiuj dokładny URL z tagu l=.
2. Przetestuj go za pomocą curl, aby zasymulować pobieranie niebędące przeglądarką:

curl -I "https://twojadomena.com/bimi/logo.svg"

1. Sprawdź kod statusu HTTP, nagłówek Content-Type oraz czy występuje przekierowanie.
2. Przetestuj z wielu lokalizacji geograficznych lub użyj internetowego narzędzia do sprawdzania nagłówków HTTP, aby wykluczyć blokowanie geograficzne.

Jak naprawić

1. Upewnij się, że URL w Twoim rekordzie BIMI DNS dokładnie odpowiada ścieżce hostowanego pliku — z uwzględnieniem wielkości liter.
2. Jeśli używasz CDN, dodaj do białej listy user-agenty używane przez głównych dostawców skrzynek pocztowych lub skonfiguruj CDN, aby serwował plik publicznie bez ochrony przed botami.
3. Upewnij się, że domena hostująca ma ważny, zaufany certyfikat TLS (nie samopodpisany).
4. Jeśli przekierowanie jest nieuniknione, zaktualizuj tag l=, aby wskazywał bezpośrednio na końcowy URL.
5. Zweryfikuj, czy plik jest dostępny spoza Twojej własnej sieci.

Przyczyna 3: Serwer zwraca nieprawidłowy typ MIME

Nawet jeśli plik SVG jest dostępny, dostawca skrzynek pocztowych waliduje nagłówek Content-Type zwracany przez Twój serwer. Prawidłowy typ MIME to image/svg+xml. Każda inna wartość — w tym text/plain, application/octet-stream lub text/html — spowoduje odrzucenie logo.

Jak zdiagnozować

curl -I "https://twojadomena.com/bimi/logo.svg"

Poszukaj linii Content-Type w nagłówkach odpowiedzi:

Content-Type: image/svg+xml

Jeśli widzisz cokolwiek innego, typ MIME jest źle skonfigurowany.

Jak naprawić

Naprawa zależy od Twojego serwera WWW lub platformy hostingowej.

Apache — dodaj do .htaccess lub konfiguracji serwera:

AddType image/svg+xml .svg .svgz

Nginx — dodaj do mime.types lub bloku serwera:

types {

image/svg+xml svg svgz;
}

Amazon S3 / CloudFront — ustaw metadane Content-Type obiektu na image/svg+xml podczas przesyłania. S3 nie określa automatycznie typów MIME.

Cloudflare Pages / Netlify — dodaj plik _headers:

/bimi/logo.svg

Content-Type: image/svg+xml

Po wprowadzeniu zmian ponownie uruchom sprawdzenie curl -I, aby potwierdzić poprawność nagłówka.

Przyczyna 4: Plik SVG nie przechodzi walidacji W3C Tiny P/S

BIMI nie akceptuje standardowych plików SVG. Specyfikacja wymaga SVG Tiny 1.2 Portable/Secure (SVG Tiny P/S), ograniczonego profilu zaprojektowanego do bezpiecznego renderowania w niezaufanych kontekstach. Większość plików SVG eksportowanych z narzędzi projektowych takich jak Adobe Illustrator, Figma czy Inkscape nie spełnia tego profilu bez modyfikacji.

Częste błędy walidacji

| Problem | Dlaczego się nie udaje | |---|---| | Brakujący lub nieprawidłowy baseProfile | Musi być baseProfile="tiny" w elemencie | | Brakujący atrybut version="1.2" | Wymagany przez specyfikację | | Osadzone obrazy rastrowe () | Niedozwolone w Tiny P/S | | JavaScript lub obsługa zdarzeń | Ściśle zabronione | | Zewnętrzne odwołania lub z zewnętrznym href | Niedozwolone | | CSS @import lub zewnętrzne arkusze stylów | Niedozwolone | | Filtry, maski lub gradienty (w niektórych implementacjach) | Ograniczona obsługa | | Plik nie jest opakowany w jako element główny | Wymóg strukturalny |

Jak zdiagnozować

1. Otwórz swój plik SVG w edytorze tekstu i sprawdź otwierający tag . Musi zawierać:

```xml