WordPress için Webpushr Push Bildirimleri Nasıl Kurulur

Webpushr, kullanıcılar sitenizden tamamen ayrılmış olsa bile, onay vermiş kullanıcılara gerçek zamanlı tarayıcı bildirimleri ileten bir web push bildirimi platformudur. E-posta veya SMS’in aksine, web push herhangi bir kişisel iletişim bilgisi gerektirmez — aboneler bildirimleri doğrudan tarayıcılarının yerel bildirim sistemi aracılığıyla Web Push Protokolü ve Push API üzerinden alır.

Bu kılavuz, hesap oluşturma ve WordPress eklenti yapılandırmasından gelişmiş segmentasyon, tetikleyici tabanlı otomasyon ve abone analitiğine kadar tüm kurulum sürecini ele almaktadır. Ayrıca çoğu öğreticinin tamamen atladığı teknik uç durumları da kapsar — service worker çakışmaları, HTTPS gereksinimleri, iOS uyumluluk eksiklikleri ve performans değerlendirmeleri.

Başlamadan Önce Ön Koşullar

WordPress kontrol paneline dokunmadan önce, ortamınızın aşağıdaki zorunlu gereksinimleri karşıladığını doğrulayın:

• HTTPS zorunludur. Push API ve service worker’lar güvenli kaynaklarla sınırlıdır. Düz HTTP üzerinde çalışan bir site, service worker kaydı yapamaz ve dolayısıyla web push bildirimleri iletamaz. Siteniz henüz güvence altına alınmamışsa, geçerli bir SSL sertifikasına ihtiyacınız var — AlexHost bu gereksinimi karşılayan SSL Sertifikaları sunmaktadır.
• Webpushr meta kutusuyla tam Gutenberg blok editörü uyumluluğu için WordPress 5.0 veya üzeri önerilir.
• Eklenti başlatmayı sessizce bozabilecek kullanımdan kaldırılmış işlev uyarılarından kaçınmak için sunucu tarafında PHP 7.4 veya üzeri.
• Tarayıcı desteği farkındalığı: Masaüstü ve Android’de Chrome, Firefox ve Edge, Web Push Protokolünü destekler. macOS’ta Safari, Safari 16 (macOS Ventura) ile destek ekledi. iOS Safari, yalnızca ana ekran PWA’ları için iOS 16.4’te sınırlı destek ekledi — iOS’ta standart tarayıcı tabanlı web push, bu yazı itibarıyla güvenilmez olmaya devam etmektedir.
• Çakışan service worker yok. Halihazırda bir PWA eklentisi veya başka bir push bildirim servisi çalıştırıyorsanız, bunların service worker’ları Webpushr’ınkiyle çakışabilir. Devam etmeden önce chrome://serviceworker-internals/ adresinde aktif service worker’larınızı denetleyin.

Adım 1: Webpushr Hesabınızı Oluşturun ve Yapılandırın

webpushr.com adresine gidin ve yeni bir hesap kaydedin. Katılım sürecinde, web sitenizin alan adı istenecektir. Alan adını, www öneki dahil veya hariç olmak üzere, tarayıcınızın adres çubuğunda göründüğü şekliyle tam olarak girin — bu değer service worker’ın kapsamını belirlemek için kullanılır ve uyuşmazlıklar abonelik hatalarına neden olur.

Kayıt sonrasında Webpushr iki kritik kimlik bilgisi sağlar:

• API Key — WordPress eklentisi tarafından bildirim göndermek için REST API çağrılarını doğrulamak amacıyla kullanılır.
• Auth Token — Daha sonra özel entegrasyonlar oluşturursanız sunucu tarafı API istekleri için kullanılır.

Her iki değeri de Webpushr kontrol panelindeki Account > API Keys bölümünde bulun ve güvenli bir şekilde saklayın. API Key geleneksel anlamda bir sır değildir (istemci tarafı isteklere gömülüdür), ancak Auth Token gizli tutulmalıdır.

Webpushr Ücretsiz ve Ücretli Plan Sınırları

Çoğu küçük WordPress sitesi için, ücretli bir plana geçmeden önce kanalı doğrulamak amacıyla ücretsiz katman yeterlidir.

Adım 2: Webpushr WordPress Eklentisini Kurun

WordPress yönetici panelinize giriş yapın ve şu yolu izleyin:

1. Eklentiler > Yeni Ekle bölümüne gidin.
2. Webpushr için arama yapın.
3. Webpushr Inc. tarafından yayınlanan resmi eklentiyi bulun — benzer isimli bir eklenti yüklemekten kaçınmak için yayıncı adını doğrulayın.
4. Şimdi Kur‘a, ardından Etkinleştir‘e tıklayın.

Alternatif olarak, WordPress’i komut satırından yönetiyorsanız WP-CLI aracılığıyla yükleyin:

wp plugin install webpushr-web-push-notifications --activate

Etkinleştirmenin ardından, sol taraftaki WordPress navigasyonunda yeni bir Webpushr menü öğesi görünür.

Eklentinin Sunucu Düzeyinde Gerçekte Ne Yaptığı

Eklentinin mimarisini anlamak, sorunları akıllıca gidermenize yardımcı olur. Etkinleştirme sırasında eklenti:

1. Service worker dosyasını (webpushr-sw.js) site kökünden sunmak için bir yeniden yazma kuralı kaydeder. Bu kritiktir — service worker’ların tüm kaynağı kontrol edebilmesi için kök kapsamdan sunulması gerekir.
2. Webpushr SDK’sını yükleyen ve service worker’ı kaydeden bir JavaScript parçacığını wp_enqueue_scripts aracılığıyla her ön uç sayfasına enjekte eder.
3. İçerik yayınlandığında otomatik push bildirimleri tetiklemek için publish_post ve publish_page WordPress aksiyonlarına bağlanır.

Önbellek eklentiniz service worker dosyasını agresif biçimde önbelleğe alıyorsa, aboneler eski push yükleri alabilir veya tamamen kayıt yaptıramayabilir. webpushr-sw.js dosyasını önbellek kurallarınızın dışında tutun.

Adım 3: Eklentiyi Webpushr Hesabınıza Bağlayın

WordPress kontrol panelinizde Webpushr > Ayarlar bölümüne gidin. API Key etiketli bir alan göreceksiniz. Adım 1’de Webpushr kontrol panelinden aldığınız API Key’i yapıştırın.

Değişiklikleri Kaydet‘e tıklayın. Eklenti, Webpushr API’sine bir doğrulama isteği gönderecektir. Anahtar geçerliyse, bir başarı onayı görünür. Bir hata görürseniz:

• Yapıştırılan anahtarda baştaki veya sondaki boşluk karakterleri olmadığını doğrulayın.
• Sunucunuzun api.webpushr.com adresine giden HTTPS istekleri yapabildiğini doğrulayın. Bazı güçlendirilmiş VPS yapılandırmaları varsayılan olarak giden bağlantıları engeller. Bir Linux sunucusunda şununla test edin:

curl -I https://api.webpushr.com

200 OK veya 301 yanıtı bağlantıyı doğrular. Bağlantı zaman aşımına uğrarsa, iptables -L OUTPUT ile güvenlik duvarı kurallarınızı veya barındırma sağlayıcınızın ağ ACL’sini kontrol edin.

WordPress’i bir VPS Hosting ortamında çalıştırıyorsanız, güvenlik duvarı kuralları üzerinde tam kontrole sahipsiniz ve Webpushr API uç noktasını doğrudan beyaz listeye alabilirsiniz.

Adım 4: Katılım İstemini Yapılandırın

Katılım istemi, kullanıcılardan bildirimlere izin vermelerini isteyen tarayıcı izin diyaloğudur. Tarayıcının yerel izin diyaloğu stilize edilemez — tarayıcının kendisi tarafından oluşturulur. Ancak Webpushr, yerel diyalogdan önce görünen ve tamamen özelleştirebileceğiniz bir ön izin istemi (özel bir katman) sağlar.

Ön izin istemini Webpushr kontrol panelinde Settings > Opt-in Prompt altında yapılandırın:

• İstem stili: Zil widget’ı, üst çubuk, kayar kutu veya özel modal arasında seçim yapın.
• İstem metni: Abone olmanın değerini açıkça ileten bir metin yazın. “Bildirimlere izin ver?” gibi belirsiz istemler, abonelerin ne alacağını belirten istemlerden sürekli olarak daha düşük performans gösterir; örneğin “Yeni güvenlik tavsiyeleri yayınladığımızda anında haberdar olun.”
• İstem gecikmesi: İstemi göstermeden önce bir gecikme (saniye veya sayfa görüntüleme cinsinden) ayarlayın. Sayfa yüklenmesinde hemen göstermek, kullanıcı en az bir içerikle etkileşime girene kadar beklemekten daha düşük katılım oranları üretir.
• Yeniden istem aralığı: Reddeden bir kullanıcıya istemi tekrar göstermeden önce kaç gün geçmesi gerektiğini tanımlayın. Agresif yeniden istem, kullanıcı deneyimini olumsuz etkiler ve hemen çıkma oranını artırır.

İstem Türüne Göre Katılım Oranı Kıyaslamaları

Bağlamsal istemler — bir kullanıcı makaleyi sonuna kadar okumak gibi anlamlı bir eylem tamamladıktan sonra gösterilen — diğer tüm yaklaşımlardan sürekli olarak daha iyi performans gösterir.

Adım 5: Bildirim Teslimat Ayarlarını Yapılandırın

Gönderi Yayınlandığında Otomatik Push

Webpushr > Ayarlar bölümündeki Otomatik Push Bildirimi geçişi, her gönderi yayınladığınızda otomatik olarak bir push bildiriminin tetiklenip tetiklenmeyeceğini kontrol eder. Etkinleştirildiğinde, Webpushr gönderi başlığını, alıntısını ve öne çıkan görsel URL’sini çekerek bildirim yükünü otomatik olarak oluşturur.

Uç durum: Gönderilerin içe aktarıldığı veya durumlarının programatik olarak değiştirildiği (örn. WP-CLI veya bir taşıma betiği aracılığıyla) bir hazırlık-üretim iş akışı kullanıyorsanız, publish_post kancası her içe aktarılan gönderi için tetiklenecek ve abonelerinizi saniyeler içinde düzinelerce bildirimle potansiyel olarak bunaltacaktır. Toplu içe aktarmalar çalıştırmadan önce otomatik push’u devre dışı bırakın:

wp option update webpushr_auto_push 0

İçe aktarma tamamlandıktan sonra yeniden etkinleştirin.

Gönderi Editöründen Manuel Push

Ayrıntılı kontrol için, otomatik push’u genel olarak devre dışı bırakın ve gönderi editöründeki gönderi başına Webpushr meta kutusunu kullanın. Bu meta kutusu, ana içerik editörünün altında görünür ve aşağıdaki kontrolleri sunar:

• Push bildirimi gönder: İşaretlendiğinde, yayınlama veya güncelleme sırasında bir bildirim kuyruğa alan onay kutusu.
• Özel bildirim başlığı: Gönderi başlığını bildirim için daha çekici bir başlıkla geçersiz kılın.
• Özel bildirim mesajı: Otomatik oluşturulan alıntıyı geçersiz kılın.
• Özel bildirim URL’si: Aboneleri gönderi kalıcı bağlantısı yerine belirli bir açılış sayfasına yönlendirin — promosyon kampanyaları için kullanışlıdır.
• Özel bildirim simgesi: Varsayılan site simgesini kampanyaya özgü bir görüntüyle geçersiz kılın.

Bildirim Yükü Anatomisi

Bir web push bildirim yükü şunlardan oluşur:

• title — bildirimin üstünde kalın olarak görüntülenir.
• body — başlığın altındaki açıklayıcı metin.
• icon — bildirimin yanında gösterilen kare görüntü (önerilen 192×192 px).
• image — desteklenen platformlarda gövdenin altında gösterilen büyük banner görüntüsü (Android’de Chrome, Windows’ta Chrome).
• badge — Android durum çubuğunda gösterilen küçük tek renkli simge.
• url — kullanıcı bildirimi tıkladığında gidilecek hedef URL.
• actions — özel etiketler ve URL’lerle en fazla iki eylem düğmesi (Chrome ve Edge’de desteklenir).

title değerini 50 karakterin altında ve body değerini 120 karakterin altında tutmak, çoğu platformda kesmeyi önler.

Adım 6: Push Bildirimlerini Uçtan Uca Test Edin

WordPress’e giriş yaptığınız aynı tarayıcı oturumunda test yapmak, abone deneyiminin doğru bir resmini vermez. Ayrı bir tarayıcı profili veya gizli pencere kullanın:

1. Web sitenizi özel/gizli bir pencerede açın.
2. Ön izin istemi, yapılandırılmış gecikmenizden sonra görünmelidir.
3. İstemin harekete geçirici mesajına tıklayın, ardından tarayıcının yerel izin diyaloğunda İzin Ver‘e tıklayın.
4. WordPress kontrol panelinize dönün ve bir test gönderisi yayınlayın ya da Webpushr kontrol panelindeki Test Bildirimi Gönder düğmesini kullanın.
5. Bildirimin doğru başlık, gövde, simge ile göründüğünü ve tıklandığında doğru URL’ye yönlendirdiğini doğrulayın.

Test sırasında yaygın hata modları:

• Bildirim görünmüyor: Tarayıcı bildirimlerinin işletim sistemi düzeyinde engellenmediğini kontrol edin (Windows Odak Yardımı, macOS Rahatsız Etme, Android bildirim kanalları).
• Service worker kaydedilmiyor: DevTools > Uygulama > Service Workers’ı açın ve webpushr-sw.js dosyasının aktif olarak listelendiğini doğrulayın. “Bekliyor” olarak görünüyorsa, başka bir service worker etkinleşmeyi engelliyor demektir.
• Simge yüklenmiyor: Simge URL’si mutlak olmalıdır (https:// ile başlayan) ve görüntü bir CDN’de barındırılıyorsa izin verici CORS başlıklarıyla sunulmalıdır.

Adım 7: Gelişmiş Özellikler — Segmentasyon, Zamanlama ve Tetikleyiciler

Kitle Segmentasyonu

Webpushr’ın segmentasyon motoru, aboneleri şunlara göre etiketlemenize olanak tanır:

• URL tabanlı segmentler: Belirli URL’leri veya URL kalıplarını ziyaret eden aboneleri otomatik olarak etiketleyin (örn. /category/security/ adresini ziyaret eden tüm kullanıcılar security-readers olarak etiketlenir).
• Özel nitelikler: Uygulamanızın zaten takip ettiği kullanıcı özelliklerine dayalı segmentler oluşturmak için JavaScript SDK aracılığıyla rastgele anahtar-değer çiftleri iletin.
• Etkileşim segmentleri: Webpushr, son görülme zaman damgalarını otomatik olarak takip ederek 30+ gündür bildirim almamış aboneleri hedefleyen yeniden etkileşim kampanyaları oluşturmanıza olanak tanır.

Segmentasyon ücretli bir plan gerektirir ve Webpushr kontrol panelinde Segments altında yapılandırılır.

Zamanlanmış Bildirimler

Zamanlama, şu anda bir bildirim oluşturmanıza ve saat dilimi desteğiyle gelecekteki bir tarih ve saatte iletmenize olanak tanır. Bu özellikle şunlar için değerlidir:

• Kesin bir son tarihi olan zamana duyarlı promosyonlar.
• Yüksek etkileşim pencerelerinde iletilmesini istediğiniz, yoğun trafik saatlerinin dışında yayınlanan içerikler.
• Yinelenen özet bildirimleri (örn. haftalık özetler).

Özel Tetikleyici Tabanlı Bildirimler

Özel tetikleyiciler, sitenizdeki JavaScript olaylarına dayalı bildirimler gönderir. Örneğin, bir kullanıcı alışveriş sepetini terk ettikten 24 saat sonra veya belirli bir kaydırma derinliğine ulaştığında bildirim gönderebilirsiniz. Tetikleyiciler, Webpushr JavaScript SDK’sı aracılığıyla yapılandırılır ve WordPress eklentisinin varsayılan yeteneklerinin ötesinde özel geliştirme çalışması gerektirir.

Bildirim Metnini A/B Testi

Ücretli planlarda Webpushr, abone segmentleri genelinde bildirim başlıklarını ve gövde metnini bölünmüş test etmeyi destekler. Tam bir kampanya başlatmadan önce hangi mesajlaşmanın daha yüksek tıklama oranları sağladığını belirlemek için A/B testleri çalıştırın.

Adım 8: Abone Analitiğini İzleyin

Webpushr kontrol paneli aşağıdaki metrikleri sağlar:

• Toplam aboneler: Aktif, abonelikten çıkmış ve süresi dolmuş uç nokta sayıları.
• Teslimat oranı: Gönderilen bildirimlerin tarayıcı push servisine (Chrome/Edge için FCM, Firefox için Mozilla Autopush) başarıyla iletilen yüzdesi.
• Tıklama oranı (CTR): İletilen bildirimlerin tıklamayla sonuçlanan yüzdesi.
• Zaman içinde abonelik büyümesi: Günlük ve haftalık abone edinme eğilimleri.

“İletildi” ve “alındı” hakkında önemli teknik not: Bir bildirim, tarayıcının push servisi (örn. Google’ın FCM’si) yükü kabul ettiğinde iletildi olarak işaretlenir. Kullanıcının cihazı çevrimdışıysa, FCM bildirimi kuyruğa alır ve cihaz yeniden bağlandığında iletir — ancak yalnızca yapılandırdığınız TTL (Yaşam Süresi) penceresi içinde. Varsayılan TTL 28 gündür. Zamana duyarlı bildirimler için, eski içeriklerin iletilmesini önlemek amacıyla daha kısa bir TTL ayarlayın.

Platform ve Tarayıcı Uyumluluk Matrisi

“Tam destek”, Web Push Protokolü, service worker’lar ve bildirim eylemlerinin tümünün desteklendiği anlamına gelir. Standart tarayıcı oturumlarındaki iOS kullanıcıları web push’un erişim alanı dışında kalmaya devam etmektedir; bu, mobil ağırlıklı siteler için anlamlı bir kitle boşluğudur.

Barındırma Altyapısı Değerlendirmeleri

Web push bildirim teslimatı büyük ölçüde üçüncü taraf push servisleri (FCM, Mozilla Autopush) tarafından gerçekleştirilir, bu nedenle sunucunuzun ham verimi teslimat için bir darboğaz değildir. Ancak barındırma ortamınız şunları etkiler:

• Service worker sunma hızı: webpushr-sw.js dosyasının, tarayıcıların service worker’ın güncel olduğunu doğrulaması için her sayfa yüklemesinde hızlıca getirilmesi gerekir. Yavaş bir sunucu, bu dosya için İlk Bayta Kadar Geçen Süreyi (TTFB) artırır.
• API yanıt süresi: Yeni bir gönderi yayınlandığında, eklenti Webpushr’a senkron bir API çağrısı yapar. Kısıtlayıcı giden bağlantı sınırlarına sahip paylaşımlı barındırmada, bu çağrı zaman aşımına uğrayabilir ve sessizce başarısız olabilir.
• Webhook güvenilirliği: Webpushr webhook’larını abonelik olaylarını sunucunuza bildirmek üzere yapılandırırsanız, sunucunuzun gelen POST isteklerini güvenilir biçimde kabul etmesi gerekir.

WordPress’i cPanel’li VPS üzerinde çalıştırmak, PHP yürütme zaman aşımlarını ayarlama, giden güvenlik duvarı kurallarını yapılandırma ve paylaşımlı ortamların kısıtlamaları olmadan service worker teslimatını izleme kontrolü sağlar. Push bildirim kampanyalarının önemli eş zamanlı trafik artışlarına yol açtığı yüksek trafikli siteler için, bir Dedicated Server, kaynağınızın ortaya çıkan tıklama yükünü kısıtlama olmadan absorbe edebilmesini sağlar.

Birden fazla WordPress mülkü yöneten ekipler için, E-posta Barındırma ile Webpushr’ın birleşimi iki kanallı bir yeniden etkileşim stratejisi oluşturur — anlık iletişim için push, derinlik için e-posta.

Teknik Karar Matrisi: Webpushr’ı Alternatiflere Karşı Ne Zaman Kullanmalı

Webpushr’ın ücretsiz katmanı OneSignal’ınkinden daha sınırlıdır, ancak service worker uygulaması kayda değer ölçüde daha temizdir ve diğer WordPress eklentileriyle çakışmaya daha az eğilimlidir — karmaşık WordPress kurulumlarında pratik bir avantaj.

Yayına Geçmeden Önce Pratik Kontrol Listesi

• HTTPS aktif ve SSL sertifikası geçerli, kendinden imzalı değil.
• Service worker webpushr-sw.js dosyası https://yourdomain.com/webpushr-sw.js adresinde erişilebilir ve 200 durumu döndürüyor.
• Service worker dosyası, önbellek eklentinizin önbellek kurallarından hariç tutulmuş.
• Katılım istemi gecikmesi en az 5 saniye veya bir sayfa görüntüleme olarak ayarlanmış.
• Zamanlanmış toplu içe aktarmalar veya içerik taşımaları çalıştırıyorsanız otomatik push devre dışı bırakılmış.
• Temiz bir tarayıcı oturumunda uçtan uca bir test bildirimi alınmış.
• Bildirim simgesi boyutları 192×192 px ve URL mutlak HTTPS.
• TTL, içeriğinizin zamana duyarlılığına uygun şekilde yapılandırılmış.
• Anlamlı bir karşılaştırma noktasına sahip olmak için ilk kampanyanızdan önce analitik taban çizgisi kaydedilmiş.
• GDPR/gizlilik politikası, push bildirim veri toplama işlemini açıklamak üzere güncellenmiş.

SSS

Webpushr HTTPS olmadan çalışır mı?

Hayır. Web Push API ve service worker’lar, tarayıcı spesifikasyonu tarafından güvenli kaynaklarla sınırlıdır. HTTP üzerinde çalışan herhangi bir site, service worker kaydı yapamaz ve dolayısıyla web push bildirimleri gönderip alamaz. SSL sertifikası, isteğe bağlı bir en iyi uygulama değil, zorunlu bir teknik gerekliliktir.

Push bildirimlerim neden bazı abonelere iletilmiyor?

En yaygın nedenler şunlardır: abonenin cihazı bildirimin TTL penceresi dışında çevrimdışıydı; kullanıcı tarayıcı veya işletim sistemi düzeyinde bildirim izinlerini iptal etti; veya tarayıcı push servisi uç noktası (FCM, Mozilla Autopush) süresi dolmuş veya geçersiz bir kayıt döndürdü. Webpushr’ın kontrol paneli bunları “başarısız” teslimatlar olarak işaretler ve 410 Gone yanıtı döndüren uç noktaları otomatik olarak kaldırır; bu, Web Push Protokolü spesifikasyonuna göre doğru davranıştır.

iOS kullanıcılarına push bildirimi gönderebilir miyim?

iOS 16.4 itibarıyla, web push yalnızca ana ekrana eklenmiş Aşamalı Web Uygulamaları (PWA) için desteklenmektedir. Sitenizi Safari’de veya ana ekrana eklemeden herhangi bir iOS tarayıcısında gezen kullanıcılar web push bildirimleri almayacaktır. Bu, Webpushr’ın bir sınırlaması değil, Apple tarafından uygulanan platform düzeyinde bir kısıtlamadır.

Webpushr service worker’ı mevcut PWA’m veya önbellek eklentimle çakışır mı?

Çakışabilir. Belirli bir kapsamı yalnızca bir service worker kontrol edebilir. Bir PWA eklentisi (örn. Super PWA) veya başka bir push servisi kök kapsamda zaten bir service worker kaydettiyse, Webpushr’ın service worker’ı “bekliyor” durumunda kuyruğa girecek ve hiçbir zaman etkinleşmeyecektir. Çözüm, her iki betiği de içe aktaran bir service worker kullanmak veya tek bir push sağlayıcısı seçip diğerlerini devre dışı bırakmaktır. Alan adınızdaki tüm kayıtlı worker’ları denetlemek için chrome://serviceworker-internals/ adresini kontrol edin.

Webpushr eklentisini devre dışı bırakmak mevcut abonelerimin aboneliğini iptal eder mi?

Hayır. Eklentiyi devre dışı bırakmak, JavaScript SDK’sını ön ucunuzdan kaldırır; bu, yeni abonelikleri engeller ve otomatik bildirimleri durdurur. Ancak mevcut push uç nokta kayıtları, kullanıcı açıkça izni iptal edene veya uç nokta süresi dolana kadar tarayıcıda geçerli kalır. Eklentiyi aynı API Key ile yeniden etkinleştirirseniz, bu abonelere hemen tekrar ulaşılabilir.