Genel bakış
“İstem gösterme” (Prompting), kullanıcılardan push bildirimleri gönderme izni isteme sürecini ifade eder. İstemler, tarayıcı veya mobil uygulama tarafından sunulan açılır mesajlardır ve kullanıcının abone olmak ve push bildirimleri almak için “İzin Ver”e tıklamasını gerektirir. Web Push, Masaüstü, Android ve iOS’ta çalışır, ancak lütfen iOS için web push’un yapılandırılması için bazı ek adımlar gerektirdiğini unutmayın. Bir mobil uygulamanız varsa, Uygulama İçi Mesajlarla Push İzinleri için nasıl istem gösterileceğine bakın. Tarayıcılar, kullanıcının web sitenize abone olması için hem gösterilmesi hem de “İzin Ver” tıklanması gereken kendi yerel, sistem düzeyinde izin istemlerini sağlar. Tarayıcılar artık web sitelerinin yerel izin istemini gösterme konusunda daha seçici olmasını şiddetle öneriyor. Bu nedenle yerel istemden önce OneSignal İstemleri veya kendi özel “yumuşak istemlerinizi” kullanmanız teşvik edilir.OneSignal istemleri (yumuşak istemler)
OneSignal yumuşak istemleri, tarayıcının yerel izin diyalogundan önce görünen kullanıcı dostu, özelleştirilebilir istemlerdir. Bu istemler kullanıcıları kendi başlarına bildirimlere abone etmez; bunun yerine şunlara yardımcı olur:- Bildirimlere abone olmanın değerini açıklamak (push, e-posta veya SMS).
- Tarayıcıların izin isteklerini otomatik olarak engellemesini önlemek.
- Yerel tarayıcı istemini yalnızca kullanıcı ilgisini gösterdikten sonra başlatmak.
İstem simgesi
Web push bildirimlerinizde gösterilen simgeyi özelleştirmek için OneSignal dashboard’unuza gidin: Settings > Push & In-App > Web Settings. Site Setup bölümünde, Default Icon URL’yi yapılandırın. Bu simge, aksi belirtilmedikçe tüm bildirimlerinizde görünür.- Kabul edilen formatlar:
.pngveya.jpg - Önerilen boyut:
256x256piksel (Safari’nin gereksinimlerini karşılamak için) - Ayarlanmazsa, OneSignal genel bir zil simgesi kullanacaktır

Resim, web push ayarlarınızın Site Setup bölümünü gösterir. Web sitesi adınızı, site URL'nizi ve varsayılan simgenizi burada yapılandırırsınız.
İzin istemi kurulumu
Kullanıcı aboneliklerini teşvik etmek için sitenizde görüntülemek istediğiniz istemleri yapılandırın. OneSignal dashboard’unuzda şu yolu izleyin: Settings > Push & In-App > Web Settings > Permission Prompt Setup Oradan, OneSignal’in mevcut istem türlerinden birini seçmek için Add Prompt’a tıklayın. Listede zaten gösterilen mevcut istemleri de düzenleyebilirsiniz.
Yeni istemler ekleyin veya düzenlemek istediğiniz istemi seçin.
- Slidedown: Push bildirimleri ve isteğe bağlı kategori seçimi için kullanılan görsel olarak belirgin bir istem.
- Email/Phone prompt: Kullanıcı e-posta adreslerini, telefon numaralarını veya her ikisini toplamak için kullanılır.
- Subscription bell prompt: Push abonelikleri için genellikle sitenizin alt köşesine yerleştirilen kalıcı bir yüzen widget.
- Custom link prompt: Yerel tarayıcı istemini tetikleyen, sitenize gömülü özelleştirilebilir bir düğme veya bağlantı.
- Native permission prompt: Kullanıcıların push bildirimleri alabilmesi için kabul edilmesi gereken gerekli tarayıcı düzeyinde istem.
Slidedown & category
Slide ve Category istemleri masaüstünde ekranın üst merkezinde ve mobilde alt merkezde belirgin şekilde görünür. Bunlar, gerekli yerel izin isteminden önce gösterilen yüksek görünürlüğe sahip yumuşak istemlerdir. Kullanıcıyı kendi başlarına abone etmezler ancak abonelik akışını başlatmaya yardımcı olur.
Kategori Etiketleri ile Slide İstemi'ni gösteren örnek.
- Settings > Push & In-App > Web Settings > Permission Prompt Setup bölümüne gidin
- Add Prompt > Push Prompt > Push Slide Prompt seçin
init kodunuzun promptOptions nesnesi içinde slidedown özelliklerini kullanın. Daha fazla ayrıntı için Web SDK Referansı’na bakın.
Push slide istemi seçenekleri.
Slide istem metni
Slide istemde görüntülenen metni özelleştirebilirsiniz:- Eylem mesajı: 90 karaktere kadar
- Düğme etiketleri: her biri 15 karaktere kadar
- Font, boyut veya renk özelleştirmesi şu anda desteklenmiyor

Slide istem metin seçenekleri.
init kodunuzun promptOptions nesnesi içinde text özelliklerini kullanın. Daha fazla ayrıntı için Web SDK Referansı’na bakın.Kategoriler
Slidedown istemini kategoriler ekleyerek geliştirebilirsiniz—kullanıcıların belirli mesaj konularına (örneğin, Haberler, Satışlar, Güncellemeler) ilgi göstermelerini sağlayan onay kutuları.- 10 kategori kadar izin verilir
- Her kategori, 1 (seçili) veya 0 (seçili değil) olan bir Veri Etiketi olarak saklanır
- Segmentasyon ve kullanıcı tercihlerine göre mesajları hedefleme için kullanışlıdır
- Label: kullanıcının istemde gördüğü şey. İlk harfi büyük yapmanız önerilir.
- Tag Key: OneSignal’deki etiketin ne olacağı. Boşluklar için küçük harf ve alt çizgi (
_) kullanmanız önerilir. - Update Instructions, Positive and Negative Buttons: kullanıcı zaten push’a abone olduktan sonra kategori istemini tekrar görüntülemeyi seçerseniz, eylem mesajı yerine güncelleme talimatları gösterilir. Bu, kullanıcıya kategorilerini güncelleyebileceklerini bildirmenize olanak tanır.

Örnek kategoriler. Label, kullanıcıların gördüğü şeydir, tag key ise '1' değeriyle bir tag key olarak ayarlanan şeydir.
init kodunuzun promptOptions nesnesi içinde categories özelliklerini kullanın. Daha fazla ayrıntı için Web SDK Referansı’na bakın.Email & phone number prompt
Email & Phone İstemi, isteğe bağlı kullanıcı iletişim bilgilerini doğrudan bir Slidedown içinde toplar. Her alanda doğru formatlamayı sağlamak için yerleşik doğrulama vardır. Gönderildikten sonra:- Kullanıcı için yeni Email ve/veya SMS abonelikleri oluşturulur
- Bu kanallar arasında onlara mesaj göndermeye başlayabilirsiniz
- Settings > Push & In-App > Web Settings > Permission Prompt Setup > Add Prompt > Email/Phone Prompt bölümüne gidin.

Email & Phone Number İstem Kurulumu

Email & Phone Number İstem Kurulumu
init kodunuzun promptOptions nesnesi içinde type’ı email, sms veya smsAndEmail olarak ekleyin. Daha fazla ayrıntı için Web SDK Referansı’na bakın.Subscription bell prompt
Subscription Bell İstemi, web sitenizin alt köşesinde görünen küçük, kalıcı bir widget’tır. Abone olmamış bir kullanıcı tarafından tıklandığında, Yerel Tarayıcı İstemi’ni tetikler. Minimal ayak izi nedeniyle, zil her zaman görünür bırakılabilir, bu da onu devam eden kabul fırsatları için pasif ama etkili bir seçenek haline getirir. Kapatılması gerektirmez ve kullanıcılara ne zaman abone olacakları konusunda kontrol sağlar.
Subscription Bell İstemi
Tipik Site & WordPress Kurulumu: Subscription Bell İstemi
Tipik Site & WordPress Kurulumu: Subscription Bell İstemi
- Renk
- Boyut
- Alt konum (sol veya sağ)
- Metin ve etiketler

Dashboard'da Subscription Bell Kurulumu
Custom Code Kurulumu: Subscription Bell İstemi
Custom Code Kurulumu: Subscription Bell İstemi
notifyButton parametresini kullanın. Bell İstemi özelleştirmeleri için farklı örnekler arasında geçiş yapabilirsiniz.Gizleme: Bir kullanıcı abone olduktan sonra subscription bell’i gizlemek veya yalnızca belirli sayfalarda göstermek için, başlatma sırasında displayPredicate fonksiyonunda false değerini veya false değerine çözümlenen bir Promise döndürdüğünüzden emin olun. Bu fonksiyon, subscription bell gösterilmeden önce değerlendirilir. Subscription bell’i göstermek için başka herhangi bir değer döndürebilirsiniz.Custom link prompt
Custom Link İstemi, web sitenizin herhangi bir yerine gömebileceğiniz kullanıcı tarafından tetiklenen bir düğme veya bağlantıdır. Tıklandığında, push bildirimleri için Yerel Tarayıcı İstemi’ni görüntüler.
Custom Link İstemi
- Bir blog yazısının altında: “Bu makaleyi beğendiniz mi? Gönderi yayınlar yayınlamaz güncellemeleri alın!”
- Site altbilginizde
- Yapışkan başlıkta veya yüzen araç çubuğunda
Tipik Site & WordPress Kurulumu: Custom Link İstemi
Tipik Site & WordPress Kurulumu: Custom Link İstemi

Dashboard'da Custom Link Kurulumu
Custom Code Kurulumu: Custom Link
Custom Code Kurulumu: Custom Link
init kodunuzun promptOptions nesnesi içinde, customlink nesnesini ve mevcut özelliklerini ekleyin.Tipik & Custom Code Kurulumu: Ek Stil
Tipik & Custom Code Kurulumu: Ek Stil
onesignal-reset sınıfı vardır.Herhangi bir OneSignal stilini yeniden tanımlamanız gerekirse, işte Custom Link widget’ında kullanılan sınıfların kısa bir referansı:| Sınıf Adı | Şuna uygulanır |
|---|---|
| onesignal-customlink-container | Ana konteyner |
| onesignal-customlink-subscribe | Eylem düğmesi |
| onesignal-customlink-explanation | Özel açıklama metni içeren paragraf |
| state-subscribed | Ana konteynerin içindeki tüm bileşenler |
| state-unsubscribed | Ana konteynerin içindeki tüm bileşenler |
| button | Düğme modundaysa eylem düğmesi |
| link | Bağlantı modundaysa eylem düğmesi |
| small | Ana konteynerin içindeki tüm bileşenler |
| medium | Ana konteynerin içindeki tüm bileşenler |
| large | Ana konteynerin içindeki tüm bileşenler |
| hide | unsubscribeEnabled false olarak ayarlanmışsa ana konteynerin içindeki tüm bileşenler |
Native permission prompt
Yerel izin istemi, kullanıcıların web sitenizden push bildirimlerine abone olmak için kabul etmesi gereken tarayıcı kontrollü diyalogdur. Bu istem:- Abonelik için gereklidir
- OneSignal yumuşak istemlerinden (Slidedown veya Custom Link gibi) sonra otomatik olarak tetiklenir
- Görünüm, metin veya davranış olarak özelleştirilebilir değildir

Yerel İzin İstemi
Tarayıcı yerel istemi davranışı
Farklı tarayıcılar spam izin isteklerini azaltmak için benzersiz davranışlar ve kısıtlamalar uygular:Chrome
Chrome 80+ tam istem yerine daha sessiz bir UI görüntüleyebilir:- İstemleri sık sık reddeden kullanıcılara otomatik olarak uygulanır
- Ayrıca yüksek reddetme oranına sahip sitelere de uygulanır
- İstem göstermek için 3 denemeniz var
-
- kapatmadan sonra, istem 7 gün boyunca bastırılır (kaynak).
Firefox
- Firefox 72+ istemi tetiklemek için bir kullanıcı hareketi gerektirir
- Otomatik istemler engellenir ve kullanıcılar bir site öğesiyle aktif olarak etkileşim kurmalıdır
Safari
- Safari 12.1+ istemleri bir kullanıcı hareketi gerektirir
- Otomatik istem gösterme, doğrudan bir etkileşimle tetiklenmedikçe sessizce engellenir
Edge
Edge güven tabanlı bir model kullanır:- Site güvenilir değilse, istem bastırılır ve tarayıcı çubuğunda bir zil simgesiyle değiştirilir:

Edge'de yabancı veya güvenilmeyen siteler için gösterilen zil simgesi.
- Site güvenilirse, yerel istem normal olarak görünür:

Edge'de güvenilen siteler için yerel istem doğrudan görünür.
Otomatik istem & görüntüleme ayarları
Katılımı maksimize etmek ve kullanıcılarınızı rahatsız etmekten kaçınmak için, istemleri sitenizde biraz zaman geçirdikten sonra göstermeyi geciktirmek en iyisidir. OneSignal, kullanıcı davranışına göre istemleri otomatik olarak görüntülemenize olanak tanır ve iki gecikme koşulu kullanır:- Page Views: Kullanıcının sitenizde herhangi bir sayfayı kaç kez yüklediği
- Seconds on Page: Kullanıcının sayfada geçirmesi gereken süre
Tipik Site & WordPress Kurulumu: Otomatik İstem
Tipik Site & WordPress Kurulumu: Otomatik İstem
- Şu yolu izleyin: Settings > Push & In-App > Web Settings > Permission Prompt Setup
- Bir istem seçin veya yeni bir tane oluşturun
- Otomatik İstemi etkinleştirin
- Gecikme tercihlerinizi ayarlayın (sayfa görüntülemeleri ve zaman gecikmesi)

Örnek: Bu istem, 30 saniye sonra üçüncü sayfa görüntülemede görünecek şekilde ayarlanmıştır.
- Done’a, ardından Save’e tıklayın
Custom Code Kurulumu: Otomatik İstem
Custom Code Kurulumu: Otomatik İstem
init kodunuzun promptOptions nesnesi içinde autoPrompt ve delay seçeneklerini kullanın. İstenen slidedown veya yerel istemleri doğrudan tetiklemek için yöntemler de vardır. Daha fazla ayrıntı için Web SDK Referansı’na bakın.Manuel Tetikleme (Otomatik İstem Yerine)
Manuel Tetikleme (Otomatik İstem Yerine)
- Otomatik İstemi devre dışı bırakın
- Kod aracılığıyla istemi göstermek için SDK’nın Slidedown veya Yerel İstem yöntemlerini kullanın
Slidedown istemi back-off mantığı
Bir Slidedown (Push, Kategori veya Email/Phone) istemi gösterilip kapatıldığında (İzin Ver, İptal veya diyalogu kapatma yoluyla), geri çekilecek ve tanımlanmış bir programa göre yeniden görünecektir:| Etkileşim Sonucu | Sonraki İstem Zamanlaması |
|---|---|
| İlk Kapatma | 3 gün bekle |
| İkinci Kapatma | 7 gün bekle |
| Üçüncü ve sonraki kapatmalar (abone olunmadı) | 30 gün bekle |
SSS
İstemleri Facebook veya Instagram veya TikTok gibi bir sosyal medya uygulamasında nasıl gösterebilirim?
İstemleri Facebook veya Instagram veya TikTok gibi bir sosyal medya uygulamasında nasıl gösterebilirim?
İstemi nasıl çevirebilir/yerelleştirebilirim?
İstemi nasıl çevirebilir/yerelleştirebilirim?
İstemleri A/B Testi yapabilir miyim?
İstemleri A/B Testi yapabilir miyim?
Abonelikleri abone oldukları sayfaya göre segmentlere ayırabilir miyim?
Abonelikleri abone oldukları sayfaya göre segmentlere ayırabilir miyim?
Zil simgesini değiştirebilir miyim?
Zil simgesini değiştirebilir miyim?
Kategorileri sayfaya göre değiştirebilir miyim?
Kategorileri sayfaya göre değiştirebilir miyim?
Slide İstem Olaylarını nasıl takip edebilirim?
Slide İstem Olaylarını nasıl takip edebilirim?
Bir web push istemini kapattıktan sonra, istem tekrar ne zaman gösterilir?
Bir web push istemini kapattıktan sonra, istem tekrar ne zaman gösterilir?
İstemi yalnızca belirli sayfalarda nasıl gösterebilirim?
İstemi yalnızca belirli sayfalarda nasıl gösterebilirim?
Yerel Tarayıcı İstemi istediğimde neden Firefox'ta Slide İstemi görüyorum?
Yerel Tarayıcı İstemi istediğimde neden Firefox'ta Slide İstemi görüyorum?

Firefox simgesi
requestPermission() yöntemini kullanmanız gerekir.Neden mobilde yerel İzin İstemi istediğimde Slide İstemi görüyorum?
Neden mobilde yerel İzin İstemi istediğimde Slide İstemi görüyorum?
requestPermission() yöntemini kullanmanız gerekir.Slide istemi neden sürekli gösteriliyor?
Slide istemi neden sürekli gösteriliyor?
İstemim neden gösterilmiyor?
İstemim neden gösterilmiyor?
- Tarayıcı istemin gösterilmesini engelledi.
- Kullanıcı zaten bildirimlere izin verdi veya zaten abone oldu
- Kullanıcı bildirimleri engelledi. Bir kullanıcı “Engelle” (Chrome), “İzin Verme” (Safari) veya “Asla İzin Verme” (Firefox) tıklarsa, bir daha asla istem gösterilemez ve tarayıcı ayarlarında çok adımlı bir süreç aracılığıyla abone olması gerekir. Bu nedenle OneSignal İstemleri kullanmanız önerilir.
- Otomatik İstem kapalı ve
requestPermission();’a çağrı yok - Yerel İzin İstemi, Gizli Modda, Özel Tarayıcı modunda veya Misafir Tarayıcı modundayken gösterilmeyecektir. Ayrıca Safari 12.1+ veya Firefox 72+‘de hemen gösterilmeyecektir (daha fazla ayrıntı).
- Web push’u destekleyen bir tarayıcı ve cihaz kullandığınızdan emin olun.