Sådan bruges et iOS Push Notifications SDK til din app (med kode)

Et iOS push notifications SDK udfører to opgaver: det håndterer forbindelsen mellem din app og Apple Push Notification service, og det forbinder denne forbindelse til en kampagneplatform, så dit marketingteam rent faktisk kan bruge den. Denne guide dækker begge dele – de reelle integrationstrin med den kode, du vil implementere, og hvad der bliver muligt på dashboardet, når SDK'et er installeret. Den afspejler PushEngage iOS SDK 1.0, den aktuelle udgivelse.

Hvorfor bruge et iOS push notifications SDK til din app

Du kan tale direkte med APNs – registrere dig for et enhedstoken, bygge en afsender, håndtere leveringscallbacks selv. Hvad du får fra rå APNs er levering; hvad du ikke får er alt, hvad marketing har brug for: segmentering, planlagte og udløste kampagner, A/B-test, analyse og indtægtsattribution. Et SDK som PushEngage's forbinder din app til dette lag én gang, så kampagner oprettes i et dashboard i stedet for et Xcode-projekt. Det praktiske resultat: efter integrationsugen stopper push-kampagner med at være ingeniøropgaver.

Sådan installeres PushEngage iOS push notifications SDK

Du skal bruge iOS 12+, Xcode 15+, en APNs-nøgle uploadet til dit PushEngage-dashboard og cirka en eftermiddag. SDK'et leveres som to moduler: PushEngage til din app-mål og PushEngageExtension til notifikationsudvidelsesmål.

Trin 1: Tilføj pakken

I Xcode skal du gå til File → Add Package Dependencies og indtaste repository-URL'en – eller brug 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

Trin 2: Konfigurer App Group

Tilføj App Groups-kapabiliteten til din app-mål og alle notifikationsudvidelsesmål, ved at bruge den samme gruppe-ID, og deklarer den i hver måls Info.plist:

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

Appen og dens udvidelser deler abonnentstatus via denne container. At springe dette over er den mest almindelige integrationsfejl – uden den starter dine udvidelser tomme ved hver levering.

Trin 3: Initialiser og anmod om tilladelse

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

Hvor du placerer denne tilladelsesanmodning betyder mere end noget andet i denne guide – iOS giver dig præcis én native prompt. Guiden til tilladelses-priming dækker mønsteret for bløde anmodninger, der beskytter den.

Sådan sender du rich app push-notifikationer til iOS

Billeder, handlingsknapper og brugerdefinerede lyde kræver en Notification Service Extension – et lille mål, der aflytter hver notifikation og vedhæfter medier før visning. Tilføj målet i Xcode, link PushEngageExtension til det, og videresend de to livscyklus-kald:

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

Herfra er rige medier en dashboard-funktion: dit marketingteam vedhæfter produktbilledet eller grafikken, når de opbygger kampagnen, og udvidelsen gengiver det. Ingen yderligere app-ændringer pr. kampagne.

Sådan opretter du personlige iOS push-notifikationer

Personalisering kører på det, SDK'en ved om hver abonnent. Identificer din bruger og vedhæft attributter, og hver kampagne kan segmentere og skabelonere mod dem:

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

Gentagne identify-kald med uændrede data afkortes lokalt, så det er sikkert at kalde det ved hver lancering. Når attributter flyder, sker segmentering i dashboardet – “guld-tier overtøj-shoppere i Texas” bliver et gemt publikum, ikke en SQL-forespørgsel.

Sådan tilføjer du et deep link i iOS push-notifikationer

Hvert kampagne-tryk skal lande på den skærm, det lovede. Indstil notifikationsåbningshåndteringen én gang, rute baseret på det deep link, den bærer:

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

Markedsføreren indsætter deep linket i kampagneformularen; din håndtering foretager rutningen. Fuldstændige mønstre – inklusive universelle links og auto-åbningsmuligheden – findes i deep linking-guiden.

Sådan udløser du kampagner fra app-hændelser

1.0 SDK’ens trackEvent-kald omdanner enhver in-app-adfærd til en kampagneudløser – en forladt indkøbskurv, et afsluttet onboarding-trin, en besøgt kategori:

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

Instrumenter hændelsen én gang; marketing opbygger og itererer kampagnerne mod den på ubestemt tid. Guide til hændelsesudløste kampagner indeholder den fulde taksonomi og ledningsføringen for indkøbskurv, onboarding og win-back.

Hvad du skal gøre nu, hvor du har en iOS push-notifikationer SDK

Integration er begyndelsen, ikke målstregen. Den hurtigst betalende sekvens: beskyt din opt-in-rate med et forberedt tilladelsesflow, send indkøbskurv-afvisningssekvensen (den højeste ROI-kampagne for e-handelsapps), tilføj målsætning, så hver kampagne rapporterer omsætning i stedet for åbninger, og byg derefter livscyklussen – onboarding-serie på front-end, win-back på back-end. App push marketing-guiden dækker dette strategilag fra ende til ende, og opsætningsdokumentationen gennemgår hver dashboard-skærm. Hver betalt plan har en 14-dages pengene-tilbage-garanti – og SDK'en er MIT-licenseret på GitHub, så du kan læse præcis, hvad du sender.