Unity SDK kurulumu

​

Genel Bakış

​

OneSignal kullanarak Unity uygulamanız için push bildirimleri kurma

​

Gereksinimler

• Unity 2022.3 veya daha yenisi
• Yapılandırılmış OneSignal uygulaması ve platformu

• Xcode 14+ ile macOS (kurulum talimatları Xcode 16.2 kullanır)
• iOS 12+, iPadOS 12+ veya iOS 16.2+ çalıştıran Xcode simülatörü ile cihaz

• Google Play Store (Hizmetleri) yüklü Android 7.0+ cihaz veya emülatör

​

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

Adım adım kurulum talimatları

1

Uygulamanızı oluşturun veya seçin

New App/Website’e tıklayarak yeni bir uygulama oluşturun veya Ayarlar > Push & Uygulama İçi’nde mevcut bir uygulamaya platform ekleyin. Yapılandırmak istediğiniz platform(ları) seçin ve İleri: Platformunuzu Yapılandırın’a tıklayın.

2

Platform kimlik bilgilerini yapılandırın

Platformunuz için kimlik bilgilerini girin:

• Android: Firebase Kimlik Bilgilerini Ayarlayın
• iOS: p8 Token (Önerilen) veya p12 Sertifikası
• Amazon: API Anahtarı Oluşturun
• Huawei: OneSignal’ı Yetkilendirin

Kimlik bilgilerinizi girdikten sonra Kaydet ve Devam Et’e tıklayın.

3

Uygulama ID'nizi kaydedin ve SDK'yı yükleyin

Uygulama ID’niz son ekranda görüntülenir. Kopyalayıp kaydedin — SDK’yı başlatırken ihtiyacınız olacak. SDK platformunuzu seçin, ardından kurulum kılavuzunu izleyin.

​

Kurulum

​

1. OneSignal Unity SDK’sını ekleyin

• Unity Asset Store
• Unity Package Manager

1. Add to My Assets aracılığıyla SDK’yı hesabınıza ekleyin.
2. Unity Editor ve Package Manager’ı başlatmak için Open in Unity’ye tıklayın.
3. SDK’yı indirin ve Import edin.

4. Tüm dosyaları içe aktarma istemini kabul edin.
5. Window > OneSignal SDK Setup’a gidin ve kontrol listesini, özellikle Import OneSignal packages’ı izleyin.
6. İçe aktarmadan sonra, Unity kayıt defterini güncelleyecektir. Kurulum penceresinde gösterilen kalan kurulum adımlarını tamamlayın.

1. Edit > Project Settings > Package Manager’a gidin.

2. Kapsamlı bir kayıt defteri ekleyin:

Name        npmjs
URL         https://registry.npmjs.org
Scope(s)    com.onesignal

3. Window > Package Manager’ı açın ve My Registries’e geçin.
4. İstenen OneSignal SDK paketlerini yükleyin.
5. Window > OneSignal SDK Setup’ı açın ve son adımları tamamlayın.

​

2. Platform kurulumu

​

iOS kurulumu

• Otomatik İmzalama (Önerilen)
• Manuel Provisioning

1. File > Build Settings > Player Settings’e gidin.
2. Other Settings altında Automatically Sign’ı işaretleyin.

Apple Developer hesabınızın şunlara sahip olduğundan emin olun:

• Bir App Group: group.{your_bundle_id}.onesignal
• Etkinleştirilmiş Push Notifications ve App Groups
• Bundle ID’niz için yenilenmiş provisioning profilleri

​

Android kurulumu

1. Edit > Project Settings > Player > Android’e gidin.
2. Publishing Settings altında şunları etkinleştirin:

• Custom Main Gradle Template
• Custom Gradle Properties Template

3. Assets > External Dependency Manager > Android Resolver > Force Resolve’u çalıştırın.

• Target API Level 33+ olmalıdır (v5.0.6+).
• Minify etkinse, OneSignalConfig.androidlib kullanmak için OneSignal SDK Setup’tan Copy Android plugin to Assets’i çalıştırın.
• Assets/Plugins/Android/OneSignalConfig.androidlib/src/main/res içindeki varsayılan simgeleri kendinizinkilerle değiştirin (yalnızca küçük harf dosya adları, alt çizgiye izin verilir). Daha fazla bilgi için Bildirim Simgelerini Özelleştir bölümüne bakın.

​

Amazon kurulumu

 xmlns:amazon="http://schemas.amazon.com/apk/res/android"

<uses-permission android:name="com.amazon.device.messaging.permission.RECEIVE" />
<permission android:name="COM.YOUR.PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="COM.YOUR.PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE" />

<amazon:enable-feature android:name="com.amazon.device.messaging" android:required="false"/>
<service android:name="com.onesignal.notifications.services.ADMMessageHandler" android:exported="false" />
<service android:name="com.onesignal.notifications.services.ADMMessageHandlerJob"
         android:permission="android.permission.BIND_JOB_SERVICE"
         android:exported="false" />
<receiver android:name="com.onesignal.notifications.receivers.ADMMessageReceiver"
          android:permission="com.amazon.device.messaging.permission.SEND" >
  <intent-filter>
    <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
    <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
    <category android:name="COM.YOUR.PACKAGE_NAME" />
  </intent-filter>
</receiver>

​

Huawei kurulumu

​

İsteğe bağlı: Konum modülünü devre dışı bırakın

• Editör anahtarı (etkileşimli): Unity Editor’da Project Settings > OneSignal bölümüne gidin ve Disable Location Module seçeneğini etkinleştirin. Ayar ProjectSettings/OneSignalSettings.json dosyasına kaydedilir.
• Ortam değişkeni (CLI/CI): Unity’yi başlatmadan önce kabukta ONESIGNAL_DISABLE_LOCATION=true (veya 1) değerini dışa aktarın. Ortam değişkeni, Editör anahtarına göre önceliklidir.

{
    "disableLocation": true
}

ONESIGNAL_DISABLE_LOCATION=true /path/to/Unity \
  -batchmode -quit -projectPath . -buildTarget Android

env:
  ONESIGNAL_DISABLE_LOCATION: true

​

Yerel bağımlılıklar önbelleğe alındıktan sonra değişikliği uygulayın

• Assets/OneSignal/Editor/OneSignalAndroidDependencies.xml ve Assets/OneSignal/Editor/OneSignaliOSDependencies.xml dosyalarını silin, ardından Unity’nin bunları ProjectSettings/OneSignalSettings.json dosyasından yeniden oluşturması için projeyi yeniden açın.
• Assets/Plugins/Android/mainTemplate.gradle dosyasının konumsuz paketleri alması için Assets > External Dependency Manager > Android Resolver > Force Resolve çalıştırın.
• iOS Xcode projesini yeniden dışa aktarın ve gerekirse pod install çalıştırın.
• Yeniden derlemeden önce Build/ ve diğer oluşturulan çıktıları kaldırın.

​

3. SDK’yı başlatın

using OneSignalSDK;

void Start () {
  // Enable verbose logging for debugging (remove in production)
  OneSignal.Debug.LogLevel = LogLevel.Verbose;
  // Initialize with your OneSignal App ID
  OneSignal.Initialize("YOUR_APP_ID");
  // Use this method to prompt for push notifications.
  // We recommend removing this method after testing and instead use In-App Messages to prompt for notification permission.
  await OneSignal.Notifications.RequestPermissionAsync(true);
}

​

OneSignal SDK entegrasyonunu test etme

​

Mobil abonelikleri kontrol edin

1

Uygulamanızı test cihazında başlatın.

Başlatma sırasında requestPermission metodunu eklediyseniz, yerel push izin istemi otomatik olarak görünmelidir.

2

OneSignal panonuzu kontrol edin

İstemi kabul etmeden önce OneSignal panosunu kontrol edin:

• Kitle > Abonelikler’e gidin.
• “Never Subscribed” durumuna sahip yeni bir girdi görmelisiniz.

3

Uygulamaya dönün ve istemde İzin Ver'e dokunun.

4

OneSignal panosu Abonelik sayfasını yenileyin.

Aboneliğin durumu artık Abone olarak görünmelidir.

Başarıyla bir mobil abonelik oluşturdunuz. Mobil abonelikler, kullanıcılar uygulamanızı bir cihazda ilk kez açtığında veya uygulamanızı aynı cihazda kaldırıp yeniden yüklediklerinde oluşturulur.

​

Test aboneliklerini ayarlayın

1

Test Aboneliklerine ekleyin.

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

2

Aboneliğinizi adlandırın.

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

3

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

Kitle > Segmentler > Yeni Segment’e gidin.

4

Segmenti adlandırın.

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

5

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

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

1

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

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

2

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"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

3

Kodu çalıştırın.

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

4

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

Tüm kurulum adımları başarıyla tamamlandıysa, test abonelikleri görsel içeren bir bildirim almalıdır:

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.

5

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.

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

• Görsel alınamadı mı? Notification Service Extension’ınız eksik olabilir.
• Onaylanmış teslimat yok mu? Sorun giderme kılavuzunu buradan inceleyin.
• Sorun mu yaşıyorsunuz? API isteğini ve uygulama başlatmanın başından sonuna kadar olan günlüğü bir .txt dosyasına kopyalayıp yapıştırın. Ardından ikisini de support@onesignal.com ile paylaşın.

​

Uygulama içi mesaj gönderin

1

Cihazda uygulamanızı kapatın veya arka plana alın.

Bunun nedeni, kullanıcıların yeni bir oturum başlamadan önce uygulama içi kitle kriterlerini karşılaması gerektiğidir. OneSignal’da, kullanıcı uygulamanızı arka planda veya kapalı olarak en az 30 saniye geçirdikten sonra açtığında yeni bir oturum başlar. Daha fazla ayrıntı için uygulama içi mesajların nasıl görüntülendiği kılavuzumuza bakın.

2

Uygulama içi mesaj oluşturun.

• OneSignal panonuzda Mesajlar > Uygulama İçi > Yeni Uygulama İçi’ye gidin.
• Hoş Geldiniz mesajını bulun ve seçin.
• Kitlenizi daha önce kullandığımız Test Users segmenti olarak ayarlayın.

3

İsterseniz mesaj içeriğini özelleştirin.

4

Tetikleyiciyi 'Uygulama açıldığında' olarak ayarlayın.

5

Sıklığı planlayın.

Zamanlama > Bu mesajı ne sıklıkla göstermek istiyorsunuz? altında Tetikleyici koşullar her karşılandığında’yı seçin.

6

Mesajı yayınlayın.

Test Kullanıcılarınıza uygulam her açtıklarında erişilebilir olması için Mesajı Yayınla’ya tıklayın.

7

Uygulamayı açın ve mesajı görün.

Uygulama içi mesaj yayındayken, uygulamanızı açın. Şunu görmelisiniz:

Mesajı görmüyor musunuz?

• Yeni bir oturum başlatın
  • Yeniden açmadan önce uygulamayı en az 30 saniye kapatmalı veya arka plana almalısınız. Bu, yeni bir oturumun başlatılmasını sağlar.
  • Daha fazlası için uygulama içi mesajların nasıl görüntülendiğine bakın.
• Hala Test Users segmentinde misiniz?
  • Uygulamayı yeniden yüklediyseniz veya cihaz değiştirdiyseniz, cihazı Test Aboneliklerine yeniden ekleyin ve Test Users segmentinin bir parçası olduğunu onaylayın.
• Sorun mu yaşıyorsunuz?
  • Yukarıdaki adımları yeniden üretirken Hata Ayıklama Günlüğü Alma kılavuzunu izleyin. Bu, support@onesignal.com ile paylaşabileceğiniz ek günlükler oluşturacak ve ne olduğunu araştırmamıza yardımcı olacağız.

​

Kullanıcı tanımlama

​

Harici ID ata

​

Veri etiketleri ekleyin

​

E-posta ve/veya SMS abonelikleri ekleyin

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

​

Gizlilik ve kullanıcı onayı

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

• SDK tarafından toplanan veriler
• Kişisel verilerin işlenmesi

​

Push izinleri için istem

​

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

​

Push bildirimi etkinlikleri

• addClickListener(): Bir bildirimin ne zaman dokunulduğunu tespit edin. Derin Bağlantı için yararlıdır.
• addForegroundLifecycleListener(): Bildirimlerin ön planda nasıl davrandığını kontrol edin.

​

Kullanıcı durumu değişiklikleri

• Kullanıcı durumu için addObserver(): Harici ID’nin ne zaman ayarlandığını tespit edin.
• addPermissionObserver(): Kullanıcının yerel push izin istemi ile belirli etkileşimini izleyin.
• Push aboneliği için addObserver(): Push abonelik durumunun ne zaman değiştiğini izleyin.

​

Uygulama içi mesaj etkinlikleri

• addClickListener(): Uygulama içi tıklama eylemlerini işleyin. Derin bağlantı veya etkinlik izleme için idealdir.
• addLifecycleListener(): Uygulama içi mesajların tam yaşam döngüsünü izleyin (gösterildi, tıklandı, reddedildi, vb.).

​

Gelişmiş kurulum ve yetenekler

• 🔁 Başka bir servisten OneSignal’a geçiş
• 🌍 Konum izleme
• 🔗 Derin Bağlantı
• 🔌 Entegrasyonlar
• 🧩 Mobil Servis Uzantıları
• 🛎️ Eylem düğmeleri
• 🌐 Çok dilli mesajlaşma
• 🛡️ Kimlik Doğrulama
• 📊 Özel Sonuçlar
• 📲 Canlı Aktiviteler

​

Mobil SDK kurulumu ve referansı