Ana içeriğe atla

​
Web push gereksinimleri

Web Push’un çalışması için web siteniz aşağıdakilerin tümünü karşılamalıdır: Gerekli tarayıcı API’leri Güvenlik ve bağlantı
  • ✅ Yalnızca HTTPS (geçerli SSL sertifikası ile)
  • ✅ OneSignal’in service worker’ı kurulu
  • ✅ Tarayıcı şunlara ulaşmalıdır:
    • Tarayıcı push sunucuları (örneğin, FCM, Mozilla)
    • api.onesignal.com
Kullanıcı durumu
  • ✅ Kullanıcı tarafından verilen bildirim izni
  • ❌ Gizli/Özel/Misafir modunda değil
  • ❌ Site verileri temizlenmemiş (abonelikleri siler)
Tarayıcı verilerini temizlemek (çerezler, site depolama) kullanıcıların push bildirimlerinden otomatik olarak aboneliğini kaldırır.

​
iOS/iPadOS gereksinimleri

iOS veya iPadOS’ta push almak için:
  • iOS 16.4+ veya iPadOS 16.4+
  • Site ana ekrana eklenmiş ve oradan açılmış olmalıdır
  • Gerekli alanlarla geçerli manifest.json dosyası
  • Kullanıcılar web uygulaması olarak açtıktan sonra bildirim izinlerini kabul etmelidir

iOS web push kurulumu

iOS 16.4+ çalıştıran iPhone ve iPad’lerde web push’u etkinleştirmek için Apple’a özgü adımları takip edin.

​
Tarayıcı ve platform desteği

​
İşletim sistemine göre tarayıcı uyumluluğu

BrowserWindows PCmacOSAndroidiOS (iPhone, iPad)
Chrome 50+YesYesYesYes ¹
Firefox 47+YesYesYesYes ¹
Safari 10+NoYesNoYes ¹
Microsoft Edge 18+ ²YesYesYesYes ¹
Opera ²YesYesYesYes ¹
Samsung Internet ²NoNoYesYes ¹
Yandex ²YesYesYesYes ¹
UC Browser ²YesNoYesYes ¹
Internet Explorer ³NoNoNoNo
DuckDuckGoNoNoNoNo
  • ¹ iOS, web uygulaması kurulumu gerektirir (yukarıdaki iOS web push kurulumu gereksinimlerine bakın)
  • ² Chromium tabanlı tarayıcılar OneSignal analitiğinde “Chrome” olarak görünür
  • ³ Internet Explorer kullanımdan kaldırılmıştır ve artık güncelleme almamaktadır
Gizli Mod, Özel Tarama Modu ve Misafir Tarayıcı Modu, hiçbir platformda Web Push’u desteklemez.

​
Alan adı değişiklikleri ve geçiş

​
Tarayıcı origin politikasını anlama

Tarayıcılar, güvenlik nedenleriyle web push aboneliklerini belirli bir origin (alan adı/site URL)‘ye bağlar. Aboneleri farklı origin’ler arasında aktaramazsınız - bu bir tarayıcı kısıtlamasıdır, OneSignal kısıtlaması değildir. Farklı origin’ler şunları içerir:
  • HTTP vs HTTPS (örneğin, http://mysite.com → https://mysite.com)
  • www vs www olmayan (örneğin, www.mysite.com vs mysite.com)
  • Farklı alan adları/alt alan adları (örneğin, domain1.com vs domain2.com veya sub1.domain.com vs sub2.domain.com)

​
Geçiş seçenekleri

Sitenizin origin’ini değiştirirken, bu yaklaşımlardan birini seçin:
  • Yeni OneSignal Uygulaması (Önerilir)
  • Uygulamayı Güncelle ve Eski Aboneleri Sil
En iyisi: Çoğu alan adı değişikliği, özellikle temiz bir geçiş istediğinizde
  1. Yeni alan adınız için yeni OneSignal Uygulaması oluşturun
  2. Çift gönderim stratejisi: Eski uygulamadan göndermeye devam edin, ancak “Launch URL”yi yeni alan adınıza ayarlayın
  3. Kademeli geçiş:
    • Yüksek frekanslı göndericiler (günde 1+ bildirim): 2 hafta geçiş
    • Orta frekanslı göndericiler (haftada 2+ bildirim): 2 ay geçiş
  4. Geçiş bildirimleri: Geçişin başında ve sonunda “Taşındık! Güncel kalmak için yeni sitemizi ziyaret edin” gibi 1-2 mesaj gönderin
Her iki uygulamadan da aynı mesajları göndermek, her ikisine de abone olan kullanıcılar için yinelenen bildirimler oluşturur.

​
HTTP’den HTTPS’ye yükseltme

HTTP’den HTTPS’ye yükseltmek yeni bir origin oluşturur. Tarayıcılar HTTPS sitelerini HTTP sürümlerinden tamamen ayrı olarak ele aldığı için yukarıdaki alan adı geçiş adımlarını izleyin.

​
Birden fazla site ve alt alan adı

​
Tek uygulama kısıtlamaları

Tarayıcının aynı origin politikası nedeniyle, bir OneSignal Uygulamasını şunlar gibi birden fazla origin için kullanamazsınız:
  • https://mysite.com ve https://www.mysite.com
  • https://main.com ve https://shop.main.com

​
Birden fazla origin için çözümler

  • Tek Origin Stratejisi
  • Ayrı Uygulamalar
  • Kullanıcıları yalnızca ana alan adınızda abone edin
  • Kullanıcıları diğer origin’lerden ana alan adına abonelik için yönlendirin
  • Abonelikten sonra orijinal sayfaya geri yönlendirin

​
Dil desteği senaryoları

  • Aynı Origin (Önerilir)
  • Farklı Origin'ler

​
Gelişmiş yapılandırma

​
Aynı sitede birden fazla OneSignal uygulaması

  • Önerilmez - abonelik çakışmalarına neden olur.
  • Ne olur: OneSignal, kullanıcıları en son ziyaret edilen Uygulama ID’sine otomatik olarak yeniden abone eder, abonelerin uygulamalar arasında sıçramasına neden olur ve birçok abonelikten çıkmış cihaz oluşturur.
  • Daha iyi yaklaşım: Tek bir uygulama içinde kullanıcıları segmentlere ayırmak için Veri Etiketlerini kullanın.

​
Alt klasör siteleri

Web push, origin düzeyinde çalışır. Alt klasörlerdeki siteler için (örneğin, https://example.com/blog), kurulum için ana origin’i (https://example.com) kullanın.

​
SDK dosyalarını kendi sunucunuzda barındırma

Şiddetle önerilmez. Tarayıcı push spesifikasyonları sık sık değişir ve OneSignal uyumluluğu korumak için dosyaları hemen günceller. Bunun yerine Web Push Ayarlarınızdan OneSignal’in CDN URL’lerini kullanın.

​
Özel init kodu

Özel init kodu yalnızca Özel Kod Kurulumu ile çalışır. Tipik Kurulum veya Website Builder kullanıcıları: Özel init kodu OneSignal SDK tarafından yok sayılacaktır. Başlatmayı geciktirmeniz gerekiyorsa, gizlilik yöntemlerini kullanın.

​
Geliştirme ve test

​
Yerel ortam testi

Tam yerel test kurulumu için Web SDK kurulumu > Yerel test’e bakın.

​
Service worker entegrasyonu

OneSignal, mevcut service worker’lar ve PWA’larla birlikte çalışabilir. İmplementasyon ayrıntıları için Birden Fazla Service Worker Entegrasyonu’na bakın.

​
Push spam

Push bildirimleri reklamlar, kullanıcılara spam göndermek veya aldatıcı kampanyalar için kullanılmak üzere tasarlanmamıştır. Uygulamanız spam bildirimleri gönderirken tespit edilirse, tarayıcılar kullanıcılarınıza bir “Spam uyarısı” bildirimi gönderebilir. Şunları yapan bildirimler göndermekten kaçının:
  • Kullanıcılarla ilgili değil
  • “Reklamlar” gibi kelimeler kullanma veya uygulamayla ilgili olmayan bir sayfaya bağlantı verme
  • Güvenilir bir kaynaktan değil (örneğin, ilişkili olmadığınız bir marka)
Daha fazla bilgi için Chrome’da Makine Öğrenimi ile İstenmeyen Bildirimlere Karşı Mücadele’ye bakın.
Uygulamanız spam olarak işaretleniyorsa, şunları yapabilirsiniz:
  • Bildirim içeriğinizi gözden geçirin ve spam olarak kabul edilebilecek her şeyi kaldırın. Bu şunları içerir:
    • Başlık veya gövdede “Reklamlar” veya “Reklam” kelimeleri
    • Uygulamayla ilgili olmayan sayfalara bağlantılar
    • Güvenilir bir kaynaktan olmayan sayfalara bağlantılar (örneğin, ilişkili olmadığınız bir marka)
  • Göndermeye devam edin ve daha fazla raporu izleyin.

​
Sorun Giderme

​
Güncelleme dağıtım zamanlaması

  • Service Worker dosyaları: 24 saatlik önbellek
  • Web SDK: 3 günlük önbellek
Kritik güncellemeleri dağıtırken buna göre planlayın.

​
macOS Chrome bildirim sorunları

macOS Chrome kullanıcıları için, bildirimlerin her ikisi için de etkin olduğundan emin olun:
  1. Google Chrome uygulaması (Apple Menüsü > Ayarlar > Bildirimler)
  2. Google Chrome Helper uygulaması
Her ikisi de etkin olmadan, bildirimler bildirim merkezinde görünmez.

​
Kurulumdan sonraki adımlar

  1. Desteklenen tarayıcılarınız ve cihazlarınızda kapsamlı test yapın
  2. İzin istekleri için uygun hata işleme uygulayın
  3. Abonelik oranlarını izlemek için analitik kurun
  4. Kullanıcı yorgunluğunu önlemek için bildirim stratejinizi planlayın
  5. İzin isteği zamanlamanız ve mesajınız için A/B testi yapmayı düşünün

​
Yaygın geçiş tuzakları

  • Tarayıcı verilerini temizleme kullanıcıların aboneliğini otomatik olarak kaldırır
  • Yinelenen bildirimler çift uygulamalı geçişler sırasında
  • iOS, push çalışmadan önce web uygulaması kurulumu gerektirir
  • Özel/Gizli modlar asla push bildirimlerini desteklemez
  • Service worker’lar sitenizin root’unda veya yapılandırılmış alt dizininde erişilebilir olmalıdır

​
Sonraki adımlar