Web SDK kurulumu - OneSignal

Kontrol panelini yapılandırarak, bir service worker yükleyerek ve JavaScript SDK’yı başlatarak sitenize OneSignal web push ekleyin. OneSignal; Chrome, Firefox, Edge, Safari ve diğer büyük tarayıcıları destekler. WordPress veya Shopify kullanıyorsanız, bu JavaScript SDK kılavuzu yerine platform entegrasyonunu takip edin. Daha derin özelleştirmeye, istemlere, init seçeneklerine ve kodda service worker yoluna ihtiyacınız varsa, Özel Kod’u kullanın.

WordPress kurulumu

Resmi OneSignal eklentisini kurun. Eklenti, SDK’yı ve service worker’ı sizin için ekler.

Shopify kurulumu

Shopify’ı Vendo entegrasyonu aracılığıyla bağlayın. Vendo, tema kodu düzenlemeleri olmadan SDK’yı mağazanıza dağıtır.

Özel Kod kurulumu

İstemleri, init seçeneklerini ve service worker yolunu OneSignal.init() içinde ayarlayın.

Siteniz Angular, React veya Vue ile oluşturulduysa, bu sayfadaki kod parçacığı yerine ilgili framework kılavuzunu kullanın.

Gereksinimler

HTTPS web sitesi: Web push, HTTP’de veya gizli/özel modlarda çalışmaz.
Sunucu erişimi: Sitenize bir service worker dosyası yüklemeniz gerekir.
Tek origin: Web push, Same-origin politikasını takip eder. Birden fazla origin’iniz varsa (alan adları/alt alan adları), birden fazla OneSignal uygulamasına ihtiyacınız olur (origin başına bir tane). Bu tarayıcı sınırlamasına uymak için şunlardan birini yapabilirsiniz:
- Abonelikler için trafiği tek bir origin’e yönlendirin.
- Birden fazla OneSignal uygulaması oluşturun, origin başına bir tane.

Ekibiniz OneSignal ile zaten bir hesap oluşturduysa, uygulamayı kurabilmeniz için admin rolü olarak davet edilmenizi isteyin. Aksi takdirde, başlamak için onesignal.com’da ücretsiz bir hesap açın.

OneSignal uygulamanızı ve platformunuzu yapılandırın

OneSignal kontrol panelinde:

Settings > Push & In-App > Web’e gidin.

OneSignal kontrol paneli Ayarlar sayfasında Web platformu etkinleştirmesi — OneSignal ayarlarınızda web platformunu etkinleştirin

Entegrasyon türünü seçin:

Tipik Site (önerilir)

Ek kodlama olmadan istemleri ve ayarları doğrudan OneSignal kontrol panelinden yönetin.

WordPress

Resmi eklentimizle WordPress kullanıyorsanız gereklidir.

Özel Kod

İstemler ve SDK yapılandırması üzerinde tam kontrol gerektiren geliştiriciler için.

Site kurulumu

Site ayrıntılarını ekleyin:

Site Name: Sitenizin adı ve varsayılan bildirim başlığı.
Site URL: Sitenizin URL’si. Daha fazla ayrıntı için Site URL bölümüne bakın.
Auto Resubscribe: Tarayıcı verilerini temizleyen kullanıcıları sitenize döndüklerinde otomatik olarak yeniden abone etmek için bunu etkinleştirin (yeni izin istemi gerekmez).
Default Icon URL: Bildirimlerde ve istemlerde görünen kare 256×256 PNG, JPG veya animasyonsuz GIF yükleyin. Ayarlanmazsa, varsayılan olarak bir zil simgesi kullanılır. Bildirim simgeleri sayfasına bakın.

Kullanıcılar tarayıcı verilerini temizlerse, sitenize dönene kadar push almayı bırakırlar. Yeni bir izin istemi olmadan yeniden abone olmaları için Auto Resubscribe’ı etkinleştirin. Abonelikler sayfasına bakın.

OneSignal web push yapılandırması: site adı, URL ve ikon ayarları — OneSignal kontrol panelinde web ayarları

Site URL

Sitenizin tam origin’ini girin, örneğin https://yourdomain.com. Siteniz bu şekilde yapılandırılmamışsa www. kullanmaktan kaçının. Birden fazla origin’iniz varsa, Gereksinimler bölümüne bakın.

Yerel test

Web SDK, localhost ortamlarında test edilebilir. Localhost’ta test yapıyorsanız, üretim uygulamanızdan ayrı bir OneSignal uygulaması kullanın.

Localhost yapılandırması

SITE URL’yi localhost ortam URL’nizle tam olarak eşleşecek şekilde ayarlayın. URL, şu yaygın localhost formatlarından biriyle eşleşmelidir:

http://localhost
https://localhost:3000
http://127.0.0.1
https://127.0.0.1:5000

Localhost URL’niz HTTP kullanıyorsa, Treat HTTP localhost as HTTPS for testing seçeneğini seçin. Chrome, http://localhost ve http://127.0.0.1’i güvenli origin olarak değerlendirir, bu nedenle SDK yalnızca bu ana bilgisayarlarda HTTP üzerinden başlatılabilir. Diğer ana bilgisayar adları (örneğin http://mysite.local) güvenli olarak değerlendirilmez ve web push testi için kullanılamaz.

OneSignal localhost yapılandırması: Treat HTTP localhost as HTTPS seçeneği — OneSignal kontrol panelinde yerel test

Localhost’ta başlatırken OneSignal init seçeneklerinize allowLocalhostAsSecureOrigin: true ekleyin.Self-signed sertifika ile HTTPS üzerinde localhost’u test ediyorsanız, Chrome’dan test için geçersiz sertifikaları yok saymasını istemeniz gerekebilir: --allow-insecure-localhost. Firefox ve Safari, güvenlik sertifikaları için istisna eklemeye yönelik yerleşik mekanizmalar sağlar.

HTML

<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
<script>
  window.OneSignalDeferred = window.OneSignalDeferred || [];
  OneSignalDeferred.push(async function(OneSignal) {
    await OneSignal.init({
      appId: "YOUR_ONESIGNAL_APP_ID",
      allowLocalhostAsSecureOrigin: true,
    });
  });
</script>

İzin istemi

Tipik Site kurulumu, siz veya ekip üyelerinizin OneSignal kontrol panelinden istediğiniz zaman izin istemleri eklemesine, kaldırmasına ve güncellemesine olanak tanır.

Web izin istemleri

Tarayıcı izin iletişim kutusunun kullanıcılarınıza ne zaman ve nasıl görüneceğini yapılandırın.

Hoş geldin bildirimi (isteğe bağlı)

Kullanıcılar push bildirimlerine abone olduklarında onlara gönderilecek bir hoş geldin bildirimi de ayarlayabilirsiniz. Tipik Site ve WordPress bunu kontrol panelinde ayarlar. Özel Kod, welcomeNotification’ı OneSignal.init() içinde ayarlar. Bunu kontrol panelinde ayarlamak için Settings > Push & In-App > Web’e gidin:

Özel Kod kurulumları için, Web SDK referansındaki welcomeNotification parametrelerine bakın.

Gelişmiş ayarlar

Aşağıdaki özellikler OneSignal kontrol panelinde yapılandırılabilir.

Webhook’lar

Web SDK, belirli web push olaylarını seçtiğiniz bir URL’ye POST edebilir. Web Push Webhook’ları, Olay Webhook’larından ayrı bir implementasyondur ve birbirinin yerine kullanılamaz.

Web push webhook'ları

Web push olaylarını POST istekleri aracılığıyla sunucunuza gönderin.

Service worker’lar

Web SDK, ona farklı bir konum belirtmediğiniz sürece OneSignalSDKWorker.js dosyasını sitenizin kök dizininde (https://yourdomain.com/OneSignalSDKWorker.js) arar. SDK’ya kök dizin dışında bir konumu nasıl belirteceğiniz, seçtiğiniz entegrasyon türüne bağlıdır. Tipik Site: Yolu kontrol panelinde ayarlayın. Kodda serviceWorkerPath ayarlamayın. Dosyayı kök dizinde barındırıyorsanız, varsayılan yol ayarlarını olduğu gibi bırakın. Bir alt dizinde barındırıyorsanız, aşağıdaki yolu ayarlamanız gerekir; aksi takdirde SDK yine /OneSignalSDKWorker.js isteğinde bulunur ve kayıt başarısız olur.

Settings > Push & In-App > Web’e gidin.
Advanced Push Settings’i açın.
Customize service worker paths and filenames seçeneğini etkinleştirin.
Alanları, dosyanın herkese açık URL’siyle eşleşecek şekilde ayarlayın:

Alan	Ne girilmeli	Örnek
Path to service worker files	Dosyayı barındıracağınız dizin.	`/push/onesignal/`
Service worker filename	`.js` dosya adı. Kontrol paneli ayrıca bir güncelleyici dosya adı gösteriyorsa, her iki alanı da aynı dosyaya ayarlayın.	`OneSignalSDKWorker.js`
Service worker registration scope	Dosya konumuyla aynı yol.	`/push/onesignal/`

Service worker yolu, dosya adı ve kapsam yapılandırma alanları — Service worker yapılandırması

Yukarıdaki örnek değerlerle, dosyanın https://yourdomain.com/push/onesignal/OneSignalSDKWorker.js adresinde herkese açık olarak erişilebilir olması gerekir. Özel Kod: Kontrol paneli yol alanlarını kullanmayın. serviceWorkerPath ve serviceWorkerParam’ı OneSignal.init() içinde geçirin. Init seçenekleri için Özel Kod kurulumuna, worker’ları birleştirme ve geçiş için OneSignal service worker sayfasına bakın.

Tıklama davranışı

Tıklama davranışı, yalnızca kullanıcı sitenizi aynı origin’e sahip bir sekmede zaten açık tuttuğunda ne olacağını değiştirir. Eşleşen bir sekme açık değilse, tarayıcı bildirim URL’sine yeni bir sekme açar. Bu ayar bunu değiştirmez. Tıklama davranışı Chrome, Edge, Firefox ve Safari’de çalışır. Bir başlatma URL’si ayarlanmamışsa, bildirim URL’si ana sayfanızdır. Kullanıcıları belirli bir sayfaya göndermek, UTM izleme eklemek veya bir sayfa açmadan kapatmak için ?_osp=do_not_open eklemek üzere bir başlatma URL’si ayarlayın. Aynı origin’e sahip bir sekme zaten açıksa, davranış seçtiğiniz ayara bağlıdır:

Ayar	Eşleşme kriteri	Eylem
Exact Navigate (varsayılan)	Tam URL (örn. `example.com/product`)	Eşleşen sekmede bildirim URL’sine gider
Origin Navigate	Origin (örn. `example.com`)	Eşleşen sekmede bildirim URL’sine gider
Exact Focus	Tam URL	Eşleşen sekmeye yenilemeden odaklanır
Origin Focus	Origin	Eşleşen sekmeye yenilemeden odaklanır

URL'ler, bağlantılar ve derin bağlantı

Kullanıcıları belirli bir sayfaya yönlendirin, UTM izleme ekleyin veya bildirimi ?_osp=do_not_open ile kapatın.

Eylem düğmeleri

Kullanıcıların varsayılan tıklamayı kullanmadan bildirimden bir eylem gerçekleştirmesine izin verin.

Web SDK push olay dinleyicileri

Tıklama olaylarını dinleyin ve özel kodla uygulama içi davranış çalıştırın.

Kalıcılık

Kalıcılık, bildirimi kullanıcı onunla etkileşime girene kadar ekranda tutar. Yalnızca masaüstünde Chrome ve Edge’de çalışır. Firefox, Safari ve tüm mobil tarayıcılar bunu yok sayar. Kalıcı bir bildirim; metni, resimleri ve eylem düğmelerini sıkıştırabilir, bu nedenle kullanıcılarınız için sorun yaratıyorsa devre dışı bırakmak isteyebilirsiniz. Değer ayarlanmadığında, SDK şu anda kalıcılığı açık olarak değerlendirir.

Tipik Site: Settings > Push & In-App > Web bölümündeki Persistence anahtarını kullanın.
Özel Kod: persistNotification’ı OneSignal.init() içinde ayarlayın. Kontrol paneli anahtarı geçerli değildir. persistNotification sayfasına bakın.

Kalıcılık değişiklikleri yalnızca güncellemeden sonra sitenizi ziyaret eden aboneler için geçerli olur. Değişikliği görmüyorsanız, abonelerin sitenizi yeniden ziyaret etmesini bekleyin veya tarayıcı verilerini temizlemelerini isteyin.

Safari Web Push .p12 sertifikası (isteğe bağlı, eski yöntem)

Zaten kendi Safari Web Push .p12 sertifikanız yoksa ve eski Safari kullanıcılarını desteklemek istemiyorsanız, bunu kapalı bırakın. Modern Safari (macOS 13+ ve iOS 16.4+), VAPID (Voluntary Application Server Identification) ile standartlara dayalı Web Push kullanır. OneSignal, VAPID’i otomatik olarak yönetir. Bu tarayıcılar için sertifika yüklemezsiniz. Apple, Safari web push için bir .p8 token veya anahtarı sunmaz. Yerel iOS ve macOS uygulamaları, APNs ile kimlik doğrulamak için bir .p8 kullanır. Safari web push kullanmaz. Safari için geçerli olan tek Apple kimlik bilgisi bir Safari Web Push .p12 sertifikasıdır ve yalnızca eski Website Push ID yolu için geçerlidir. Bu eski yol hâlâ şunlar için geçerlidir:

macOS 12 ve önceki sürümlerdeki Safari (VAPID yok)
Eski Safari API’si üzerinden zaten izin vermiş mevcut aboneler (Safari bu abonelikleri VAPID’e taşımaz)

OneSignal, geriye kalan bu eski yol için hâlâ bir sertifika sağlayabilir. Müşteri tarafından sağlanan bir .p12, Safari 16.4+ (macOS 13+ veya iOS 16.4+) üzerindeki yeni aboneler için kullanılmaz. Bu abonelikler VAPID kullanır. Zaten kendi sertifikanız varsa, Settings > Push & In-App > Web > Advanced Push Settings bölümünde Safari Web Push .p12 certificate (optional, advanced) seçeneğini etkinleştirin. .p12 dosyasını ve şifresini yükleyin. Tipik Site ve Özel Kod’un her ikisi de bunu kontrol panelinde ayarlar. OneSignal.init() içinde ayarlamazsınız.

Advanced Push Settings'te Safari Web Push .p12 sertifikası yükleme anahtarı ve alanları — Safari Web Push .p12 sertifikası (isteğe bağlı, eski yöntem)

Service worker dosyasını yükleyin

OneSignalSDKWorker.js service worker dosyasını sitenize ekleyin. OneSignal kontrol panelinden indirin veya şu tek satırla OneSignalSDKWorker.js adında bir dosya oluşturun:

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

OneSignal service worker dosyası indirme ve kurulum adımı — Service worker dosyası yükleme adımı

Web SDK, aksini belirtmediğiniz sürece bu dosyayı sitenizin kök dizininde arar. Bu sayfa Tipik Site içindir, bu nedenle dosya konumunu kontrol panelinde eşleştirirsiniz. Özel Kod’u seçtiyseniz, yolu bunun yerine OneSignal.init() içinde ayarlayın. Özel Kod kurulumuna bakın. Kök dizin (varsayılan): Dosyayı https://yourdomain.com/OneSignalSDKWorker.js adresinde kullanılabilir olacak şekilde yükleyin. Service worker yol ayarlarını değiştirmeden bırakın. SDK bu URL’yi otomatik olarak ister. Alt dizin: Sitenizin zaten bir service worker’ı varsa (örneğin bir PWA), OneSignal’in dosyasını /push/onesignal/ gibi bir alt dizine koyun, böylece / yoluna sahip worker ile çakışmaz. Ardından SDK’ya nereye bakacağını belirtin: Service worker’lar bölümünü takip edin ve Customize service worker paths and filenames seçeneğini etkinleştirin. Path to service worker files ve Service worker registration scope alanlarını o alt dizine ayarlayın (örneğin /push/onesignal/). Dosya, https://yourdomain.com/push/onesignal/OneSignalSDKWorker.js adresinde herkese açık olarak erişilebilir olmalıdır.

Dosya site kök dizininde değilse ve bu kontrol paneli alanlarını ayarlamazsanız, SDK yine https://yourdomain.com/OneSignalSDKWorker.js adresini getirir ve service worker kaydı başarısız olur. Özel Kod kurulumları, bu kontrol paneli alanları yerine serviceWorkerPath’i OneSignal.init() içinde ayarlamalıdır.

Dosya sunucunuzda olduktan sonra, çalıştığından emin olmak için aşağıdakileri kontrol edin:

Konumu doğrulayın

SDK’nın kullanacak şekilde yapılandırıldığı URL’yi ziyaret edin. Varsayılan ayarları bıraktıysanız, bu URL site kök dizinidir. Yolu özelleştirdiyseniz, Path to service worker files artı dosya adıyla eşleşmelidir:

Varsayılan: https://yourdomain.com/OneSignalSDKWorker.js
Alt dizin örneği: https://yourdomain.com/push/onesignal/OneSignalSDKWorker.js

Origin'inizde herkese açık olarak erişilebilir olmalıdır

OneSignalSDKWorker.js dosyası herkese açık olarak erişilebilir olmalı ve origin’inizde mevcut olmalıdır. CDN aracılığıyla barındırılamaz veya yönlendirme ile farklı bir origin’e yerleştirilemez.Dosyanın URL’sini ziyaret ettiğinizde, kodu görmelisiniz.

content-type: application/javascript ile sunulmalıdır

Bu bir JavaScript dosyasıdır ve bu şekilde sunulmalıdır. text/html content-type’ına sahip olamaz.

OneSignal service worker

Gelişmiş yapılandırma ve diğer web push sağlayıcılarından geçiş.

Sitenize kod ekleyin

OneSignal’i JavaScript SDK ile sitenizde başlatmak için, sağlanan kodu web sitenizin <head> etiketlerine kopyalayın. OneSignal kontrol paneli, uygulama ID’niz önceden doldurulmuş olarak aynı kod parçacığını sağlar. Betikleri Google Tag Manager ile yüklüyorsanız, burada durun ve Google Tag Manager kurulumunu takip edin. Bu kılavuz, buradaki kontrol paneli ve service worker çalışmasını kullanır, ardından aşağıdaki kod parçacığını yapıştırmak yerine SDK’yı GTM’de başlatır.

HTML

<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
<script>
  window.OneSignalDeferred = window.OneSignalDeferred || [];
  OneSignalDeferred.push(async function(OneSignal) {
    await OneSignal.init({
      appId: "YOUR_ONESIGNAL_APP_ID",
    });
  });
</script>

iOS web push desteği

Apple, iOS 16.4+ çalıştıran iPhone ve iPad’lerde web push bildirimlerini desteklemeye başladı. Web push’un desteklenen bir tarayıcıda ek kurulum olmadan çalıştığı Android cihazların aksine, Apple bir manifest.json dosyası ve kullanıcının sitenizi Ana Ekranına eklemesi için bir kullanıcı eylemi gerektirir.

iOS web push kurulumu

Gerekli manifest.json dosyasını ekleyin ve kullanıcılara sitenizi ana ekranlarına eklemeleri için rehberlik edin.

OneSignal SDK entegrasyonunu test etme

Bu kılavuz, push bildirimleri ve abonelik kaydı test ederek OneSignal SDK entegrasyonunuzun düzgün çalıştığını doğrulamanıza yardımcı olur.

Web push aboneliklerini kontrol edin

Test cihazında sitenizi başlatın.

Test ederken Chrome, Firefox, Edge veya Safari kullanın.
Gizli veya özel tarama modunu kullanmayın. Kullanıcılar bu modlarda push bildirimlerine abone olamazlar.
İstemler izin istemleri yapılandırmanıza göre görünmelidir.
Push bildirimlerine abone olmak için yerel istemde İzin Ver’e tıklayın.

Kullanıcıya bildirimlere izin verip vermeyeceğini soran tarayıcı yerel izin istemi — Web push yerel izin istemi

OneSignal panonuzu kontrol edin

Kitle > Abonelikler’e gidin.
Abone durumuna sahip yeni bir girdi görmelisiniz.

Başarıyla bir web push aboneliği oluşturdunuz. Web push abonelikleri, kullanıcılar sitenizde push bildirimlerine ilk kez abone olduğunda oluşturulur.

Test aboneliklerini ayarlayın

Test abonelikleri, bir mesaj göndermeden önce push bildirimi test etmek için yararlıdır.

Test Aboneliklerine ekleyin.

Panoda, aboneliğin yanında Seçenekler (üç nokta) düğmesine tıklayın ve Test Aboneliklerine Ekle’yi seçin.

Test Aboneliklerine Ekle seçeneğini gösteren abonelikteki seçenekler menüsü — Test Aboneliklerine cihaz ekleme

Aboneliğinizi adlandırın.

Cihazınızı daha sonra Test Abonelikleri sekmesinde kolayca tanımlayabilmeniz için aboneliği adlandırın.

Test kullanıcıları segmenti oluşturun.

Kitle > Segmentler > Yeni Segment’e gidin.

Segmenti adlandırın.

Segmenti Test Users olarak adlandırın (ad önemlidir çünkü daha sonra kullanılacaktır).

Test Users filtresini ekleyin ve Create Segment'e tıklayın.

Test Users filtresi seçilmiş ve segment Test Users olarak adlandırılmış segment editörü — Test Users filtresi ile 'Test Users' segmenti oluşturma

Başarıyla test kullanıcıları segmenti oluşturdunuz. Artık bu bireysel cihaza ve test kullanıcı gruplarına mesaj göndermeyi test edebiliriz.

API aracılığıyla test push gönderin

Uygulama API Anahtarınızı ve Uygulama ID'nizi alın.

OneSignal panonuzda Ayarlar > Anahtarlar & ID’ler’e gidin.

Sağlanan kodu güncelleyin.

Aşağıdaki koddaki YOUR_APP_API_KEY ve YOUR_APP_ID değerlerini gerçek anahtarlarınızla değiştirin. Bu kod, daha önce oluşturduğumuz Test Users segmentini kullanır.

curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "chrome_web_image": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

Kodu çalıştırın.

Kodu terminalinizde çalıştırın.

Görselleri ve onaylanmış teslimatı kontrol edin.

Tüm kurulum adımları başarıyla tamamlandıysa, test abonelikleri bir bildirim almalıdır.

Yalnızca Chrome görselleri destekler. Görseller daraltılmış bildirim görünümünde küçük görünecektir. Tam görseli görmek için bildirimi genişletin.

macOS Chrome'da özel görsel gösteren genişletilmiş push bildirimi — Chrome macOS'ta görsel içeren genişletilmiş push bildirimi

Onaylanmış teslimatı kontrol edin.

Panonuzda Teslimat > Gönderilen Mesajlar’a gidin, ardından istatistikleri görüntülemek için mesaja tıklayın. Cihazın push’u aldığını gösteren onaylandı istatistiğini görmelisiniz.

Safari, Onaylanmış Teslimatı desteklemez.

Push bildirimi mesaj raporları

Push bildirimlerinizin teslimat, tıklama ve dönüşüm istatistiklerini görüntüleyin.

API aracılığıyla bir segmente başarıyla bildirim gönderdiniz.

Bildirimler ulaşmıyorsa, aşağıdaki bilgilerle support@onesignal.com ile iletişime geçin:

API isteği ve yanıtını bir .txt dosyasına kopyalayıp yapıştırın
Abonelik ID’niz
OneSignal koduyla web sitesi URL’niz

Kullanıcı tanımlama

Önceki bölümde web push Abonelikleri oluşturma ele alındı. Bu bölüm, OneSignal SDK’yı kullanarak tüm abonelikler (push, e-posta ve SMS dahil) üzerinden Kullanıcıları tanımlamaya genişler. Kullanıcıları platformlar arasında birleştirmenize ve etkileşime geçirmenize yardımcı olmak için Harici ID’ler, etiketler, çok kanallı abonelikler, gizlilik ve etkinlik izleme konularını kapsar.

Harici ID ata

Arka ucunuzun kullanıcı tanımlayıcısını kullanarak kullanıcıları cihazlar, e-posta adresleri ve telefon numaraları arasında tutarlı bir şekilde tanımlamak için Harici ID kullanın. Bu, mesajlaşmanızın kanallar ve 3. taraf sistemler arasında birleşik kalmasını sağlar (özellikle Entegrasyonlar için önemlidir). SDK’nın login metodu ile uygulamanız her kullanıcıyı tanımladığında Harici ID’yi ayarlayın.

OneSignal, abonelikler (Abonelik ID) ve kullanıcılar (OneSignal ID) için benzersiz salt okunur ID’ler oluşturur.Kullanıcılar uygulamanızı farklı cihazlara indirdikçe, web sitenize abone oldukça ve/veya uygulamanızın dışında size e-posta adresleri ve telefon numaraları sağladıkça yeni abonelikler oluşturulacaktır.Nasıl oluşturulduklarına bakılmaksızın kullanıcıları tüm abonelikleri üzerinden tanımlamak için SDK aracılığıyla Harici ID’yi ayarlamak şiddetle önerilir.

Veri etiketleri ekleyin

Etiketler, kullanıcı özelliklerini (username, role veya tercihler gibi) ve etkinlikleri (purchase_date, game_level veya kullanıcı etkileşimleri gibi) depolamak için kullanabileceğiniz anahtar-değer çiftleri dizgisi verisidir. Etiketler, daha gelişmiş kullanım durumlarına olanak tanıyan gelişmiş Mesaj Kişiselleştirme ve Segmentasyonu destekler. Uygulamanızda etkinlikler gerçekleştikçe SDK’nın addTag ve addTags metotları ile etiketleri ayarlayın. Bu örnekte, kullanıcı current_level adlı etiket tarafından 6 değerine ayarlanarak tanımlanabilen 6. seviyeye ulaştı.

OneSignal'da "current_level" adlı etiketi "6" olarak ayarlanmış bir kullanıcı profili

5 ile 10 arasında seviyeye sahip kullanıcılardan oluşan bir segment oluşturabilir ve bunu hedefli ve kişiselleştirilmiş mesajlar göndermek için kullanabiliriz:

4'ten büyük ve 10'dan küçük current_level değerine sahip kullanıcıları hedefleyen bir segmenti gösteren segment editörü

Kişiselleştirilmiş mesajla Seviye 5-10 segmentini hedefleyen bir push bildirimini gösteren ekran görüntüsü

E-posta ve/veya SMS abonelikleri ekleyin

OneSignal SDK, kullanıcılar kabul ettiğinde otomatik olarak web push abonelikleri oluşturur. İlgili abonelikleri oluşturarak kullanıcılara e-posta ve SMS kanalları aracılığıyla da ulaşabilirsiniz.

E-posta abonelikleri oluşturmak için addEmail metodunu kullanın.
SMS abonelikleri oluşturmak için addSms metodunu kullanın.

E-posta adresi ve/veya telefon numarası OneSignal uygulamasında zaten mevcutsa, SDK bunu mevcut kullanıcıya ekleyecektir, kopyalar oluşturmayacaktır. Birleştirilmiş kullanıcıları panoda Kitle > Kullanıcılar aracılığıyla veya Kullanıcıyı görüntüle API’si ile görüntüleyebilirsiniz.

Harici ID tarafından birleştirilmiş push, e-posta ve SMS aboneliklerine sahip bir kullanıcı profili

Çok kanallı iletişim için en iyi uygulamalar

E-posta veya SMS abonelikleri eklemeden önce açık onay alın.
Kullanıcılara her iletişim kanalının faydalarını açıklayın.
Kullanıcıların hangi kanalları tercih ettiklerini seçebilmeleri için kanal tercihleri sağlayın.

Gizlilik ve kullanıcı onayı

OneSignal’ın kullanıcı verilerini ne zaman topladığını kontrol etmek için SDK’nın onay kapısı metotlarını kullanın:

setConsentRequired(true): Onay verilene kadar veri toplamayı engeller.
setConsentGiven(true): Onay verildiğinde veri toplamayı etkinleştirir.

Gizlilik ve güvenlik hakkında daha fazla bilgi için:

SDK tarafından toplanan veriler

OneSignal SDK’nın kullanıcılardan topladığı verileri inceleyin.

Kişisel verilerin işlenmesi

Gizlilik düzenlemelerine uygun olarak kullanıcı verilerini yönetin ve koruyun.

Push, kullanıcı ve uygulama içi etkinlikleri dinleyin

Kullanıcı eylemlerine ve durum değişikliklerine tepki vermek için SDK dinleyicilerini kullanın. SDK, bağlanabileceğiniz birkaç etkinlik dinleyicisi sağlar. Daha fazla ayrıntı için SDK referans kılavuzumuza bakın.

Push bildirimi etkinlikleri

Tıklama etkinliği dinleyicisi: Bir bildirimin ne zaman dokunulduğunu tespit edin.
Ön plan yaşam döngüsü dinleyicisi: Bildirimlerin ön planda nasıl davrandığını kontrol edin.

Kullanıcı durumu değişiklikleri

Kullanıcı durumu değişiklik etkinliği dinleyicisi: Harici ID’nin ne zaman ayarlandığını tespit edin.
İzin gözlemcisi: Kullanıcının yerel push izin istemi ile belirli etkileşimini izleyin.
Push aboneliği değişiklik gözlemcisi: Push abonelik durumunun ne zaman değiştiğini izleyin.

Gelişmiş kurulum ve yetenekler

Entegrasyonunuzu geliştirmek için daha fazla yeteneği keşfedin:

OneSignal'a Geçiş

Başka bir push sağlayıcısından OneSignal’a geçin.

Entegrasyonlar

OneSignal’ı üçüncü taraf araçlar ve platformlarla bağlayın.

Eylem düğmeleri

Push bildirimlerine etkileşimli düğmeler ekleyin.

Çok dilli mesajlaşma

Kullanıcılara tercih ettikleri dilde yerelleştirilmiş mesajlar gönderin.

Kimlik Doğrulama

Sunucu tarafı Kimlik Doğrulama ile SDK entegrasyonunuzu güvenli hale getirin.

Özel Sonuçlar

Mesajlarınıza bağlı özel dönüşüm olaylarını izleyin.

Web SDK kurulumu ve referansı

Web push kurulumu

Entegrasyonunuz için tüm temel web push özelliklerini etkinleştirin.

Web SDK referansı

Mevcut metotlar ve yapılandırma seçenekleri hakkında tam ayrıntılar.

Tebrikler! Web SDK kurulum kılavuzunu başarıyla tamamladınız.

SSS

Web push HTTP sitelerinde çalışır mı?

Hayır. Web push HTTPS gerektirir. Tarayıcılar bunu bir güvenlik gereksinimi olarak uygular. Tek istisna, tarayıcıların geliştirme amacıyla güvenli origin olarak değerlendirdiği localhost ve 127.0.0.1’dir.

Neden service worker dosyasına ihtiyacım var?

Service worker arka planda çalışır ve kullanıcının siteniz açık olmadığında bile gelen push bildirimlerini işler. O olmadan, tarayıcı bildirimleri görüntüleyemez. OneSignalSDKWorker.js dosyası origin’inizde herkese açık olarak erişilebilir olmalıdır.

Web SDK, service worker’ı nerede arar?

Web SDK, özel bir yol ayarlamadığınız sürece OneSignalSDKWorker.js dosyasını sitenizin kök dizininde (https://yourdomain.com/OneSignalSDKWorker.js) arar. Tipik Site yolu kontrol panelinde ayarlar: Settings > Push & In-App > Web > Advanced Push Settings altında Customize service worker paths and filenames seçeneğini etkinleştirin. Özel Kod bu kontrol paneli alanlarını kullanmaz. serviceWorkerPath ve serviceWorkerParam’ı OneSignal.init() içinde geçirin. Özel Kod kurulumuna bakın.

Sitem WordPress veya Shopify’daysa bu kılavuzu kullanmalı mıyım?

Hayır. WordPress kurulumunu veya Shopify kurulumunu kullanın. Bu entegrasyonlar, SDK’yı ve service worker’ı sizin için ekler.

Tipik Site ile Özel Kod arasındaki fark nedir?

Tipik Site, bu sayfada önerilen yoldur: istemleri, ayarların çoğunu ve service worker yolunu OneSignal kontrol panelinde yapılandırır, ardından JavaScript kod parçacığını eklersiniz. Özel Kod, programatik kontrol içindir. İstemleri, init seçeneklerini ve service worker yolunu serviceWorkerPath ve serviceWorkerParam ile kodda ayarlarsınız. Özel Kod kurulumuna bakın.

Bir Safari sertifikası yüklemem gerekiyor mu?

Hayır, macOS 13+ veya iOS 16.4+ üzerindeki Safari için gerekmez. OneSignal, VAPID’i otomatik olarak kullanır. Bir Safari Web Push .p12’yi yalnızca eski Website Push ID yolu için yükleyin (macOS 12 ve önceki sürümler ile mevcut eski aboneler). Safari Web Push .p12 sertifikası bölümüne bakın.

Safari web push için bir .p8 anahtarı kullanabilir miyim?

Hayır. Apple, Safari web push için bir .p8 token veya anahtarı sunmaz. Bir .p8’i yalnızca yerel iOS veya macOS uygulamaları için kullanın. iOS p8 token tabanlı APNs bağlantısı sayfasına bakın. Tek Safari kimlik bilgisi bir Safari Web Push .p12’dir ve yalnızca eski yol için geçerlidir.

iOS’ta (iPhone/iPad) web push kullanabilir miyim?

Evet, iOS 16.4+ ile başlayarak. Ancak Apple bir manifest.json dosyası gerektirmekte ve kullanıcının önce sitenizi ana ekranına eklemesi gerekmektedir. Tam gereksinimler için iOS web push kurulumuna bakın. iOS web push, VAPID kullanır. Bunun için bir Safari .p12 veya .p8 yüklemezsiniz.

Bildirimlerim neden görünmüyor?

Yaygın nedenler arasında yanlış yerleştirilmiş service worker dosyası, kontrol panelinde eşleşmeyen Site URL’si veya kullanıcının tarayıcı ayarlarında bildirimleri engellemiş olması yer alır. Tam sorun giderme kontrol listesi için Web push: Bildirimler gösterilmiyor sayfasına bakın.

Yardıma mı ihtiyacınız var?Destek ekibimizle sohbet edin veya support@onesignal.com adresine e-posta gönderinLütfen şunları ekleyin:

Yaşadığınız sorunun ayrıntıları ve varsa yeniden üretme adımları
OneSignal Uygulama Kimliğiniz
Varsa Harici ID veya Abonelik ID
Varsa OneSignal Panosunda test ettiğiniz mesajın URL’si
İlgili günlükler veya hata mesajları

Size yardımcı olmaktan mutluluk duyarız!

WordPress kurulumu

Shopify kurulumu

Özel Kod kurulumu

​Gereksinimler

​OneSignal uygulamanızı ve platformunuzu yapılandırın

Tipik Site (önerilir)

WordPress

Özel Kod

​Site kurulumu

​Site URL

​Yerel test

​İzin istemi

Web izin istemleri

​Hoş geldin bildirimi (isteğe bağlı)

​Gelişmiş ayarlar

​Webhook’lar

Web push webhook'ları

​Service worker’lar

​Tıklama davranışı

URL'ler, bağlantılar ve derin bağlantı

Eylem düğmeleri

Web SDK push olay dinleyicileri

​Kalıcılık

​Safari Web Push .p12 sertifikası (isteğe bağlı, eski yöntem)

​Service worker dosyasını yükleyin

OneSignal service worker

​Sitenize kod ekleyin

​iOS web push desteği

iOS web push kurulumu

​OneSignal SDK entegrasyonunu test etme

​Web push aboneliklerini kontrol edin

​Test aboneliklerini ayarlayın

​API aracılığıyla test push gönderin

Push bildirimi mesaj raporları

​Kullanıcı tanımlama

​Harici ID ata

​Veri etiketleri ekleyin

​E-posta ve/veya SMS abonelikleri ekleyin

​Gizlilik ve kullanıcı onayı

SDK tarafından toplanan veriler

Kişisel verilerin işlenmesi

​Push, kullanıcı ve uygulama içi etkinlikleri dinleyin

​Push bildirimi etkinlikleri

​Kullanıcı durumu değişiklikleri

​Gelişmiş kurulum ve yetenekler

OneSignal'a Geçiş

Entegrasyonlar

Eylem düğmeleri

Çok dilli mesajlaşma

Kimlik Doğrulama

Özel Sonuçlar

​Web SDK kurulumu ve referansı

Web push kurulumu

Web SDK referansı

​SSS

​Web push HTTP sitelerinde çalışır mı?

​Neden service worker dosyasına ihtiyacım var?

​Web SDK, service worker’ı nerede arar?

​Sitem WordPress veya Shopify’daysa bu kılavuzu kullanmalı mıyım?

​Tipik Site ile Özel Kod arasındaki fark nedir?

​Bir Safari sertifikası yüklemem gerekiyor mu?

​Safari web push için bir .p8 anahtarı kullanabilir miyim?

​iOS’ta (iPhone/iPad) web push kullanabilir miyim?

​Bildirimlerim neden görünmüyor?

Gereksinimler

OneSignal uygulamanızı ve platformunuzu yapılandırın

Site kurulumu

Site URL

Yerel test

İzin istemi

Hoş geldin bildirimi (isteğe bağlı)

Gelişmiş ayarlar

Webhook’lar

Service worker’lar

Tıklama davranışı

Kalıcılık

Safari Web Push .p12 sertifikası (isteğe bağlı, eski yöntem)

Service worker dosyasını yükleyin

Sitenize kod ekleyin

iOS web push desteği

OneSignal SDK entegrasyonunu test etme

Web push aboneliklerini kontrol edin

Test aboneliklerini ayarlayın

API aracılığıyla test push gönderin

Kullanıcı tanımlama

Harici ID ata

Veri etiketleri ekleyin

E-posta ve/veya SMS abonelikleri ekleyin

Gizlilik ve kullanıcı onayı

Push, kullanıcı ve uygulama içi etkinlikleri dinleyin

Push bildirimi etkinlikleri

Kullanıcı durumu değişiklikleri

Gelişmiş kurulum ve yetenekler

Web SDK kurulumu ve referansı

SSS

Web push HTTP sitelerinde çalışır mı?

Neden service worker dosyasına ihtiyacım var?

Web SDK, service worker’ı nerede arar?

Sitem WordPress veya Shopify’daysa bu kılavuzu kullanmalı mıyım?

Tipik Site ile Özel Kod arasındaki fark nedir?

Bir Safari sertifikası yüklemem gerekiyor mu?

Safari web push için bir .p8 anahtarı kullanabilir miyim?

iOS’ta (iPhone/iPad) web push kullanabilir miyim?

Bildirimlerim neden görünmüyor?