Skip to main content
Kullanıcılar sitenizde olmadığında onlara zamanında içerikle ulaşabilmek için web push’u etkinleştirmek üzere bu kılavuzu izleyin. Web push metin, resimler, eylem düğmeleri ve sesleri destekler.
Web push notification examples across different browsers and devices

Web push bildirimleri, kullanıcılar sitenizde olmasa bile onlara ulaşır

Web push için gerekenler:
  • Geçerli bir SSL sertifikasına sahip güvenli bir HTTPS web sitesi
  • OneSignal service worker’ı web sitenize ekleyebilme
  • Same-origin policy’yi takip eden tek bir kaynak (origin)
  • Bildirimleri almak için kullanıcı izni
  • Desteklenen tarayıcılar (Chrome, Firefox, Safari, Edge)
Kullanıcılar gizli veya özel tarama modunda abone olamazlar. iOS ek kurulum gerektirir. iOS için web push’a bakın. Bazı tarayıcılar istemleri sınırlar veya bir kullanıcı hareketi gerektirir. Web push SSS’ye bakın.

Kurulum kılavuzunuzu seçin

Bu site kurulum yollarından birini tamamlayın.
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önetme’ye bakın.

Web SDK kurulumu

Typical Site: kontrol panelini yapılandırın, service worker’ı yükleyin ve JavaScript SDK’sını ekleyin.

WordPress eklentisi

Resmi OneSignal eklentisi. JavaScript SDK veya service worker yüklemesi gerekmez.

Shopify kurulumu

Shopify’ı Vendo entegrasyonu üzerinden bağlayın. Vendo, SDK’yı mağazanızda dağıtır.

Başka bir sağlayıcıdan geçiş

Başka bir web push sağlayıcısından taşının ve aboneliklerinizi koruyun.
Siteniz Angular, React veya Vue ile oluşturulduysa, ilgili framework kılavuzunu kullanın. SDK’yı Google Tag Manager ile yüklüyorsanız, kontrol paneli ve service worker kurulumunu Web SDK kurulumu’nda tamamlayın, ardından GTM’de başlatın. iPhone ve iPad’lerde iOS web push, iOS 16.4+ sürümünden itibaren çalışır. Bir site kurulum yolunu tamamladıktan sonra, bir manifest.json ekleyin ve kullanıcıların sitenizi Ana Ekranlarına eklemesini sağlayın.

iOS web push kurulumu

Bir site kurulum yolunu tamamladıktan sonra ek Apple gereksinimleri.

Entegrasyon türleri

OneSignal kontrol panelinde Settings > Push & In-App > Web’e gidin ve sitenize uyan entegrasyon türünü seçin.
OneSignal dashboard showing integration type options: Typical Site, WordPress, and Custom Code

Web sitenizin kurulumuna göre entegrasyon türünüzü seçin

Typical Site

Önerilir. İstemleri, hoş geldin bildirimini ve service worker yolunu kontrol panelinde yapılandırın.

WordPress

Resmi OneSignal WordPress eklentisini kullanıyorsanız gereklidir.

Özel Kod

İstemler ve init seçenekleri üzerinde kodla tam kontrol.
Shopify, kontrol panelinde bir seçim düğmesi değildir. Shopify mağazaları Özel Kod kullanmalıdır. Typical Site, Vendo service worker yolunu ayarlayamaz, bu nedenle abonelikler başarısız olur. Shopify kurulumu’na bakın.
Bir entegrasyon türü seçtikten sonra, ilgili kurulum kılavuzunu tamamlayın. Typical Site alan ayrıntıları Web SDK kurulumu’ndadır. Özel Kod alan ayrıntıları Özel Kod kurulumu’ndadır.

Web izin istemleri

Kullanıcılar web push alabilmeden önce izin vermelidir. Tarayıcılar bu izin için yerel bir sistem diyaloğu gösterir. OneSignal, değeri açıklayabilmeniz ve tarayıcının tekrarlanan yerel istemleri engellemesini önleyebilmeniz için önce özelleştirilebilir bir ön istem önerir. Typical Site ve WordPress: istemleri OneSignal kontrol panelinde istediğiniz zaman ekleyin, kaldırın ve güncelleyin. Özel Kod: istemleri OneSignal.init() içinde kontrol edin. Web SDK referansı’na bakın.
Faydayı ön istemde açıklayın, istemi etkileşimden sonra gösterin (ilk sayfa yüklemesinde değil), ardından yerel tarayıcı diyaloğunu yalnızca kullanıcı kabul ettiğinde açın.

Web izin istemleri

Slidedown, kategori, yerel, abonelik zili ve diğer istem türlerini karşılaştırın.

Web SDK referansı

Web SDK ile istemleri kodla gösterin veya gizleyin.
iOS, kullanıcı sitenizi Ana Ekranına ekleyene kadar izin istemini göstermez. iOS için web push’a bakın.

Kullanıcılar ve abonelikler

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

OneSignal kontrol paneli: Audience > Users

Kullanıcılar

Kullanıcıları yönetin, External ID’ler atayın ve etkinliklerini izleyin.

Abonelikler

Aboneliklerin tarayıcılar ve cihazlar genelinde nasıl çalıştığı.

Segmentler

Davranış, cihaz ve daha fazlasına göre hedeflemek için kullanıcıları segmentlere ayırın.

Web push bildirimlerini tasarlayın

Web push bildirimleri başlıkları, mesajları, ikonları, resimleri ve eylem düğmelerini destekler. Diyagram, hangi öğeleri özelleştirebileceğinizi (1–5) ve hangilerini tarayıcının kontrol ettiğini (6–9) gösterir.
Annotated diagram showing the anatomy of a web push notification with customizable and browser-controlled elements

Web push bildirim anatomisi. 1–5 öğelerini özelleştirin. Tarayıcı 6–9'u kontrol eder.

Özelleştirilebilir öğeler:
  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: Kare marka ikonu (önerilir: 256×256 PNG, JPG veya animasyonsuz GIF)
  4. Büyük resim: Göz alıcı görsel içerik
  5. Eylem düğmeleri: Harekete geçirici düğmeler
Tarayıcı tarafından kontrol edilen öğeler (özelleştirilemez):
  1. Tarayıcı: Push’u görüntüleyen tarayıcı
  2. Alan adı: Tarayıcı tarafından ayarlanan site kaynağınız (origin)
  3. Zaman damgası ve kapatma: Tarayıcı tarafından eklenen kontroller
  4. Daha fazla seçenek: Tarayıcıya özgü ek kontroller

Push genel bakış

Push bildirim oluşturma, seçenekler ve teslimat davranışının tam genel bakışı.

Şablonlar

Tutarlı mesajlaşma için yeniden kullanılabilir şablonlarla zaman kazanın.

Kişiselleştirme ve yerelleştirme

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

Mesaj kişiselleştirme

Mesajları uyarlamak için ad veya tercihler gibi dinamik değişkenler ekleyin.

Çok dilli mesajlaşma

Mesajları her kullanıcının tercih ettiği dilde iletin.

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

Mesajların ne zaman görüneceğini, ne kadar süre saklanacağını ve tıklamada ne olacağını kontrol edin.

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

Throttling

Bildirim teslimat hızını kontrol edin.

Frequency Capping

Aynı kullanıcıya aşırı bildirim gönderilmesini önlemek için limitler ayarlayın.

Time to live (TTL)

Cihaz çevrimdışıyken push hizmetlerinin mesajları ne kadar süre tuttuğunu tanımlayın.

Web push topic

Yinelenen bildirimleri gruplamak, değiştirmek veya bastırmak için konuları kullanın.

Tıklama davranışı

Başlatma URL’sini ve bir tıklamanın açık bir sekmeyi nasıl odaklayacağını veya yönlendireceğini seçin.

Kurulumunuzu test edin

Tüm kitlenize göndermeden önce entegrasyonu tarayıcılar genelinde doğrulayın.

Başlatma öncesi kontrol listesi

  • SDK, konsol hatası olmadan yüklendi
  • İzin istemi görünüyor ve doğru çalışıyor
  • Test bildirimi gönderildi ve alındı
  • İkonlar ve resimler doğru şekilde görüntüleniyor
  • Service worker kaydedildi ve güncel
  • HTTPS sertifikası geçerli

Analitik ve sorun giderme

Push mesaj raporları

Her mesaj için teslimat, açılma oranı ve tıklama oranı metriklerini görüntüleyin.

Analitik genel bakış

Kanallar genelinde etkileşim ve kullanıcı davranış metriklerini keşfedin.

Bildirimler gösterilmiyor veya gecikmeli

Mesajlar görünmüyorsa sorun giderme kontrol listesi.

Bildirim resimleri gösterilmiyor

Farklı tarayıcılarda resim görüntüleme sorunlarını düzeltin.

Sonraki adımlar

A/B testi

Etkileşimi neyin artırdığını bulmak için deneylerle mesajları optimize edin.

Yolculuklar

Kullanıcı davranışıyla tetiklenen otomatik, çok adımlı mesajlaşma akışları oluşturun.

Etiketler

Kişiselleştirme ve segmentasyon için kullanıcılara özel özellikler ekleyin.

SSS

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

Evet, iOS 16.4+ sürümünden itibaren. Önce Typical Site, Özel Kod, WordPress veya Shopify kurulumunu tamamlayın, ardından bir manifest.json ekleyin ve kullanıcıların sitenizi Ana Ekranlarına eklemesini sağlayın. iOS web push kurulumu’na bakın.

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

En yaygın nedenler şunlardır:
  1. Kullanıcı tarayıcı verilerini temizledi. Web Push ayarlarınızda Auto Resubscribe seçeneğini etkinleştirdiyseniz, sitenize geri döndüklerinde otomatik ve sessizce yeniden abone edilirler.
  2. Kullanıcı, işletim sistemi ayarlarında push bildirimlerini kapattı. Push bildirimlerini tekrar alabilmek için sitenize manuel olarak yeniden abone olmaları gerekir.
Bu ve diğer nedenler hakkında daha fazla ayrıntı için Web Push Bildirimleri Gösterilmiyor’a 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 aboneliklere ö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 same-origin policy’yi 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’lere ve diğer alt alan adlarına izin verilmez. 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. Abonelik için kullanıcıları tek bir kaynağa yönlendirin veya kaynak başına bir OneSignal uygulaması oluşturun. Birden fazla site ve alt alan adı’na bakın.

Web push istemim neden gösterilmiyor?

Yaygın nedenler arasında sitenin HTTP üzerinden sunulması, service worker’ın kaydedilmemiş olması, kullanıcının izni zaten vermiş veya reddetmiş olması ya da gizli mod bulunur. Tarayıcı konsolunu kontrol edin ve Web izin istemleri ile İstem görüntüleme sorunları’na bakın.