Verwendung eines iOS Push-Benachrichtigungs-SDK für Ihre App (mit Code)

Ein iOS Push-Benachrichtigungs-SDK erfüllt zwei Aufgaben: Es kümmert sich um die Verbindung zwischen Ihrer App und dem Apple Push Notification Service und verbindet diese Verbindung mit einer Kampagnenplattform, damit Ihr Marketingteam sie tatsächlich nutzen kann. Diese Anleitung behandelt beides – die tatsächlichen Integrationsschritte mit dem Code, den Sie ausliefern werden, und was im Dashboard möglich wird, sobald das SDK integriert ist. Sie bezieht sich auf das PushEngage iOS SDK 1.0, die aktuelle Version.

Warum ein iOS Push-Benachrichtigungs-SDK für Ihre App verwenden

Sie können direkt mit APNs kommunizieren – einen Gerätee token registrieren, einen Sender erstellen, Zustellungs-Callbacks selbst verarbeiten. Was Sie von rohen APNs erhalten, ist die Zustellung; was Sie nicht erhalten, sind alle Dinge, die das Marketing benötigt: Segmentierung, geplante und ausgelöste Kampagnen, A/B-Tests, Analysen und Umsatzzuordnung. Ein SDK wie das von PushEngage verbindet Ihre App einmalig mit dieser Ebene, sodass Kampagnen in einem Dashboard statt in einem Xcode-Projekt erstellt werden. Das praktische Ergebnis: Nach der Integrationswoche sind Push-Kampagnen keine Engineering-Tickets mehr.

Installation des PushEngage iOS Push-Benachrichtigungs-SDK

Sie benötigen iOS 12+, Xcode 15+, einen APNs-Schlüssel, der in Ihr PushEngage-Dashboard hochgeladen wurde, und etwa einen Nachmittag Zeit. Das SDK wird als zwei Module ausgeliefert: PushEngage für Ihr App-Ziel und PushEngageExtension für Benachrichtigungs-Erweiterungsziele.

Schritt 1: Paket hinzufügen

Gehen Sie in Xcode zu Datei → Paketabhängigkeiten hinzufügen und geben Sie die Repository-URL ein – oder verwenden Sie CocoaPods:

# 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

Schritt 2: App-Gruppe konfigurieren

Fügen Sie die App Groups-Berechtigung zu Ihrem App-Ziel und jedem Benachrichtigungs-Erweiterungsziel hinzu, verwenden Sie dieselbe Gruppen-ID und deklarieren Sie sie in der Info.plist jedes Ziels:

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

Die App und ihre Erweiterungen teilen sich den Abonnentenstatus über diesen Container. Das Überspringen ist der häufigste Integrationsfehler – ohne ihn starten Ihre Erweiterungen bei jeder Zustellung leer.

Schritt 3: Berechtigung initialisieren und anfordern

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 */ }
}

Wo Sie diesen Berechtigungsaufruf platzieren, ist wichtiger als alles andere in dieser Anleitung – iOS gewährt Ihnen genau eine native Aufforderung. Die Anleitung zur Berechtigungs-Vorbereitung behandelt das Soft-Ask-Muster, das diese schützt.

Senden von Rich App Push-Benachrichtigungen für iOS

Bilder, Aktionsschaltflächen und benutzerdefinierte Töne erfordern eine Notification Service Extension – ein kleines Ziel, das jede Benachrichtigung abfängt und Medien vor der Anzeige anhängt. Fügen Sie das Ziel in Xcode hinzu, verknüpfen Sie PushEngageExtension damit und leiten Sie die beiden Lifecycle-Aufrufe weiter:

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
    }
}

Von dort aus ist Rich Media eine Dashboard-Funktion: Ihr Marketingteam fügt das Produktbild oder die Hero-Grafik hinzu, wenn es die Kampagne erstellt, und die Erweiterung rendert sie. Keine weiteren App-Änderungen pro Kampagne.

So erstellen Sie personalisierte iOS-Push-Benachrichtigungen

Die Personalisierung basiert auf dem, was das SDK über jeden Abonnenten weiß. Identifizieren Sie Ihren Benutzer und fügen Sie Attribute hinzu, und jede Kampagne kann diese segmentieren und als Vorlage verwenden:

// 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 }

Wiederholte identify-Aufrufe mit unveränderten Daten werden lokal abgekürzt, sodass der Aufruf bei jedem Start sicher ist. Sobald Attribute fließen, erfolgt die Segmentierung im Dashboard – „Gold-Tier-Outdoor-Bekleidungskäufer in Texas“ wird zu einer gespeicherten Zielgruppe, nicht zu einer SQL-Anfrage.

So fügen Sie einen Deep-Link in iOS-Push-Benachrichtigungen ein

Jeder Kampagnen-Tipp sollte auf dem Bildschirm landen, den er versprochen hat. Legen Sie den Benachrichtigungs-Öffnungs-Handler einmal fest und leiten Sie ihn anhand des darin enthaltenen Deep-Links weiter:

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
    }
}

Der Vermarkter fügt den Deep-Link in das Kampagnenformular ein; Ihr Handler übernimmt die Weiterleitung. Vollständige Muster – einschließlich Universal Links und der Auto-Open-Option – finden Sie im Deep-Linking-Leitfaden.

So lösen Sie Kampagnen über App-Ereignisse aus

Der trackEvent-Aufruf des SDK 1.0 verwandelt jedes In-App-Verhalten in einen Kampagnen-Trigger – ein abgebrochener Warenkorb, ein abgeschlossener Onboarding-Schritt, eine angesehene Kategorie:

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

Instrumentieren Sie das Ereignis einmal; das Marketing erstellt und iteriert die Kampagnen unbegrenzt dagegen. Der Leitfaden für ereignisgesteuerte Kampagnen enthält die vollständige Taxonomie und die Konfiguration für Warenkörbe, Onboarding und Win-Back.

Was tun, nachdem Sie ein iOS-Push-Benachrichtigungs-SDK haben

Die Integration ist der Anfang, nicht die Ziellinie. Die am schnellsten zahlende Sequenz: Schützen Sie Ihre Opt-in-Rate mit einem vorbereiteten Berechtigungsfluss, versenden Sie die Warenkorbabbrecher-Sequenz (die Kampagne mit dem höchsten ROI für Commerce-Apps), fügen Sie Zielverfolgung hinzu, damit jede Kampagne Umsätze statt Öffnungen meldet, und bauen Sie dann den Lebenszyklus auf – Onboarding-Serien im Frontend, Win-Back im Backend. Der Leitfaden für App-Push-Marketing behandelt diese Strategieebene von Ende zu Ende, und die Einrichtungsdokumentation führt Sie durch jeden Dashboard-Bildschirm. Jeder bezahlte Plan beinhaltet eine 14-tägige Geld-zurück-Garantie – und das SDK ist auf GitHub unter der MIT-Lizenz verfügbar, sodass Sie genau lesen können, was Sie versenden.