Uygulamanız İçin Bir iOS Anlık Bildirim SDK'sı Nasıl Kullanılır (Kodlu)

Bir iOS anlık bildirim SDK'sı iki işlevi yerine getirir: uygulamanız ve Apple Anlık Bildirim hizmeti arasındaki bağlantıyı yönetir ve bu bağlantıyı bir kampanya platformuna bağlayarak pazarlama ekibinizin kullanabilmesini sağlar. Bu kılavuz her ikisini de kapsar — göndereceğiniz kodla gerçek entegrasyon adımlarını ve SDK kurulduktan sonra kontrol panelinde nelerin mümkün olabileceğini. Mevcut sürüm olan PushEngage iOS SDK 1.0'ı yansıtmaktadır.

Uygulamanız İçin Neden Bir iOS Anlık Bildirim SDK'sı Kullanmalısınız

APNs ile doğrudan konuşabilirsiniz — bir cihaz belirteci için kaydolun, bir gönderici oluşturun, teslimat geri aramalarını kendiniz halledin. Ham APNs'den elde ettiğiniz şey teslimattır; pazarlamanın ihtiyaç duyduğu her şeyi elde edemezsiniz: segmentasyon, zamanlanmış ve tetiklenmiş kampanyalar, A/B testi, analizler ve gelir atıfı. PushEngage'inki gibi bir SDK, uygulamanızı bu katmana bir kez bağlar, böylece kampanyalar bir Xcode projesi yerine bir kontrol panelinde oluşturulur. Pratik sonuç: entegrasyon haftasından sonra, anlık bildirim kampanyaları mühendislik biletleri olmaktan çıkar.

PushEngage iOS Anlık Bildirim SDK'sı Nasıl Yüklenir

iOS 12+, Xcode 15+, PushEngage kontrol panelinize yüklenmiş bir APNs anahtarı ve yaklaşık bir öğleden sonraya ihtiyacınız olacak. SDK iki modül olarak gönderilir: uygulamanız hedefi için PushEngage ve bildirim uzantısı hedefleri için PushEngageExtension.

Adım 1: Paketi ekleyin

Xcode'da, Dosya → Paket Bağımlılıkları Ekle'ye gidin ve depo URL'sini girin — veya CocoaPods'u kullanın:

# Swift Package Manager
https://github.com/awesomemotive/pushengage-ios-sdk

# CocoaPods
target 'YourApp' do
  pod 'PushEngage', '~> 1.0.0'
end
target 'YourNotificationServiceExtension' do
  pod 'PushEngageExtension', '~> 1.0.0'
end

Adım 2: Uygulama Grubunu Yapılandırın

Uygulama grubunu uygulamanız hedefi ve her bildirim uzantısı hedefi için aynı grup kimliğini kullanarak ekleyin ve her hedefin Info.plist'inde bildirin:

<key>PushEngage_App_Group_Key</key>
<string>group.com.yourcompany.yourapp</string>

Uygulama ve uzantıları, bu kapsayıcı aracılığıyla abone durumunu paylaşır. Bunu atlamak en yaygın entegrasyon hatasıdır — olmadan, uzantılarınız her teslimatta boş başlar.

Adım 3: Başlatın ve izin isteyin

import PushEngage

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        PushEngage.setAppID(id: "YOUR_APP_ID")
        PushEngage.setInitialInfo(for: application, with: launchOptions)
        return true
    }
}

// Later, at a value moment — not on first launch:
PushEngage.requestNotificationPermission { granted, error in
    if granted { /* subscribed */ }
}

Bu kılavuzdaki her şeyden daha önemli olan, bu izin çağrısını nereye koyduğunuzdur — iOS size tam olarak bir yerel istem hakkı verir. İzin ön hazırlık kılavuzu, onu koruyan yumuşak istem desenini kapsar.

iOS İçin Zengin Uygulama Anlık Bildirimleri Nasıl Gönderilir

Resimler, eylem düğmeleri ve özel sesler, her bildirimi yakalayan ve görüntülemeden önce medya ekleyen küçük bir hedef olan bir Bildirim Hizmeti Uzantısı gerektirir. Hedefi Xcode'da ekleyin, PushEngageExtension'ı ona bağlayın ve iki yaşam döngüsü çağrısını iletin:

import PushEngageExtension

class NotificationService: UNNotificationServiceExtension {
    override func didReceive(_ request: UNNotificationRequest,
                             withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        PushEngageExtension.didReceiveNotificationExtensionRequest(request,
                                                                   bestContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        // hand back the best content prepared so far
    }
}

Buradan itibaren, zengin medya bir kontrol paneli özelliğidir: pazarlama ekibiniz kampanyayı oluştururken ürün resmini veya ana grafiği ekler ve uzantı bunu oluşturur. Kampanya başına ek uygulama değişikliği gerekmez.

Kişiselleştirilmiş iOS anlık bildirimleri nasıl oluşturulur

Kişiselleştirme, SDK'nın her abone hakkında bildiği bilgilere göre çalışır. Kullanıcınızı tanımlayın ve öznitelikler ekleyin, böylece her kampanya bunlara göre segmentasyon ve şablon oluşturabilir:

// Identify the signed-in user (12 predefined fields supported)
PushEngage.identify(fields: [
    "first_name": "Priya",
    "email": "[email protected]",
    "profile_id": "user-42",
    "city": "Austin"
]) { success, error in }

// Attach custom attributes for segmentation
PushEngage.addSubscriberAttributes([
    "favorite_category": "outerwear",
    "loyalty_tier": "gold"
]) { success, error in }

// On sign-out, clear PII but keep the anonymous subscription
PushEngage.logout(fieldNames: nil) { success, error in }

Değişmeyen verilerle yapılan identify çağrılarını tekrarlamak yerel olarak kısayol oluşturur, bu nedenle her başlatmada çağırmak güvenlidir. Öznitelikler aktıktan sonra, segmentasyon kontrol panelinde gerçekleşir - "Teksas'taki altın seviye dış giyim alışverişçileri", bir SQL isteği değil, kaydedilmiş bir hedef kitle haline gelir.

iOS anlık bildirimlerine derin bağlantı nasıl eklenir

Her kampanya dokunuşu vaat ettiği ekrana yönlendirmelidir. Bildirim açma işleyicisini bir kez ayarlayın, taşıdığı derin bağlantıya göre yönlendirin:

PushEngage.setNotificationOpenHandler { result in
    // actionID is nil when the SDK already opened the URL itself
    guard let deepLink = result.notificationAction.actionID else { return }
    DispatchQueue.main.async {
        router.navigate(to: deepLink)   // e.g. myapp://cart
    }
}

Pazarlamacı derin bağlantıyı kampanya formuna yapıştırır; işleyiciniz yönlendirmeyi yapar. Evrensel bağlantılar ve otomatik açma seçeneği dahil olmak üzere tam kalıplar derin bağlantı kılavuzunda bulunur.

Uygulama olaylarından kampanyalar nasıl tetiklenir

1.0 SDK'sının trackEvent çağrısı, terk edilmiş bir sepet, tamamlanmış bir başlangıç adımı, göz atılan bir kategori gibi herhangi bir uygulama içi davranışı kampanya tetikleyicisine dönüştürür:

PushEngage.trackEvent(name: "cart_updated",
                      properties: ["cart_value": 89.50, "item_count": 2],
                      profileId: currentUserId,
                      provider: nil, eventType: nil) { _, _ in }

Olayı bir kez enstrümanlayın; pazarlama, kampanyaları bunun üzerine sonsuza dek oluşturur ve yineler. Olay tetiklemeli kampanyalar kılavuzu tam taksonomiyi ve sepet, başlangıç ve geri kazanma bağlantılarını içerir.

iOS anlık bildirimleri SDK'sına sahip olduğunuzda ne yapmalısınız

Entegrasyon başlangıçtır, bitiş çizgisi değil. En hızlı sonuç veren sıra: izin verme oranınızı önceden hazırlanmış bir izin akışıyla koruyun, sepet terk etme dizisini (e-ticaret uygulamaları için en yüksek yatırım getirisi olan kampanya) gönderin, her kampanyanın açılışlar yerine geliri raporlaması için hedef izlemeyi ekleyin ve ardından yaşam döngüsünü oluşturun - ön uçta başlangıç serileri, arka uçta geri kazanma. Uygulama anlık bildirim pazarlama kılavuzu bu strateji katmanını uçtan uca kapsar ve kurulum belgeleri her kontrol paneli ekranında yol gösterir. Her ücretli plan 14 günlük para iade garantisi sunar - ve SDK GitHub'da MIT lisanslıdır, böylece gönderdiğiniz şeyi tam olarak okuyabilirsiniz.