​

Windows Uygulama Kurulumu

​

Gereksinimler

• Universal Windows Platform (UWP) Uygulaması - OneSignal şu anda yalnızca UWP uygulamalarını destekler
• Microsoft Store Uygulama Kaydı - Package SID ve Secret Key almak için gereklidir
• OneSignal Hesabı - Yapılandırılmış uygulama ve platform ayarlarına sahip ücretsiz hesap

​

OneSignal Uygulamanızı ve Platformunuzu Yapılandırın

​

Adım 1: OneSignal Hesabınızı Kurun

​

Adım 2: OneSignal Uygulamanızı Oluşturun veya Yapılandırın

​

Yeni Uygulama Oluştur

1. Kontrol panelinizden Yeni Uygulama/Web Sitesi’ne tıklayın
2. Tanınabilir bir uygulama adı ve organizasyon adı seçin
3. Platformunuz olarak Windows (UWP)‘yi seçin
4. İleri: Platformunuzu Yapılandırın’a tıklayın

Windows platformuyla yeni bir OneSignal uygulaması oluşturma

​

Mevcut Uygulamaya Platform Ekle

1. Mevcut uygulamanızı seçin
2. Ayarlar > Push & In-App’e gidin
3. Platform Ekle’ye tıklayın ve Windows (UWP)‘yi seçin

OneSignal uygulamanızı kurma ve Windows platformunu seçme

​

Adım 3: Ek Platformları Yapılandırın (İsteğe Bağlı)

• Android: Firebase Kimlik Bilgilerini Kurun
• iOS: p8 Token (Önerilir) veya p12 Sertifika
• Amazon: API Key Oluşturun
• Huawei: OneSignal’i Yetkilendirin

​

Adım 4: Hedef SDK’yı Seçin

Platforma özel belgelere erişmek için Windows UWP SDK'yı seçin

​

Adım 5: Uygulama ID’nizi Kaydedin

Uygulama ID'nizi kaydedin ve erişime ihtiyacı olan ekip üyelerini davet edin

​

Windows Platform Yapılandırması

​

Microsoft Store Kimlik Bilgilerini Alın

1. Microsoft Store’da Yayınlayın - Uygulamanız Microsoft Store’da kayıtlı olmalıdır (herkese açık olmasa bile)
2. Package SID ve Secret Key’i Alın - Bu kimlik bilgilerini almak için Microsoft’un ayrıntılı kılavuzunu takip edin
3. OneSignal Platformunu Yapılandırın:
   • OneSignal kontrol panelinizde Ayarlar > Windows (UWP)‘ye gidin
   • Package SID ve Secret Key’inizi yapıştırın
   • Platformu etkinleştirmek için Kaydet’e tıklayın

OneSignal kontrol panelinde Windows platform kimlik bilgilerini yapılandırın

Dikkat: Package SID ve Secret Key yalnızca uygulamanız Microsoft Store’a kaydedildikten sonra kullanılabilir. Bu kimlik bilgileri olmadan push bildirimlerini yerel olarak test edemezsiniz.

​

SDK Entegrasyonu

​

Mimariyi Anlama

1. Windows Push Notification Service (WNS) - Microsoft’un yerel push hizmeti
2. OneSignal REST API - Kullanıcı yönetimi ve mesaj gönderme için
3. Notification Channel URI - Push bildirimleri için cihaz token’ı olarak işlev görür

​

Push Bildirimleri için Kullanıcıları Kaydetme

​

Adım 1: Bildirim Kanalı İsteyin

// Örnek: Bildirim kanalı URI'sini alma
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
string channelUri = channel.Uri; // Bu, OneSignal için token'ınızdır

​

Adım 2: OneSignal Kullanıcı Kaydı Oluşturun

• subscription.type: "WindowsPush"
• subscription.token: Adım 1’den kanal URI’si

• identity.external_id: Kullanıcı için benzersiz tanımlayıcı (örneğin, sisteminizden kullanıcı ID’si)
• properties: Hedefleme için özel kullanıcı özellikleri

{
  "identity": {
    "external_id": "your-user-id-123"
  },
  "subscriptions": [
    {
      "type": "WindowsPush",
      "token": "https://cloud.notify.windows.com/?token=..."
    }
  ],
  "properties": {
    "tags": {
      "user_type": "premium",
      "app_version": "1.2.0"
    }
  }
}

Dikkat: Kanal URI’leri sona erebilir ve değişebilir. Kanal URI’sini periyodik olarak yenilemek ve değiştiğinde OneSignal kullanıcı kaydını güncellemek için mantık uygulayın.

​

Kanal URI Değişikliklerini Yönetme

channel.PushNotificationReceived += OnPushNotificationReceived;

// Kanal URI'sinin değişip değişmediğini kontrol et
if (channel.Uri != storedChannelUri) {
    // OneSignal kullanıcı kaydını yeni URI ile güncelle
    await UpdateOneSignalUser(channel.Uri);
}

​

Push Bildirimleri Gönderme

​

OneSignal Kontrol Panelini Kullanma

1. OneSignal kontrol panelinizde Mesajlar > Push’a gidin
2. Yeni bir push bildirimi oluşturun
3. Windows platformunuzu seçin
4. Mesaj içeriğinizi ve hedeflemenizi yapılandırın
5. Hemen gönderin veya daha sonrası için planlayın

​

OneSignal API’sini Kullanma

{
  "app_id": "your-onesignal-app-id",
  "contents": {"en": "Your notification message"},
  "headings": {"en": "Notification Title"},
  "include_external_user_ids": ["your-user-id-123"],
  "channel_for_external_user_ids": "push"
}

​

Sonraki Adımlar ve En İyi Uygulamalar

​

Entegrasyonunuzu Test Etme

1. Bildirim Kanalı Oluşturmayı Test Edin - Uygulamanızın başarıyla bir WNS kanalı oluşturduğundan ve sürdürdüğünden emin olun
2. Kullanıcı Kaydını Doğrulayın - Kullanıcıların OneSignal kontrol panelinizde düzgün şekilde kayıtlı olduğunu onaylayın
3. Test Bildirimleri Gönderin - Test mesajları göndermek için OneSignal kontrol panelini kullanın
4. Bildirim Olaylarını Yönetin - Bildirim alınan, açılan ve kapatılan olaylar için uygun yönetim uygulayın

​

Yaygın Sorunlar ve Çözümler

• Package SID ve Secret Key’inizin doğru yapılandırıldığını doğrulayın
• Uygulamanızın Microsoft Store’a düzgün şekilde kayıtlı olduğundan emin olun
• Kanal URI’sinin süresi dolmamış olduğunu kontrol edin

• OneSignal kullanıcı kaydının başarıyla oluşturulduğunu onaylayın
• Windows platformunun OneSignal’de düzgün yapılandırıldığını doğrulayın
• Bildirimlerin Windows bildirim ayarları tarafından engellenmediğini kontrol edin

• OneSignal Uygulama ID’nizin doğru olduğunu doğrulayın
• Doğru API endpoint’lerini ve kimlik doğrulamasını kullandığınızdan emin olun
• Sorun giderme için API yanıt kodlarını ve hata mesajlarını inceleyin

​

Üretim Hususları

• Tüm OneSignal API çağrıları için uygun hata yönetimi uygulayın
• Kanal URI yenileme hataları için izleme kurun
• Ağ sorunları sırasında API çağrıları için çevrimdışı kuyruk uygulamayı düşünün
• Yoğun uygulama kullanım dönemlerinde kullanıcı kaydını ölçeklendirmek için planlama yapın