WordPress

​

Genel Bakış

​

Sürüm 3+‘daki Yenilikler

• 🚀 SDK Yükseltmesi: OneSignal Web SDK’yı sürüm 15’ten 16’ya günceller
• 💬 Kontrol Paneli İstemleri: Tüm izin istemlerini doğrudan OneSignal kontrol panelinden yapılandırın—özel kod gerekmez
• ⏩ Tek Tık Yayınlama: Gönderi yayınlandığında push bildirimleri otomatik olarak göndermek için “Gönderi yayınlandığında bildirim gönder” seçeneğini işaretleyin
• 🧑‍🤝‍🧑 Hedef Kitle Belirleme: Her gönderi için hangi segmentlerin bildirim alacağını seçin
• 📲 Mobil Uygulama Entegrasyonu: İsteğe bağlı derin bağlantı ile mobil uygulama abonelerine gönderin

​

Kurulum

• 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 Kontrol Panelinde WordPress’i Yapılandırın

OneSignal kontrol panelinizde Website Builder seçeneklerinden WordPress'i seçin

​

Site kurulumu

• Site Name: Sitenizin adı ve varsayılan bildirim başlığı.
• Site URL: WordPress sitenizin tam URL’si ile eşleşmelidir (Aynı-kaynak politikasına uyun)
• Auto Resubscribe: Tarayıcı verilerini temizleyen kullanıcıları sitenize geri döndüklerinde otomatik olarak yeniden abone etmek için bunu etkinleştirin (yeni izin istemi gerekmez)
• Default Icon URL: 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 ile https://www.your-site.com farklıdır—yalnızca bir formatı tutarlı şekilde kullanın

​

İzin istemleri

• Temel İstem Kurulumu
• Gelişmiş: Kategori Tabanlı Segmentasyon

1

Özelleştirmek için Push Slide Prompt'a tıklayın

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

2

Zamanlama ve metni yapılandırın:

• İlk test için Auto Prompt’u 1 sayfa görüntüleme ve 1 saniyeye ayarlayın
  • İstem metnini ve görünümünü özelleştirin
  • Yayınlandıktan sonra 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 Done'a tıklayın.

Kullanıcı ilgi alanlarına dayalı hedefli mesajlaşma için kategorileri ayarlayın:

1

İstem ayarlarınızda Categories'i seçin

2

Her kategoriyi şunlarla yapılandırın:

• Label: Kullanıcıların istemde gördüğü metin
• Tag Key: Segmentasyon için dahili etiket anahtarı

3

İstemi yapılandırmayı bitirdiğinizde Done'a tıklayın.

Örnek: News ve Deals kategorilerini ayarlamak, bu seçenekleri işaretleyen kullanıcılar için 'news: 1' ve 'deals: 1' etiketleri oluşturur

Etiket Mantığı: İşaretli kategoriler etiket değerini 1, işaretlenmeyenler 0 olarak ayarlar. Bu etiketler, belirli kullanıcı ilgi alanlarına hedefli mesajlaşmayı sağlar.

​

Hoş geldin bildirimi

• 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

​

2. WordPress eklentisini yapılandırın

OneSignal kontrol panelinden App ID ve API Key'inizi kopyalayın

WordPress eklentinizin App ID ve REST API Key değerlerinin OneSignal kontrol panelinizle tam olarak eşleştiğinden emin olun

​

Gelişmiş ayarlar

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

utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin

utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots

• Custom Post Types: Bildirim seçeneklerini etkinleştirmek için eklentilerden gönderi türleri ekleyin
• Automatically send notifications when a post is published: Gönderiler yayınlandığında kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimlerin gönderilmesi için bildirim kutusunu otomatik olarak işaretler
• Automatically send notifications when a post is updated: Gönderiler güncellendiğinde kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimlerin gönderilmesi için bildirim kutusunu otomatik olarak işaretler
• Automatically send notifications when a page is published: Sayfalar yayınlandığında kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimlerin gönderilmesi için bildirim kutusunu otomatik olarak işaretler
• Automatically send notifications when a page is updated: Sayfalar güncellendiğinde kutuyu manuel olarak işaretlemek zorunda kalmadan bildirimlerin gönderilmesi için bildirim kutusunu otomatik olarak işaretler
• Automatically send a push notification when I publish a post from 3rd party plugins: Harici yayınlama eklentilerinden otomatik bildirim gönderme
• Mobile App Integration: Aynı OneSignal App ID’yi kullanarak mobil uygulama abonelerinize bildirim gönderin

​

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

Eklenti yükseltmenizi sonlandırmak için Migration Completed'a tıklayın

​

Kurulumunuzu test etme

• İlk Test
• Aboneliği Doğrulama
• 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ırdığınız slidedown istemi, zamanlama ayarlarınıza göre görünmelidir

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

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

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

Hoş geldin bildirimi başarılı abonelikten hemen sonra görünür

1. OneSignal kontrol panelinizde, Audience > Subscriptions bölümüne gidin 2. Web push aboneliğinizi “Subscribed” olarak işaretlenmiş görmelisiniz

Başarılı abonelikler OneSignal kontrol paneli kitlenizde görünür

1. OneSignal kontrol panelinizde Messages > Push bölümüne gidin 2. New Message oluşturun 3. Kendinize bir test bildirimi gönderin 4. Bildirimin doğru şekilde göründüğünü doğrulayın Detaylı talimatlar için Push mesajlaşma kılavuzumuza bakın.

• Gelişmiş özelleştirme için Web izin istemlerini inceleyin
• Email ve SMS entegrasyonu için Kanal kurulumunu keşfedin
• Hedefli mesajlaşma için segmentasyon stratejilerini ayarlayın

​

Bildirim yayınlama

​

Temel gönderi bildirimleri

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

• “Send notification when post is published or updated” seçeneğini işaretleyin
• Bu gönderi için bildirim göndermemeyi atlamak için işareti kaldırın

​

Hedef kitle belirleme

​

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

​

Belirli segmentlere gönder

1. OneSignal kontrol panelinizde Audience > Segments bölümüne gidin
2. Etiket anahtarlarınızı kullanarak segmentler oluşturun, örneğin:
   • News Segment: Tag news is 1
   • Deals Segment: Tag deals is 1

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

3. Segmentleri oluşturduktan sonra, WordPress gönderi düzenleyicinizi yenileyin
4. Açılır menüden hedef segmentinizi seçin

İlgili kullanıcı gruplarını hedeflemek için belirli segmentleri seçin

​

Bildirim içeriğini özelleştirme

​

Varsayılan davranış

• Title: WordPress site başlığınızı kullanır (Settings > General)
• Message: Gönderi başlığını kullanır
• Image: Gönderinin öne çıkan görselini kullanır (ayarlanmışsa)
• URL: Yayınlanan gönderiye bağlantı verir

​

Özel içerik

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

Özelleştirilmiş push bildirimi kullanıcılara göründüğü şekilde

​

OneSignal WordPress Eklentisine Özel Gönderi Türü Ekleme

​

Özel gönderi türü adınızı bulun

https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type

​

OneSignal ayarlarına ekleyin

1. WordPress yöneticisinde OneSignal > Settings bölümüne gidin
2. Advanced Settings bölümünde, özel gönderi türü adlarınızı Custom Post Types alanına ekleyin
3. Ayarları kaydedin

​

Mobil uygulama entegrasyonu

1. Eklenti ayarlarında “Send notification to Mobile app subscribers” seçeneğini etkinleştirin
2. Gönderi metabox’ında, derin bağlantı için bir Mobile URL ekleyin
3. Mobil kullanıcılar web tarayıcısı yerine uygulamanıza yönlendirilecektir

​

SSS

Belirli sayfalarda istemleri nasıl devre dışı bırakırım?

Not: Bu yöntem yalnızca slidedown ve native izin istemleriyle çalışır, bell veya özel bağlantı istemleriyle çalışmaz.

1. OneSignal kontrol panelinizde, Settings > Push & In-App > Web Settings bölümüne gidin
2. Permission Prompt Setup tablosundan isteminizi seçin
3. Auto Prompt işaretini kaldırın ve Done’a tıklayın

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

4. Aşağı kaydırın, Save’e, ardından Finish’e tıklayın
5. İ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 istemleri sayfasına bakın.

Geçişten sonra istemlerim neden çalışmıyor?

Önbellek Sorunları: WordPress önbelleği geçiş değişikliklerini geciktirebilir.Çözüm:Adım 1: Web sitenizde sağ tıklayın ve Inspect’i seçinAdım 2: Network sekmesine gidinAdım 3: “Disable cache” seçeneğini işaretleyin

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

Adım 4: Mevcut yapılandırmayı görmek için web sitenizi yenileyinAdım 5: Varsa WordPress önbellek eklenti ayarlarınızı temizleyin

`A bad HTTP response code (404)` hatası ne anlama gelir?

Bu hata tamamlanmamış geçişi gösterir:

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

Çözüm:

1. OneSignal kontrol paneli yapılandırmanızı kaydettiğinizden emin olun
2. WordPress’te, eklenti ayarlarında “Migration Completed“‘a tıklayın
3. Yükseltmeyi sonlandırmak için Save Settings’e tıklayın

Bu hata yalnızca sürüm 2.x.x’ten yükseltme yapan kullanıcıları etkiler.

<?php

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

  // Create Notification API Reference'ta belirtilen tüm özellikleri dahil edin:
  // https://documentation.onesignal.com/reference/push-notification örneğin:

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

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

}, 10, 2);