Ana içeriğe atla
Web push bildirimleri, kullanıcılar web sitenizde aktif olarak gezinmese bile zamanında içerikle yeniden etkileşim sağlar. Metin, resimler, eylem düğmeleri ve sesler dahil olmak üzere zengin içeriği desteklerler.
Web push notification examples across different browsers and devices
Web push’un çalışması için:
  • HTTPS web sitesi: Web push yalnızca geçerli bir SSL sertifikasına sahip güvenli sitelerde çalışır
  • Service worker: Web sitenize OneSignal service worker’ı ekleyebilmeniz gerekir
  • Tek alan adı origin: Same-origin policy’yi takip etmelidir
  • Kullanıcı izni: Kullanıcılar bildirimleri almak için açıkça izin vermelidir
  • Desteklenen tarayıcılar: Çoğu modern tarayıcıda çalışır (Chrome, Firefox, Safari, Edge)
Kullanıcılar Gizli veya özel tarama modundayken abone olamazlar. iOS cihazlar ek kurulum gerektirir (iOS için Web push’a bakın). Bazı tarayıcılar bildirim limitleri olabilir veya kullanıcı etkileşimi gerektirebilir — Web Push SSS’ye bakın.
Bu kılavuz, OneSignal push bildirimlerini başarıyla uygulamanıza yardımcı olmak için SDK kurulumundan kişiselleştirilmiş push mesajları göndermeye kadar her adımı anlatır.

Web push geliştirici kılavuzları

Web push bildirimleri gönderebilmeniz için, geliştiricinin aşağıdaki adımları tamamlaması gerekir.
Geliştirici değil misiniz? OneSignal projenize geliştirici erişimi olan bir takım arkadaşını davet etmek için Takım Üyelerini Yönet’e bakın.

Yapılandırma seçenekleri

OneSignal kontrol panelinde Settings > Push & In-App > Web altında web sitenizi web push için kurun.
OneSignal dashboard showing web push platform activation in settings
Sitenize uyan entegrasyon türünü seçin:
OneSignal dashboard showing integration type options: Typical Site, WordPress, and Custom Code
Site ayrıntıları:
  • Site Name: Varsayılan bildirim başlıklarında kullanılır
  • Site URL: Alan adı origin’inizi tam olarak eşleştirmelidir (yol veya www uyuşmazlığı yok)
  • Auto Resubscribe: Önerilir - Tarayıcı verilerini temizleyen geri dönen kullanıcıları otomatik olarak yeniden abone eder
  • Default Icon URL: Bildirimlerde gösterilen 256x256px resim (ayarlanmazsa, varsayılan bir zil simgesi kullanılır)

Otomatik yeniden abonelik

Kullanıcılar tarayıcı verilerini temizlerse, push bildirimleri almayı durduracaklar. Kullanıcıları sitenize geri döndüklerinde otomatik olarak yeniden abone etmek için bu seçeneği etkinleştirin. Daha fazla ayrıntı için Abonelikler’e bakın.
OneSignal dashboard web push configuration settings showing site details and auto resubscribe option

Web izin istemleri

Kullanıcılardan bildirim izni istemek, katılım için kritiktir. Kurulumunuza göre izin isteklerinin davranışını ve görünümünü özelleştirebilirsiniz.
Faydayı açıklayan net mesajlaşma kullanın, kullanıcıları doğru zamanda isteyin (örneğin etkileşimden sonra) ve yerel tarayıcı diyaloğunu tetiklemeden önce ön istem kullanın.

Hoş geldin bildirimi

Bir kullanıcı abone olduktan hemen sonra gönderilen isteğe bağlı bir onay push’u etkinleştirebilirsiniz. Tipik ve WordPress entegrasyonu bunu kontrol panelinde ayarlayabilir.
OneSignal dashboard showing welcome notification configuration with title, message, and URL fields
Özel Kod entegrasyonu, OneSignal.init fonksiyonunda welcomeNotification nesnesini kullanır. Ayrıntılar için Web SDK referansı’na bakın. Hoş geldin bildirimleri neden gönderin?
  • Kullanıcıların başarıyla abone olduklarını bildirin
  • Gelecekteki bildirimlerin nasıl görüneceğini gösterin
  • Katılım içeriği veya sonraki adımlar sağlayın

Kullanıcılar ve abonelikler

Bir kullanıcı push’a abone olduğunda, OneSignal otomatik olarak tarayıcısına/cihazına bağlı benzersiz bir abonelik oluşturur. Web push abonelikleri kullanıcılar şunları yaptığında oluşturulur:
  • Belirli bir tarayıcı ve cihaz kullanarak web sitenizde push bildirimleri için izin verme
  • Tarayıcı verilerini temizledikten sonra sitenize geri dönme (Otomatik Yeniden Abonelik etkinse)
  • Yeni bir tarayıcı veya cihazdan abone olma
Her tarayıcı/cihaz kombinasyonu ayrı bir Abonelik oluşturur. Gizli/özel tarama modu Abonelik oluşturamaz. Web push Abonelikleri, onlara bir External ID atanana kadar anonim kalır.
OneSignal dashboard Users page showing a list of Users with Subscription details

iOS Desteği

Apple, iOS 16.4+ çalıştıran iPhone ve iPad’ler için web push desteği ekledi ancak daha katı gereksinimlerle:
  • Kullanıcılar sitenizi Ana Ekranlarına eklemelidir
  • İzin istemleri yalnızca bu adımdan sonra gösterilir
  • Bildirimler, etkinleştirildikten sonra yerel uygulama uyarıları gibi davranır

Web push bildirimlerini tasarlayın

Etkili push bildirimleri oluşturmak, metin yazmaktan daha fazlasını içerir. Hangi öğelerin özelleştirilebilir olduğunu ve bunları etkili bir şekilde nasıl kullanacağınızı öğrenin.
Annotated diagram showing the anatomy of a web push notification with customizable and browser-controlled elements
  1. Başlık: Dikkat çeken başlık (önerilir: 50 karakterin altında)
  2. Mesaj: Ana bildirim içeriği (önerilir: 120 karakterin altında)
  3. İkon: Marka ikonunuz veya bildirime özgü resim (önerilir: 256x256px PNG veya JPG)
  4. Büyük Resim: Göz alıcı görsel içerik
  5. Eylem Düğmeleri: Harekete geçirici düğmeler
  6. Tarayıcı: Push’u görüntüleyen tarayıcı/uygulama
  7. Alan Adı: Tarayıcı tarafından otomatik olarak ayarlanan site origin’iniz
  8. Zaman Damgası ve Kapat: Tarayıcı bu kontrolleri ekler
  9. Daha Fazla Seçenek: Tarayıcıya özgü ek kontroller

Mesaj kişiselleştirme ve yerelleştirme

Push mesajlarını her kullanıcının tercihleriyle ve diliyle eşleşecek şekilde özelleştirebilirsiniz.

Web push davranışını yapılandırın

Push mesajlarınızın gönderdikten sonra nasıl davrandığını—ne zaman göründüklerini, ne kadar süre saklandıklarını ve kullanıcıların nasıl etkileşime girdiklerini—kontrol edin.

Teslimat, görüntüleme ve kapatma ayarları

Tıklama davranışı

Bir kullanıcı bir bildirime tıkladığında ne olacağını kontrol edin. Varsayılan olarak: Tıklamak ana sayfanızı açar. Özelleştirin:
  • Kullanıcıları belirli bir URL’ye yönlendirin
  • UTM takibi kullanın
  • ?_osp=do_not_open ile varsayılan davranışı bastırın

Kurulumunuzu test edin

Başlatmadan önce, web push implementasyonunuzu cihazlar ve tarayıcılar genelinde kapsamlı bir şekilde test edin.

Başlatma öncesi kontrol listesi

  • SDK hatasız olarak doğru şekilde yüklendi
  • İzin istemi görünür ve işlevseldir
  • Test bildirimi gönderildi ve alındı
  • İkonlar ve resimler doğru şekilde işlenir
  • Service worker kaydedildi ve güncel
  • HTTPS sertifikası geçerli

Push analitik ve sorun giderme

Bildirim performansını ölçün ve yaygın teslimat sorunlarını giderin:

Sonraki adımlar


Sıkça sorulan sorular

Kullanıcılar iOS’ta web push’a abone olabilir mi?

Evet, iOS 16.4+‘dan itibaren. Kullanıcıların önce web sitenizi Ana Ekranlarına eklemesi, ardından bildirim izni vermesi gerekir. Tam kurulum adımları için iOS için Web push’a bakın.

Bir kullanıcı neden web push bildirimleri almayı bıraktı?

En yaygın neden, kullanıcının push Aboneliğini kaldıran tarayıcı verilerini temizlemesidir. Geri dönen kullanıcıları otomatik olarak yeniden abone etmek için web push ayarlarınızda Otomatik yeniden abonelik’i etkinleştirin. Ayrıntılar için Abonelikler’e bakın.

Web push bildirimleri gizli veya özel tarama modunda çalışır mı?

Hayır. Kullanıcılar gizli veya özel tarama modundayken web push’a abone olamazlar. Normal bir oturumda oluşturulan abonelikler özel modda erişilemez.

Hangi tarayıcılar web push bildirimlerini destekler?

Chrome, Firefox, Safari (macOS ve iOS 16.4+) ve Edge tümü web push’u destekler. Her tarayıcının farklı istem davranışı ve bildirim görüntülemesi olabilir. Tarayıcıya özgü ayrıntılar için Web Push SSS’ye bakın.

Web push ile alt alan adlarını kullanabilir miyim?

Her alt alan adı (örneğin, app.example.com ile shop.example.com) ayrı bir kaynaktır. Tarayıcılar web push için aynı-kaynak politikasını uygular, bu nedenle her alt alan adı kendi OneSignal uygulamasını gerektirir. Service worker da abone olunan sayfayla aynı kaynakta barındırılmalıdır — CDN’ler ve diğer alt alan adlarına izin verilmez. Kurulum seçenekleri için Birden fazla site ve alt alan adı’na bakın.

Web push için birden fazla domain nasıl kaydedebilirim?

Her domain veya alt alan adı için ayrı bir OneSignal uygulamasına ihtiyacınız var. Tek bir OneSignal uygulaması yalnızca bir kaynağa hizmet edebilir. Birden fazla domain’i yönetmek için kullanıcıları abonelik için tek bir kaynağa yönlendirin veya kaynak başına ayrı OneSignal uygulamaları oluşturun. Ayrıntılı stratejiler için Birden fazla site ve alt alan adı’na bakın.

Web push istemim neden gösterilmiyor?

Yaygın nedenler şunlardır: site HTTPS üzerinden sunulmuyor, service worker doğru şekilde kaydedilmemiş, kullanıcı zaten izin vermiş veya reddetmiş ya da kullanıcı gizli modda. Hatalar için tarayıcı konsolunu kontrol edin ve tam kontrol listesi için Bildirimler gösterilmiyor’a bakın.