iOS SDK kurulumu

​

Genel Bakış

​

Gereksinimler

• 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ü olan cihaz
• Yapılandırılmış OneSignal uygulaması ve platformu

​

Configure your OneSignal app and platform

Step-by-step instructions for configuring your OneSignal app.

You can manage multiple platforms (iOS, Android, Huawei, Amazon, Web) under a single OneSignal app.

1

Create or select your app

• To add platforms to an existing app, go to Settings > Push & In-App in the OneSignal dashboard.
• To start fresh, click New App/Website and follow the prompts.

Example shows creating a new app.

2

Set up and activate a platform

• Choose a clear and recognizable name for your app and organization.
• Select the platform(s) you want to configure (iOS, Android, etc.).
• Click Next: Configure Your Platform.

Example setting up your first OneSignal app, org, and channel.

3

Configure platform credentials

Follow the prompts based on your platforms:

• Android: Set up Firebase Credentials
• iOS: p8 Token (Recommended) or p12 Certificate
• Amazon: Generate API Key
• Huawei: Authorize OneSignal

Click Save & Continue after entering your credentials.

4

Choose target SDK

Select the SDK that matches your development platform (e.g., iOS, Android, React Native, Unity), then click Save & Continue.

Select which SDK you are using to be navigated to the docs.

5

Install SDK and save your App ID

Once your platform is configured, your OneSignal App ID will be displayed. Copy and save this ID—you’ll need it when installing and initializing the SDK.If collaborating with others, use the Invite button to add developers or teammates, then click Done to complete setup.

Save your App ID and invite additional team members.

Once complete, follow the SDK installation guide for your selected platform to finish integrating OneSignal.

​

iOS kurulumu

​

1. Uygulama hedefine Push Notifications yeteneği ekleme

1. Uygulamanızın .xcworkspace dosyasını Xcode’da açın.
2. Uygulama hedefi > Signing & Capabilities seçeneğini seçin
3. + Capability tıklayın ve Push Notifications yeteneğini ekleyin

Uygulama hedefine Push Notifications yeteneği verildi.

​

2. Uygulama hedefine Background Modes yeteneği ekleme

1. Background Modes yeteneğini ekleyin
2. Remote notifications seçeneğini etkinleştirin

Uygulama hedefine Remote Notifications arka plan yürütme modu verildi.

​

3. Uygulama hedefini App Group’a ekleme

• Yapılandırılmış bir App Group'unuz YOKSA
• Mevcut bir App Group'unuz VARSA

1. App Groups yeteneğini ekleyin
2. App Groups yeteneğinde + işaretine tıklayın
3. Şu formatta yeni bir container ID ekleyin: group.your_bundle_id.onesignal

• group. ve .onesignal ön eki ve son ekini koruyun. your_bundle_id kısmını uygulamanızın bundle identifier’ı ile değiştirin.
• Örneğin, bundle identifier com.onesignal.MyApp ise, container adı group.com.onesignal.MyApp.onesignal olacaktır.

Uygulama hedefi App Group'un bir parçasıdır.

App Group adınız, tüm hedeflerde bundle ID’nizin yazımı ve büyük-küçük harf kullanımıyla tam olarak eşleşmelidir.

​

4. Notification Service Extension ekleme

1. Xcode’da: File > New > Target…
2. Notification Service Extension seçin, ardından Next tıklayın.
3. Ürün adını OneSignalNotificationServiceExtension olarak ayarlayın ve Finish tuşuna basın.
4. Activate scheme isteminde Don’t Activate seçeneğine basın.

Notification Service Extension hedefini seçin.

Notification Service Extension'a ad verin.

Uygulama hedefinizde hata ayıklamaya devam etmek için aktivasyonu iptal edin.

Ana uygulama ile aynı dağıtım hedefini ayarlayın.

​

5. NSE hedefini app group’a ekleme

1. OneSignalNotificationServiceExtension > Signing & Capabilities bölümüne gidin
2. App Groups ekleyin
3. Tam olarak aynı group ID’yi ekleyin

NSE artık uygulama hedefinizle aynı app group'a ait.

​

6. NSE kodunu güncelleme

1. OneSignalNotificationServiceExtension klasörüne gidin
2. NotificationService.swift veya NotificationService.m dosyasının içeriğini aşağıdakilerle değiştirin:

NotificationService dosyanıza gidin.

import UserNotifications
import OneSignalExtension

class NotificationService: UNNotificationServiceExtension {
    var contentHandler: ((UNNotificationContent) -> Void)?
    var receivedRequest: UNNotificationRequest!
    var bestAttemptContent: UNMutableNotificationContent?

    // Note this extension only runs when `mutable_content` is set
    // Setting an attachment or action buttons automatically sets the property to true
    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        self.receivedRequest = request
        self.contentHandler = contentHandler
        self.bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)

        if let bestAttemptContent = bestAttemptContent {
            // DEBUGGING: Uncomment the 2 lines below to check this extension is executing
//            print("Running NotificationServiceExtension")
//            bestAttemptContent.body = "[Modified] " + bestAttemptContent.body

            OneSignalExtension.didReceiveNotificationExtensionRequest(self.receivedRequest, with: bestAttemptContent, withContentHandler: self.contentHandler)
        }
    }

    override func serviceExtensionTimeWillExpire() {
        // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
        if let contentHandler = contentHandler, let bestAttemptContent =  bestAttemptContent {
            OneSignalExtension.serviceExtensionTimeWillExpireRequest(self.receivedRequest, with: self.bestAttemptContent)
            contentHandler(bestAttemptContent)
        }
    }
}

Bu dosya, bir sonraki adımda paketi yükleyene kadar hata gösterir.

​

SDK kurulumu

​

1. SDK ekleme

• Xcode Package Dependencies
• CocoaPods

File > Add Package Dependencies… bölümüne gidin ve OneSignal iOS SDK deposunun URL’sini girin:https://github.com/OneSignal/OneSignal-iOS-SDKonesignal-ios-sdk paketini seçin ve Add Package tıklayın.OneSignal-iOS-SDK için Package Products seçin.

• Önemli: OneSignalExtension’ı OneSignalNotificationServiceExtension Target’a ekleyin.
• OneSignalFramework’ü App Target’ınıza ekleyin.
• Uygulama içi mesajlar (önerilen) ve/veya konum takibi kullanmayı planlıyorsanız, bu paketleri de App Target’ınıza ekleyin.

Uygulamanız konum takibi gerektirmiyorsa, bu örnekte gösterildiği gibi paketi kaldırabilirsiniz.

Daha fazla ayrıntı için Apple’ın Adding package dependencies belgesine bakın.

​

2. SDK’yı başlatma

import SwiftUI
import OneSignalFramework

@main
struct YOURAPP_NAME: App {
  //Connect the SwiftUI app to the UIKit app delegate
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {

       // Enable verbose logging for debugging (remove in production)
       OneSignal.Debug.setLogLevel(.LL_VERBOSE)
       // Initialize with your OneSignal App ID
       OneSignal.initialize("YOUR_APP_ID", withLaunchOptions: launchOptions)
       // 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.
       OneSignal.Notifications.requestPermission({ accepted in
         print("User accepted notifications: \(accepted)")
       }, fallbackToSettings: false)

       return true
    }
}

​

OneSignal SDK entegrasyonunu test etme

​

Mobil abonelikleri kontrol etme

1

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

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

iOS ve Android push izin istemleri

2

OneSignal panonuzu kontrol edin

İstemi kabul etmeden önce OneSignal panosunu kontrol edin:

• Audience > Subscriptions bölümüne gidin.
• “Never Subscribed” durumuna sahip yeni bir girdi görmelisiniz.

'Never Subscribed' durumuna sahip aboneliği gösteren pano

3

Uygulamaya dönün ve istemde Allow'a dokunun.

4

OneSignal panosu Subscriptions sayfasını yenileyin.

Abonelik durumu artık Subscribed göstermelidir.

'Subscribed' durumuna sahip aboneliği gösteren pano

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

​

Test aboneliklerini ayarlama

1

Test Subscriptions'a ekleyin.

Panoda, aboneliğin yanında Options (üç nokta) düğmesine tıklayın ve Add to Test Subscriptions seçeneğini seçin.

Test Subscriptions'a bir cihaz ekleme

2

Aboneliğinizi adlandırın.

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

'Name your subscription' alanını gösteren pano

3

Bir test kullanıcıları segmenti oluşturun.

Audience > Segments > New Segment bölümüne 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 tıklayın.

Test Users filtresi ile bir 'Test Users' segmenti oluşturma

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

​

API üzerinden test push gönderme

1

App API Key ve App ID'nizi alın.

OneSignal panonuzda Settings > Keys & IDs bölümüne 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.

Copy

Ask AI

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:

iOS ve Android'de görsel içeren push bildirimi

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 Delivery > Sent Messages bölümüne gidin, ardından istatistikleri görmek için mesaja tıklayın.confirmed istatistiğini görmelisiniz, bu cihazın push’u aldığı anlamına gelir.

Onaylanmış teslimatı gösteren teslimat istatistikleri

Professional planında veya daha üst bir plandaysanız, abonelik düzeyinde onaylamayı görmek için Audience Activity bölümüne kaydırın:

Audience Activity'de cihaz düzeyinde onaylanmış teslimat

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

• Görsel almadınız 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 log’u bir .txt dosyasına kopyalayın. Ardından her ikisini de support@onesignal.com ile paylaşın.

​

Uygulama içi mesaj gönderme

1

Uygulamanızı cihazda 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ı en az 30 saniye arka planda veya kapalı kaldıktan 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

Bir uygulama içi mesaj oluşturun.

• OneSignal panonuzda Messages > In-App > New In-App bölümüne gidin.
• Welcome mesajını bulun ve seçin.
• Kitlenizi daha önce kullandığımız Test Users segmenti olarak ayarlayın.

Bir uygulama içi mesajla 'Test Users' segmentini hedefleme

3

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

Uygulama içi Welcome mesajının örnek özelleştirmesi

4

Trigger'ı 'On app open' olarak ayarlayın.

5

Sıklığı planlayın.

Schedule > How often do you want to show this message? altında Every time trigger conditions are satisfied seçeneğini seçin.

Uygulama içi mesaj planlama seçenekleri

6

Mesajı yayına alın.

Test Kullanıcılarınız uygulamayı her açtığında kullanılabilir olması için Make Message Live tıklayın.

7

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

Uygulama içi mesaj yayına alındıktan sonra, uygulamanızı açın. Şunu görüntülediğini görmelisiniz:

Cihazlarda gösterilen Welcome uygulama içi mesajı

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 fazla bilgi için uygulama içi mesajların nasıl görüntülendiğine bakın.
• Hala Test Users segmentinde misiniz?
  • Yeniden yüklediyseniz veya cihaz değiştirdiyseniz, cihazı Test Subscriptions’a yeniden ekleyin ve Test Users segmentinin bir parçası olduğunu onaylayın.
• Sorun mu yaşıyorsunuz?
  • Yukarıdaki adımları tekrarlarken Hata Ayıklama Günlüğü Alma yönergelerini izleyin. Bu, support@onesignal.com ile paylaşabileceğiniz ek kayıt oluşturur ve ne olduğunu araştırmamıza yardımcı oluruz.

​

Kullanıcı tanımlama

​

External ID atama

​

Veri etiketleri ekleme

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

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ş bir mesajla Level 5-10 segmentini hedefleyen bir push bildirimi gösteren ekran görüntüsü

Push bildirimi, kişiselleştirilmiş içerikle iOS ve Android cihazda alındı

​

E-posta ve/veya SMS abonelikleri ekleme

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

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

​

Gizlilik ve kullanıcı onayı

• setConsentRequired(true): Onay verilene kadar veri toplamayı önler.
• setConsentGiven(true): Onay verildikten sonra veri toplamayı etkinleştirir.

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

​

Push izinleri için istemde bulunma

​

Push, kullanıcı ve uygulama içi olayları dinleme

​

Push bildirimi olayları

• addClickListener(): Bir bildirime dokunulduğunu algılar. Deep Linking için yararlıdır.
• addForegroundLifecycleListener(): Bildirimlerin ön planda nasıl davrandığını kontrol eder.

​

Kullanıcı durumu değişiklikleri

• Kullanıcı durumu için addObserver(): External ID’nin ne zaman ayarlandığını algılar.
• addPermissionObserver(): Kullanıcının yerel push izin istemiyle belirli etkileşimini takip eder.
• Push aboneliği için addObserver(): Push abonelik durumu değiştiğinde takip eder.

​

Uygulama içi mesaj olayları

• addClickListener(): Uygulama içi tıklama eylemlerini işler. Deep linking veya olayları takip etmek için idealdir.
• addLifecycleListener(): Uygulama içi mesajların tam yaşam döngüsünü takip eder (gösterildi, tıklandı, kapatıldı vb.).

​

Gelişmiş kurulum ve yetenekler

• 🔁 Başka bir hizmetten OneSignal’a geçiş
• 🌍 Konum takibi
• 🔗 Deep Linking
• 🔌 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ı