Усунення несправностей BIMI: чому ваш логотип не відображається (повний посібник)

Brand Indicators for Message Identification (BIMI) дозволяє поштовим провайдерам відображати ваш логотип поруч з автентифікованими листами. Коли логотип не з’являється, причина майже завжди криється в одній із семи чітко визначених проблем. Цей посібник послідовно розглядає кожну з них за частотою виникнення, надає точні кроки діагностики та пояснює, як їх виправити.

Перш ніж почати: як працює відображення логотипа BIMI

Коли приймаючий поштовий сервер обробляє вхідне повідомлення, він:

1. Перевіряє, чи відправляючий домен проходить DMARC з примусовою політикою.
2. Шукає DNS TXT запис BIMI за адресою default._bimi.<yourdomain>.
3. Завантажує логотип SVG з URL-адреси у тезі l=.
4. (Для провайдерів, які цього вимагають) Валідує Verified Mark Certificate (VMC) або Common Mark Certificate (CMC) з URL-адреси у тезі a=.
5. Рендерить логотип в інтерфейсі поштової скриньки.

Збій на будь-якому етапі мовчки приховує логотип. Жодної помилки не показується ні відправнику, ні отримувачу.

Причина 1: політика DMARC не встановлена на p=quarantine або p=reject

Це найпоширеніша причина, чому логотипи BIMI не відображаються.

Кожен поштовий провайдер, який підтримує BIMI — включаючи Google, Yahoo, Apple, Fastmail та інших — вимагає політику DMARC на рівні p=quarantine або p=reject перед тим, як відображати логотип. Політика p=none розглядається як відсутність примусу, і BIMI повністю ігнорується.

Як діагностувати

Виконайте DNS-запит для вашого запису DMARC:

dig TXT _dmarc.yourdomain.com

Перевірте значення p= у відповіді. Також перевірте:

• sp= — політику для піддоменів. Якщо ваша пошта надсилається з піддомену, sp=none заблокує BIMI на цьому піддомені, навіть якщо кореневий домен має p=reject.
• pct= — тег відсотка. Деякі провайдери вимагають pct=100. Значення нижче 100 може спричинити непослідовне відображення логотипа.

Як виправити

1. Переконайтеся, що ваша автентифікація електронної пошти (SPF та DKIM) послідовно проходить, перш ніж підвищувати політику.
2. Перемістіть DMARC з p=none на p=quarantine, моніторте протягом двох-чотирьох тижнів.
3. Перейдіть на p=reject, коли переконаєтесь, що жодна легітимна пошта не відхиляється.
4. Явно встановіть pct=100.
5. Якщо надсилаєте з піддоменів, додайте sp=quarantine або sp=reject.

Приклад правильного запису DMARC:

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

Примітка: Підвищення політики DMARC впливає на доставку пошти. Не пропускайте етап моніторингу.

Причина 2: файл SVG недоступний через HTTPS

Сервери поштового провайдера завантажують ваш логотип у момент рендерингу. Якщо файл повертає щось інше, ніж валідну відповідь 200 OK через HTTPS, логотип приховується.

Поширені підпричини

Як діагностувати

1. Скопіюйте точну URL-адресу з вашого тега l=.
2. Протестуйте її за допомогою curl, щоб симулювати небраузерний запит:

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

1. Перевірте код статусу HTTP, заголовок Content-Type та чи відбувається перенаправлення.
2. Протестуйте з кількох географічних локацій або скористайтеся онлайн-інструментом перевірки HTTP-заголовків, щоб виключити геоблокування.

Як виправити

1. Переконайтеся, що URL-адреса у вашому DNS-записі BIMI точно відповідає шляху до розміщеного файлу — включаючи регістр символів.
2. Якщо використовуєте CDN, додайте до білого списку user agents, які використовують основні поштові провайдери, або налаштуйте CDN для публічної видачі файлу без захисту від ботів.
3. Переконайтеся, що хостинговий домен має валідний, довірений TLS-сертифікат (не самопідписаний).
4. Якщо перенаправлення неминуче, оновіть тег l=, щоб він вказував безпосередньо на кінцеву URL-адресу.
5. Перевірте, що файл доступний ззовні вашої власної мережі.

Причина 3: сервер повертає неправильний MIME-тип

Навіть якщо файл SVG доступний, поштовий провайдер валідує заголовок Content-Type, який повертає ваш сервер. Правильний MIME-тип — image/svg+xml. Будь-яке інше значення — включаючи text/plain, application/octet-stream або text/html — призведе до відхилення логотипа.

Як діагностувати

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

Знайдіть рядок Content-Type у заголовках відповіді:

Content-Type: image/svg+xml

Якщо ви бачите щось інше, MIME-тип налаштовано неправильно.

Як виправити

Виправлення залежить від вашого веб-сервера або хостингової платформи.

Apache — додайте до .htaccess або конфігурації сервера:

AddType image/svg+xml .svg .svgz

Nginx — додайте до mime.types або блоку сервера:

types {
    image/svg+xml svg svgz;
}

Amazon S3 / CloudFront — встановіть метадані Content-Type об’єкта як image/svg+xml при завантаженні. S3 не визначає MIME-типи автоматично.

Cloudflare Pages / Netlify — додайте файл _headers:

/bimi/logo.svg
  Content-Type: image/svg+xml

Після внесення змін повторно виконайте перевірку curl -I, щоб підтвердити правильність заголовка.

Причина 4: файл SVG не проходить валідацію W3C Tiny P/S

BIMI не приймає стандартні файли SVG. Специфікація вимагає SVG Tiny 1.2 Portable/Secure (SVG Tiny P/S), обмежений профіль, розроблений для безпечного рендерингу в недовірених контекстах. Більшість файлів SVG, експортованих з інструментів дизайну, таких як Adobe Illustrator, Figma або Inkscape, не відповідають цьому профілю без модифікації.

Поширені помилки валідації

Як діагностувати

1. Відкрийте ваш SVG у текстовому редакторі та огляньте початковий тег <svg>. Він повинен містити:

<svg xmlns="http://www.w3.