Web push için OneSignal WordPress eklentisi kurulumu

​

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: Push bildirimlerini otomatik olarak göndermek için “Send notification when post is published” 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

​

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 256×256 PNG, JPG veya animasyonsuz GIF. Bildirim simgeleri sayfasına bakın.

​

İzin istemleri

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

1

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

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

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.

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

​

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

​

Service worker

importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");

​

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

​

Kurulumunuzu test etme

• 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

• “Send notification when post is published or updated” seçeneğini işaretleyin
• Bu gönderi için bildirim göndermeyi 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: news etiketi 1
   • Deals Segment: deals etiketi 1

3. Segmentleri oluşturduktan sonra, WordPress gönderi düzenleyicinizi yenileyin
4. Açılır menüden hedef segmentinizi 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

​

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

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

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:

Çö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) {

  // Add fields supported by the Create notification API:
  // https://documentation.onesignal.com/reference/create-notification

  $fields['web_buttons'] = array(
    array(
      'id' => 'read-more',
      'text' => 'Read More',
      'url' => get_permalink($post_id),
    ),
  );

  return $fields;

}, 10, 2);