Hatalar & Durum Kodları

Bu bölümde, Bildirt kurulumu ve push bildirim gönderimi sırasında
karşılaşılabilecek yaygın hataları ve bu hataların nasıl çözüleceğini
açıklıyoruz.

Hataların büyük bölümü, kurulumun eksik veya yanlış yapılmasından
kaynaklanır ve genellikle birkaç basit kontrol ile çözülebilir.


Kurulum Doğrulanamadı

Bildirt panelinde kurulum durumu doğrulanamıyorsa, genellikle
kurulum kodu veya gerekli dosyalar doğru şekilde yüklenmemiştir.

Kontrol edilmesi gerekenler:

  • Kurulum kodu sitenin <head> alanına eklenmiş mi?
  • Kurulum kodu tüm sayfalarda yükleniyor mu?
  • Cache ve CDN temizliği yapıldı mı?

manifest.json Dosyasına Erişilemiyor

manifest.json dosyasına erişilemiyorsa, push aboneliği
başlatılamaz.

Olası nedenler:

  • Dosya yanlış dizinde bulunuyor
  • Cache veya CDN dosyayı engelliyor
  • Dosya 404 veya 403 hatası döndürüyor

Çözüm önerileri:

  • Tarayıcıdan /manifest.json adresini doğrudan açarak kontrol edin
  • CDN kullanıyorsanız cache bypass ayarlarını kontrol edin

BildirtSDK-sw.js (Service Worker) Bulunamadı

BildirtSDK-sw.js servis worker dosyasına erişilemiyorsa,
push bildirimler çalışmaz.

Olası nedenler:

  • Dosya yanlış konumda
  • Service worker yolu cache veya güvenlik politikaları nedeniyle engelleniyor

Çözüm önerileri:

  • Tarayıcıdan /BildirtSDK-sw.js adresini açarak dosyanın erişilebilir olduğunu doğrulayın
  • Minify / defer / optimize script ayarlarını geçici olarak kapatıp test edin

Push Bildirim İzni Görünmüyor

Kullanıcıya push bildirim izni sorusu görünmüyorsa, tarayıcı
seviyesinde izin engellenmiş olabilir.

Olası nedenler:

  • Kullanıcı daha önce izni reddetmiş olabilir
  • Tarayıcı push bildirimleri engelliyor olabilir
  • Site HTTPS üzerinden çalışmıyor olabilir

Çözüm önerileri:

  • Tarayıcı ayarlarından site izinlerini kontrol edin
  • Farklı bir tarayıcı veya gizli sekme ile test edin

Bildirim Gönderildi Ama Tıklama Yok

Bildirim başarıyla gönderildiği halde tıklama alınmıyorsa,
bu durum genellikle içerik veya zamanlama ile ilgilidir.

Kontrol edilmesi gerekenler:

  • Bildirim başlığı ve açıklaması yeterince dikkat çekici mi?
  • Bildirim doğru saat aralığında mı gönderildi?
  • Benzer bildirimler çok sık gönderiliyor mu?

Bu durumda Performans & Analitik sayfasındaki
verileri inceleyerek iyileştirme yapabilirsiniz.


Otomatik Gönderim Çalışmıyor (AI Autopilot)

AI Autopilot aktif olduğu halde otomatik bildirim gönderilmiyorsa,
ayarların kontrol edilmesi gerekir.

  • Yapay zeka ile seçim açık mı?
  • Otomatik gönder açık mı?
  • Günlük bildirim limiti dolmuş olabilir mi?
  • Belirlenen saat aralığı dışında olunabilir mi?

Bu kontrollerden sonra sistem, otomatik olarak çalışmaya devam eder.


Genel Kontrol Listesi

  • Siteniz HTTPS üzerinden çalışıyor mu?
  • manifest.json ve BildirtSDK-sw.js erişilebilir mi?
  • Cache ve CDN temizliği yapıldı mı?
  • Tarayıcıda push izinleri engelli mi?

Bu adımların tamamı doğruysa, Bildirt push altyapısı sorunsuz
şekilde çalışacaktır.