Tarayıcı Bildirimleri

Anahtar çifti, service worker, izin kartı ve abonelikler

Tarayıcı bildirimi (web push), senaryonun mağazanızın tarayıcısına doğrudan gönderdiği bildirimdir. E-posta ve SMS'ten farkı, bağlanacak bir sağlayıcının olmamasıdır: kurulum, kanalın kendi anahtarı ve alan adınızda yayınladığınız bir dosyadan ibarettir. Ekran Ayarlar → Mesajlaşma Sağlayıcıları → Browser notifications (Settings → Messaging Providers) kartıdır; e-posta ve SMS sağlayıcıları için Mesajlaşma Sağlayıcıları.

Kurulum

Bağlanacak bir sağlayıcı yoktur. Kimlik bilgisi kanalın kendi anahtar çiftidir (VAPID) ve izin, bir sağlayıcıya değil sizin alan adınıza verilir. Bu yalnızca web kanalında vardır; uygulama kanalında kart "Uygulama kanalının bildirim gönderecek tarayıcısı yok" der.

Kurulum iki parçadır ve ikisi de gerekir; anahtar olup service worker yoksa kanal hazır görünür ama hiçbir bildirim ulaşmaz.

  1. Generate keys (Anahtarları üret): kanalın anahtar çiftini oluşturur. Kart Ready (Hazır) olur, açık anahtar ekranda görünür ve abone sayısı yazar (örn. "12 abone tarayıcı · 3 kayıp").
  2. Download selwise-sw.js: dosyayı indirip alan adınızın kökünde /selwise-sw.js olarak yayınlayın. Bir service worker'ın kapsamı, sunulduğu klasörden geniş olamaz ve bildirim her sayfada çalışmalıdır.
  3. Tarayıcıdan izin isteyin: aşağıdaki kartı açın ya da kendi düğmenizden Selwise.requestPushPermission() çağırın. Tarayıcının kendi istemi yalnızca bir tıklamadan sonra çıkar, sayfa yüklenirken asla.
AlanAçıklama
Contact address (İletişim adresi)mailto: ya da https: ile başlamalı, en çok 255 karakter. Push servisi trafiğiniz hakkında size ulaşabilsin diye gereklidir; boş bırakırsanız Selwise'in kendi adresi kullanılır. Anahtarlar hazırsa değiştirdiğinizde ayrıca bir kaydet düğmesi çıkar
Public key (Açık anahtar)Salt okunur
Subscribed browsers (Abone tarayıcı)Etkin abonelik sayısı; gone (kayıp) olarak yazılan, push servisinin artık bulunmadığını bildirdiği tarayıcılardır

Yeni anahtar üretmek bütün aboneleri kaybettirir

Eski anahtarla abone olmuş her tarayıcı, yeni anahtarla imzalanmış bildirimi reddeder. Generate new keys (Yeni anahtar üret) bunu abone sayısıyla birlikte onayınıza sunar. Gerçekten sıfırdan başlayacaksanız basın.

Tarayıcıdan önce siz sorun

Tarayıcı bir siteye ömür boyu tek istem hakkı verir ve ikinci reddedişte siteyi kalıcı olarak engeller. Bu kart, tarayıcının isteminden önce sizin kartınızı gösterir; tarayıcının kendi istemi yalnızca alışverişçi kartın izin düğmesine tıkladığında çıkar. Kart kampanya değildir: sayfa hedeflemesi, deney ya da gösterim sınırı onu gizleyemez.

AlanAralık ya da varsayılanAçıklama
Show this ask on your storefrontKapalıAnahtarlar üretilmeden açılamaz ("Önce anahtarları oluşturun")
Title (Başlık)En çok 80 karakterVarsayılan: "Hiçbir şeyi kaçırmayın"
Message (Mesaj)En çok 240 karakter
Allow button (İzin düğmesi)En çok 40 karakterVarsayılan: "İzin ver"
Not now button (Şimdi değil düğmesi)En çok 40 karakterVarsayılan: "Şimdi değil"
Ask after (page views)1 ile 20, varsayılan 2Bir tarayıcının sorulmadan önce görmüş olması gereken sayfa sayısı
Ask again after (days)1 ile 365, varsayılan 30"Şimdi değil" cevabına ne kadar süre saygı gösterileceği

Bütün metinler dolu olmalıdır; metni boş bir kart çizilmez. Kaydettikten sonra mağazalar değişikliği yaklaşık bir dakika içinde alır. Kart şu durumlarda gösterilmez: tarayıcı kararını zaten verdiyse, sayfa sayısı eşiğine ulaşılmadıysa, çerez bildirimi hâlâ yanıt bekliyorsa, kanalın anahtarı yoksa. Ayrıntı: Ulaşılabilirlik.

Abonelik yaşam döngüsü

  • Alışverişçi izin verince tarayıcısı kanalınıza abone olur; bir alışverişçinin birden çok tarayıcısı (dizüstü, telefon) olabilir. Mesaj, herhangi bir tarayıcı kabul ederse "teslim edildi" sayılır; üç tarayıcı tek mesajı üç kez saymaz.
  • Push servisi bir tarayıcı için "yok" (404 ya da 410 Gone) derse abonelik süresi dolmuş işaretlenir ve kartta kayıp sayısına eklenir. Bu bir arıza değil, listenin doğal erimesidir; teslimat hata olarak değil, "Ulaşılamadı" nedeniyle atlandı sayılır. Tarayıcı geri dönerse yeni bir abonelik olarak gelir.
  • Alışverişçi izni geri alırsa abonelik silinir.
  • Geçici push hatalarında en çok 3 deneme yapılır.

Son güncelleme: 22 Ekim 2026