Ana içeriğe atla

​
Genel bakış

Bu kılavuz, OneSignal WordPress Web Push Plugin v3+‘ın nasıl kurulacağını ve yapılandırılacağını kapsar.
Daha eski 2.x.x WordPress dokümanları için WordPress Legacy eklentisi’ne bakın.

​
Versiyon 3+‘daki Yenilikler

Bu sürüm, kurulum ve yapılandırma sürecini kolaylaştırarak önemli bir yükseltmeyi işaret eder. Versiyon 3+ ile, tüm istem ayarlarınızı tek bir yerde—OneSignal Dashboard’da—yönetebilirsiniz.
  • 🚀 SDK Yükseltmesi: OneSignal Web SDK’yı versiyon 15’ten 16’ya günceller
  • 💬 Dashboard İstemleri: Tüm izin istemlerini doğrudan OneSignal dashboard’unda yapılandırın—özel kod gerekmez
  • ⏩ Tek Tıkla Yayınlama: Otomatik olarak push bildirimleri göndermek için “Gönderi yayınlandığında bildirim gönder”i işaretleyin
  • 🧑‍🤝‍🧑 Kitle Hedefleme: Her gönderi için hangi segment’lerin bildirim alacağını seçin
  • 📲 Mobil Uygulama Entegrasyonu: İsteğe bağlı deep linking ile mobil uygulama abonelerine gönderin

​
Kurulum

Başlamadan önce, şunlara sahip olduğunuzdan emin olun:
  • OneSignal hesabı (oluşturmak ücretsizdir)
  • Eklentileri kurmak ve yapılandırmak için WordPress yönetici erişimi
  • HTTPS etkin web sitesi (web push bildirimleri için gereklidir)

​
1. OneSignal Dashboard’da WordPress’i Yapılandırın

Ayarlar > Push ve Uygulama içi > Web > WordPress Eklentisi veya Website Builder’a gidin

OneSignal dashboard'unuzdaki Website Builder seçeneklerinden WordPress'i seçin

​
Site kurulumu

  • Site Adı: Sitenizin adı ve varsayılan bildirim başlığı.
  • Site URL’si: WordPress sitenizin tam URL’si ile eşleşmelidir (Aynı köken politikası’nı takip edin)
  • Otomatik Yeniden Abone Olma: Tarayıcı verilerini temizleyen kullanıcıları sitenize geri döndüklerinde otomatik olarak yeniden abone yapmak için bunu etkinleştirin (yeni izin istemi gerekmez)
  • Varsayılan Simge URL’si: Bildirimler ve istemler için kare 256x256px PNG veya JPG dosyası – MacOS Safari, simge olmadan bildirim istemi göstermez.

Tam Site URL'nizi girin. https://your-site.com, https://www.your-site.com'dan farklıdır—yalnızca bir formatı tutarlı bir şekilde kullanın

Yerel olarak mı test ediyorsunuz? Localhost geliştirme için Yerel Test Kılavuzu’na bakın

​
İzin istemleri

Push, E-posta ve SMS için izin istemlerinizi ayarlayın. Push Slide İstemi varsayılan olarak etkindir, ancak ek istemler özelleştirebilir veya ekleyebilirsiniz.
Pro İpucu: Basit istemlerle başlayın ve yavaş yavaş karmaşıklık ekleyin. OneSignal dashboard üzerinden istediğiniz zaman tüm istem ayarlarını değiştirebilirsiniz. Web izin istemleri’nde mevcut tüm seçenekleri keşfedin.
  • Temel İstem Kurulumu
  • Gelişmiş: Kategori Tabanlı Segmentasyon
1

Özelleştirmek için Push Slide İstemi'ne tıklayın

Push slide istem ayarlarınıza erişin ve özelleştirin

2

Zamanlamayı ve metni yapılandırın:

  • İlk test için Otomatik İstem’i 1 sayfa görüntüleme ve 1 saniyeye ayarlayın
    • İstem metnini ve görünümünü özelleştirin
    • Lansmanın ardından kullanıcı davranışına göre zamanlamayı ayarlayın

Otomatik istem zamanlamasını yapılandırın ve istem görünümünü özelleştirin

3

İstemi yapılandırmayı bitirdiğinizde Bitti'ye tıklayın.

Pro İpucu: Basit istemlerle başlayın ve yavaş yavaş karmaşıklık ekleyin. OneSignal dashboard üzerinden istediğiniz zaman tüm istem ayarlarını değiştirebilirsiniz. Web izin istemleri’nde mevcut tüm seçenekleri keşfedin.

​
Hoş geldin bildirimi

Kullanıcılar ilk kez abone olduktan sonra gönderilen anında bildirimi ayarlayın. Bu:
  • Kullanıcılara abone oldukları için teşekkür eder
  • Bildirimlerin nasıl göründüğünü gösterir
  • Etkileşimi artırır ve abonelikten çıkmaları azaltır
Hoş geldin mesajı metninizi ve zamanlamasını yapılandırın, ardından aşağı kaydırın ve Kaydet’e tıklayın.
Şimdilik Gelişmiş Push Ayarları bölümünü atlayın — bunlar özel Web SDK kurulumu içindir. Devam etmek için Kaydet’e tıklayın.

​
2. WordPress eklentisini yapılandırın

Dashboard yapılandırmanızı kaydettikten sonra, App ID ve API Anahtarınızı göreceksiniz. Bu değerleri WordPress eklentinize kopyalayın:

OneSignal dashboard'unuzdan App ID ve API Anahtarınızı kopyalayın

API Anahtarını görmüyor musunuz? Yukarıda WordPress seçeneğini seçtiğinizden emin olun. Ardından bir tane oluşturmak için Anahtarlar ve ID’ler kılavuzumuzu takip edin.
1

WordPress yöneticinizde, OneSignal eklenti ayarlarına gidin

2

App ID ve REST API Anahtarını dashboard'unuzda gösterildiği gibi tam olarak yapıştırın

WordPress eklentinizin App ID ve REST API Anahtarının OneSignal dashboard'unuzla tam olarak eşleştiğinden emin olun

​
Gelişmiş ayarlar

İhtiyaçlarınıza göre ek eklenti seçeneklerini yapılandırın:

Gelişmiş işlevsellik ve analitik takibi için gelişmiş ayarlar

URL parametre takibi Takip için bildirim URL’lerine analitik parametreleri ekleyin. Önemli: Özel karakterleri escape edin—girdi URL’lere olduğu gibi eklenir. Google Analytics için örnek: 
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
Özel karakterli örnek: 
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
Ek ayarlar
  • Özel Gönderi Türleri: Bildirim seçeneklerini etkinleştirmek için eklentilerden gönderi türleri ekleyin
  • Bir gönderi yayınlandığında otomatik olarak bildirim gönder: Gönderiler yayınlandığında bildirim kutusunu otomatik olarak işaretler, böylece kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimler gönderilir
  • Bir gönderi güncellendiğinde otomatik olarak bildirim gönder: Gönderiler güncellendiğinde bildirim kutusunu otomatik olarak işaretler, böylece kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimler gönderilir
  • Bir sayfa yayınlandığında otomatik olarak bildirim gönder: Sayfalar yayınlandığında bildirim kutusunu otomatik olarak işaretler, böylece kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimler gönderilir
  • Bir sayfa güncellendiğinde otomatik olarak bildirim gönder: Sayfalar güncellendiğinde bildirim kutusunu otomatik olarak işaretler, böylece kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimler gönderilir
  • 3. taraf eklentilerden bir gönderi yayınladığımda otomatik olarak push bildirimi gönder: Harici yayınlama eklentilerinden otomatik bildirim gönderimi
  • Mobil Uygulama Entegrasyonu: Aynı OneSignal App ID’yi kullanarak mobil uygulama abonelerinize bildirimler gönderin

​
3. Geçişi tamamlayın (Yalnızca Yükseltme Yapan Kullanıcılar)

Yeni kurulumlar bu adımı atlayabilir. v2+‘dan yükseltme yapıyorsanız, takip edin…
Zaman Hassas: Geçiş sırasında kullanıcıların bildirimleri kaçırmasını önlemek için bu adımları en kısa sürede tamamlayın.
1

OneSignal dashboard yapılandırmanızı kaydettikten sonra, WordPress'e geri dönün

2

Eklenti ayarlarında Geçiş Tamamlandı'ya tıklayın

3

Yükseltmeyi tamamlamak için Ayarları Kaydet'e tıklayın

Eklenti yükseltmenizi tamamlamak için Geçiş Tamamlandı'ya tıklayın

Kurulum tamamlandı! Eklenti yapılandırmasını bitirmek için Ayarları Kaydet’e tıklayın.

​
Kurulumunuzu test etme

  • İlk Test
  • Aboneliği Doğrula
  • Test Mesajı Gönder
  1. Web sitenizi ziyaret edin (gizli/özel tarama modundan kaçının—kullanıcılar bu modlarda abone olamaz)
  2. Yapılandırdığınız slidedown istemini arayın

Yapılandırılmış slidedown isteminiz zamanlama ayarlarınıza göre görünmelidir

  1. Abone ol düğmesine tıklayın (bu örnekte “Subscribe” olarak etiketlenmiş)
  2. İstendiğinde tarayıcı iznini kabul edin

Tarayıcı izin istemi (görünüm tarayıcıya göre değişir) web push bildirimleri için gereklidir

  1. Hoş geldin bildirimini kontrol edin (yapılandırıldıysa)

Hoş geldin bildirimi başarılı aboneliğin hemen ardından görünür

Başarılı! WordPress siteniz artık web push bildirimleri için yapılandırıldı. Kullanıcılar abone oldukça Aboneliklerinizde görünmeye başlayacak.Sonraki Adımlar:
Sorun mu Yaşıyorsunuz? Yaygın çözümler için WordPress sorun giderme kılavuzumuza bakın.

​
Bildirim yayınlama

Bir gönderinin yayınlanması için zamanlama yaptığınızda, OneSignal ayrıca zamanlanmış saatte abonelerinize gönderilmek üzere bir push bildirimi planlayacaktır. Gönderiyi yeniden zamanlarsanız, push bildirimi iptal edilecek ve yeni saat için yeni bir push planlanacaktır. OneSignal dashboard’unda Teslimat > Zamanlanmış Mesajlar altında zamanlanmış ve iptal edilmiş bildirimlerinizi görüntüleyebilirsiniz. Daha fazla ayrıntı için Push mesaj raporlarına bakın.

​
Temel gönderi bildirimleri

Bir WordPress gönderisi oluştururken veya düzenlerken, OneSignal Push Notifications metabox’ını bulun (genellikle gönderi düzenleyicisinin altında veya kenar çubuğunda).

OneSignal Push Notifications metabox'ı—gerekirse yeniden konumlandırmak için sürükleyin

Bildirim göndermek için:
  • “Gönderi yayınlandığında veya güncellendiğinde bildirim gönder“‘i işaretleyin
  • O gönderi için bildirim göndermemeyi atlamak için işareti kaldırın

​
Kitle hedefleme

​
Tüm abonelere gönder (varsayılan)

Varsayılan olarak, bildirimler tüm push abonelerine gider.

​
Belirli segment’lere gönder

OneSignal Dashboard > Kitle > Segment’ler’de oluşturduğunuz segment’leri kullanarak belirli kitleleri hedefleyin. Adım 3’te kategoriler ayarladıysanız, karşılık gelen segment’leri oluşturun:
  1. OneSignal dashboard’unuzda Kitle > Segment’ler’e gidin
  2. Etiket anahtarlarınızı kullanarak segment’ler oluşturun, örneğin:
    • Haberler Segment’i: news etiketi 1
    • Fırsatlar Segment’i: deals etiketi 1

Etiketler büyük/küçük harf duyarlıdır! 'news' ve 'News' farklı etiketlerdir

  1. Segment’leri oluşturduktan sonra, WordPress gönderi düzenleyicinizi yenileyin
  2. Açılır menüden hedef segment’inizi seçin

İlgili kullanıcı gruplarını hedeflemek için belirli segment'leri seçin

Gelişmiş Segmentasyon: Kullanıcı davranışı, konum, cihaz türü ve daha fazlasına dayalı segment’ler oluşturun. Etiketler, özel kullanıcı verileri ve kişiselleştirme için en fazla esnekliği sağlar.

​
Bildirim içeriğini özelleştirme

​
Varsayılan davranış

  • Başlık: WordPress site başlığınızı kullanır (Ayarlar > Genel)
  • Mesaj: Gönderi başlığını kullanır
  • Görsel: Gönderinin öne çıkan görselini kullanır (ayarlandıysa)
  • URL: Yayınlanan gönderiye bağlantı verir

​
Özel içerik

Varsayılanları geçersiz kılmak için “Bildirim içeriğini özelleştir“‘i işaretleyin:

Bildirim başlığını, içeriğini ve diğer öğeleri özelleştirin

Örnek sonuç:

Kullanıcılara göründüğü şekliyle özelleştirilmiş push bildirimi

​
Mobil uygulama entegrasyonu

Aynı OneSignal App ID’yi kullanan bir mobil uygulamanız varsa:
  1. Eklenti ayarlarında “Mobil uygulama abonelerine bildirim gönder“‘i etkinleştirin
  2. Gönderi metabox’ında, deep linking için bir Mobil URL ekleyin
  3. Mobil kullanıcılar web tarayıcısı yerine uygulamanıza yönlendirilecektir
Ölçeklemeye Hazır: Sofistike bildirim kampanyaları için gelişmiş push stratejilerini ve otomatik journey’leri keşfedin.
Bildirimler Görünmüyor mu? Çözümler için Web push sorun giderme kılavuzumuza bakın.

​
SSS

Not: Bu yöntem yalnızca slidedown ve yerel izin istemleriyle çalışır, bell veya özel bağlantı istemleriyle çalışmaz.
  1. OneSignal dashboard’unuzda, Ayarlar > Push ve Uygulama içi > Web Ayarları’na gidin
  2. İzin İstemi Kurulumu tablosundan isteminizi seçin
  3. Otomatik İstem’in işaretini kaldırın ve Bitti’ye tıklayın

İstemlerin ne zaman görüneceğini manuel olarak kontrol etmek için Otomatik İstem'i devre dışı bırakın

  1. Aşağı kaydırın, Kaydet’e, ardından Bitir’e tıklayın
  2. İstemlerin görünmesini istediğiniz belirli sayfalara özel JavaScript kodu ekleyin
Bu size istem zamanlaması ve yerleşimi üzerinde tam kontrol sağlar. Uygulama ayrıntıları için Web izin istemlerine bakın.
Evet! Mobil uygulamanız aynı OneSignal App ID’yi kullanıyorsa:
  1. WordPress eklenti ayarlarında “Mobil uygulama abonelerine bildirim gönder“‘i etkinleştirin
  2. Gönderi yayınlarken, deep link’leri belirtmek için OneSignal metabox’ındaki Mobil URL alanını kullanın
  3. Özel bir Mobil URL olmadan, kullanıcılar web sitenize yönlendirilecektir
Bu özellik tek bir WordPress arayüzünden platformlar arası mesajlaşmayı etkinleştirir.
WordPress eklentisi şu anda yalnızca push bildirimlerini desteklemektedir. E-posta ve SMS için:
  1. E-posta: E-posta kurulum kılavuzumuzu takip edin, ardından E-posta mesajlaşma araçlarını kullanın
  2. SMS: SMS kurulum kılavuzumuzu takip edin, ardından SMS mesajlaşma araçlarını kullanın
Her iki kanal da push bildirimlerinizin yanı sıra aynı OneSignal dashboard’undan yönetilebilir.
Önbellek Sorunları: WordPress önbelleği geçiş değişikliklerini geciktirebilir.Çözüm:
  1. Web sitenize sağ tıklayın ve İncele’yi seçin
  2. Ağ sekmesine gidin
  3. “Önbelleği devre dışı bırak“‘ı işaretleyin

Geçişten sonra güncellenmiş dosyaların yüklenmesini zorlamak için tarayıcı önbelleğini devre dışı bırakın

  1. Mevcut yapılandırmayı görmek için web sitenizi yenileyin
  2. Uygulanabilirse WordPress önbellek eklenti ayarlarınızı temizleyin
Bu hata tamamlanmamış geçişi gösterir:

Tarayıcı konsolundaki 404 hatası tamamlanmamış geçiş sürecini gösterir

Çözüm:
  1. OneSignal dashboard yapılandırmanızı kaydettiğinizden emin olun
  2. WordPress’te, eklenti ayarlarında “Geçiş Tamamlandı“‘ya tıklayın
  3. Yükseltmeyi tamamlamak için Ayarları Kaydet’e tıklayın
Bu hata yalnızca 2.x.x sürümünden yükseltme yapan kullanıcıları etkiler.
Evet, onesignal_send_notification filtresini kullanabilirsiniz.
Özel PHP kodunu wp-content/mu-plugins/onesignal-custom.php dosyasına yerleştirin. Bu, doğru yüklenmesini sağlar ve güncellemelerle üzerine yazılmasını önler.
<?php

add_filter('onesignal_send_notification', function($fields, $post_id) {

  // Create Notification API Referansında belirtilen herhangi bir özelliği dahil edin:
  // https://documentation.onesignal.com/reference/push-notification örneğin:

  // Eylem düğmeleri ekle
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Devamını Oku",
      "url" => get_permalink($post->ID)
    )

  // Değiştirilmiş fields dizisini döndür
  return $fields;

}, 10, 2);