Troubleshooting BIMI: Mengapa Logo Anda Tidak Muncul (Panduan Lengkap)
Diagnosis dan perbaiki 7 penyebab paling umum mengapa logo BIMI Anda tidak tampil di klien email. Mencakup kebijakan DMARC, validasi SVG, MIME type, sertifikat VMC/CMC, propagasi DNS, dan dukungan klien.
Troubleshooting BIMI: Mengapa Logo Anda Tidak Muncul (Panduan Lengkap)
Brand Indicators for Message Identification (BIMI) memungkinkan penyedia layanan email menampilkan logo Anda di samping email yang terautentikasi. Ketika logo gagal muncul, penyebabnya hampir selalu salah satu dari tujuh masalah yang sudah terdefinisi dengan jelas. Panduan ini membahas setiap masalah secara berurutan berdasarkan frekuensi kemunculannya, memberikan langkah-langkah diagnostik yang tepat, dan menjelaskan cara memperbaikinya.
Sebelum Memulai: Cara Kerja Tampilan Logo BIMI
Ketika server email penerima memproses pesan masuk, server tersebut akan:
- Memeriksa apakah domain pengirim lolos DMARC dengan kebijakan yang ditegakkan.
- Mencari BIMI DNS TXT record di
default._bimi.<domainanda>. - Mengambil logo SVG dari URL yang tercantum di tag
l=. - (Untuk penyedia yang mensyaratkannya) Memvalidasi Verified Mark Certificate (VMC) atau Common Mark Certificate (CMC) dari URL yang tercantum di tag
a=. - Menampilkan logo di antarmuka inbox.
Kegagalan di tahap mana pun akan menyebabkan logo tidak ditampilkan secara diam-diam. Tidak ada pesan error yang ditunjukkan kepada pengirim maupun penerima.
Penyebab 1: Kebijakan DMARC Belum Berada di p=quarantine atau p=reject
Ini adalah penyebab paling umum mengapa logo BIMI tidak ditampilkan.
Setiap penyedia email yang mendukung BIMI — termasuk Google, Yahoo, Apple, Fastmail, dan lainnya — mensyaratkan kebijakan DMARC berupa p=quarantine atau p=reject sebelum mereka menampilkan logo. Kebijakan p=none dianggap sebagai tidak ada penegakan dan BIMI diabaikan sepenuhnya.
Cara Mendiagnosis
Lakukan DNS lookup pada DMARC record Anda:
dig TXT _dmarc.domainanda.com
Periksa nilai p= pada respons. Periksa juga:
sp=— kebijakan subdomain. Jika email Anda dikirim dari subdomain,sp=noneakan memblokir BIMI pada subdomain tersebut meskipun domain utama sudah berada dip=reject.pct=— tag persentase. Beberapa penyedia mensyaratkanpct=100. Nilai di bawah 100 dapat menyebabkan tampilan logo yang tidak konsisten.
Cara Memperbaiki
- Pastikan autentikasi email Anda (SPF dan DKIM) lolos secara konsisten sebelum menaikkan kebijakan.
- Naikkan DMARC dari
p=nonekep=quarantine, pantau selama dua hingga empat minggu. - Naikkan ke
p=rejectsetelah Anda yakin tidak ada email sah yang gagal. - Tetapkan
pct=100secara eksplisit. - Jika mengirim dari subdomain, tambahkan
sp=quarantineatausp=reject.
Contoh DMARC record yang benar:
v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:[email protected];
Catatan: Menaikkan kebijakan DMARC Anda mempengaruhi pengiriman email. Jangan lewatkan fase pemantauan.
Penyebab 2: File SVG Tidak Dapat Diakses Melalui HTTPS
Server penyedia email mengambil logo Anda pada saat rendering. Jika file mengembalikan respons selain 200 OK yang valid melalui HTTPS, logo tidak akan ditampilkan.
Sub-penyebab Umum
| Gejala | Kemungkinan Penyebab |
|---|---|
404 Not Found |
URL salah di tag l=, file dipindahkan atau dihapus |
403 Forbidden |
CDN atau WAF memblokir user agent non-browser |
301/302 Redirect |
Beberapa penyedia tidak mengikuti redirect |
SSL certificate error |
Sertifikat TLS pada domain hosting kedaluwarsa atau self-signed |
HTTP URL |
HTTP biasa tidak diterima; HTTPS wajib |
Cara Mendiagnosis
- Salin URL persis dari tag
l=Anda. - Uji dengan
curluntuk mensimulasikan pengambilan non-browser:
curl -I "https://domainanda.com/bimi/logo.svg"
- Periksa kode status HTTP, header
Content-Type, dan apakah terjadi redirect. - Uji dari beberapa lokasi geografis atau gunakan pemeriksa header HTTP online untuk menyingkirkan kemungkinan geo-blocking.
Cara Memperbaiki
- Pastikan URL di BIMI DNS record Anda sama persis dengan path file yang di-hosting — termasuk sensitivitas huruf besar/kecil.
- Jika menggunakan CDN, whitelist user agent yang digunakan oleh penyedia email utama, atau konfigurasikan CDN untuk menyajikan file secara publik tanpa proteksi bot.
- Pastikan domain hosting memiliki sertifikat TLS yang valid dan tepercaya (bukan self-signed).
- Jika redirect tidak dapat dihindari, perbarui tag
l=untuk mengarah langsung ke URL akhir. - Verifikasi bahwa file dapat diakses dari luar jaringan Anda sendiri.
Penyebab 3: Server Mengembalikan MIME Type yang Salah
Meskipun file SVG dapat diakses, penyedia email memvalidasi header Content-Type yang dikembalikan oleh server Anda. MIME type yang benar adalah image/svg+xml. Nilai lain apa pun — termasuk text/plain, application/octet-stream, atau text/html — akan menyebabkan logo ditolak.
Cara Mendiagnosis
curl -I "https://domainanda.com/bimi/logo.svg"
Cari baris Content-Type di header respons:
Content-Type: image/svg+xml
Jika Anda melihat nilai lain, berarti MIME type salah konfigurasi.
Cara Memperbaiki
Cara perbaikan bergantung pada web server atau platform hosting Anda.
Apache — tambahkan ke .htaccess atau konfigurasi server:
AddType image/svg+xml .svg .svgz
Nginx — tambahkan ke mime.types atau blok server:
types {
image/svg+xml svg svgz;
}
Amazon S3 / CloudFront — atur metadata Content-Type pada objek menjadi image/svg+xml saat mengunggah. S3 tidak menentukan MIME type secara otomatis.
Cloudflare Pages / Netlify — tambahkan file _headers:
/bimi/logo.svg
Content-Type: image/svg+xml
Setelah melakukan perubahan, jalankan kembali pengecekan curl -I untuk memastikan header sudah benar.
Penyebab 4: File SVG Gagal Validasi W3C Tiny P/S
BIMI tidak menerima file SVG standar. Spesifikasi mensyaratkan SVG Tiny 1.2 Portable/Secure (SVG Tiny P/S), sebuah profil terbatas yang dirancang agar aman untuk di-render dalam konteks yang tidak tepercaya. Sebagian besar file SVG yang diekspor dari tools desain seperti Adobe Illustrator, Figma, atau Inkscape tidak sesuai dengan profil ini tanpa modifikasi.
Kegagalan Validasi Umum
| Masalah | Mengapa Gagal |
|---|---|
baseProfile tidak ada atau salah |
Harus berupa baseProfile="tiny" di elemen <svg> |
Atribut version="1.2" tidak ada |
Disyaratkan oleh spesifikasi |
Gambar raster tertanam (<image>) |
Tidak diizinkan di Tiny P/S |
| JavaScript atau event handler | Dilarang keras |
Referensi eksternal atau <use> dengan href eksternal |
Tidak diizinkan |
CSS @import atau stylesheet eksternal |
Tidak diizinkan |
| Filter, mask, atau gradient (di beberapa implementasi) | Dukungan terbatas |
File tidak dibungkus dengan <svg> sebagai elemen root |
Persyaratan struktural |
Cara Mendiagnosis
- Buka SVG Anda di text editor dan periksa tag
<svg>pembuka. Tag tersebut harus menyertakan:
<svg xmlns="http://www.w3.