Så här använder du ett iOS Push Notifications SDK för din app (med kod)

Ett SDK för iOS push-notiser gör två saker: det hanterar kopplingen mellan din app och Apples Push Notification-tjänst, och det kopplar den kopplingen till en kampanjplattform så att ditt marknadsföringsteam faktiskt kan använda den. Den här guiden täcker båda – de verkliga integrationsstegen med den kod du kommer att leverera, och vad som blir möjligt i instrumentpanelen när SDK:t är installerat. Den återspeglar PushEngage iOS SDK 1.0, den aktuella versionen.

Varför använda ett SDK för iOS push-notiser för din app

Du kan kommunicera direkt med APNs – registrera dig för en enhetstoken, bygga en avsändare, hantera leveransåteranrop själv. Vad du får från rå APNs är leverans; vad du inte får är allt som marknadsföring behöver: segmentering, schemalagda och utlösta kampanjer, A/B-testning, analys och intäktsattribution. Ett SDK som PushEngages kopplar din app till det lagret en gång, så att kampanjer skapas i en instrumentpanel istället för ett Xcode-projekt. Det praktiska resultatet: efter integrationsveckan slutar push-kampanjer att vara ingenjörsbiljetter.

Hur man installerar PushEngage iOS push-notiser SDK

Du behöver iOS 12+, Xcode 15+, en APNs-nyckel uppladdad till din PushEngage-instrumentpanel, och ungefär en eftermiddag. SDK:t levereras som två moduler: PushEngage för din app-mål och PushEngageExtension för notis-tilläggsmål.

Steg 1: Lägg till paketet

I Xcode, gå till Arkiv → Lägg till paketsberoenden och ange lagringsplatsens URL – eller använd 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

Steg 2: Konfigurera App Group

Lägg till App Groups-kapaciteten till din app-mål och varje notis-tilläggsmål, med samma grupp-ID, och deklarera det i varje måls Info.plist:

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

Appen och dess tillägg delar prenumerantstatus genom denna container. Att hoppa över detta är det enskilt vanligaste integrationsmisstaget – utan det startar dina tillägg tomma vid varje leverans.

Steg 3: Initiera och begär tillstånd

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

Var du placerar det tillståndsanropet spelar större roll än något annat i den här guiden – iOS ger dig exakt en inbyggd prompt. Guiden för tillståndsförberedelse täcker mönstret för mjuk fråga som skyddar den.

Hur man skickar rich app push-notiser för iOS

Bilder, åtgärdsknappar och anpassade ljud kräver ett Notification Service Extension – ett litet mål som avlyssnar varje notis och bifogar media före visning. Lägg till målet i Xcode, länka PushEngageExtension till det, och vidarebefordra de två livscykelsamtalen:

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

Därifrån är rich media en funktion i instrumentpanelen: ditt marknadsföringsteam kopplar produktbilden eller huvudgrafiken när de skapar kampanjen, och tillägget renderar den. Inga ytterligare appändringar per kampanj.

Hur man skapar personliga iOS push-notiser

Personalisering körs på vad SDK:et vet om varje prenumerant. Identifiera din användare och koppla attribut, och varje kampanj kan segmentera och mallas mot 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 }

Upprepade identify-anrop med oförändrad data avbryts lokalt, så det är säkert att anropa det vid varje start. När attributen har flödat sker segmentering i instrumentpanelen – ”gold-tier outerwear shoppers in Texas” blir en sparad målgrupp, inte en SQL-fråga.

Hur man lägger till en djup länk i iOS push-notiser

Varje kampanjtryckning bör landa på skärmen den lovade. Ställ in hanteraren för öppning av notiser en gång, dirigera baserat på den djupa länk den bär:

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

Marknadsföraren klistrar in den djupa länken i kampanjformuläret; din hanterare sköter dirigeringen. Fullständiga mönster – inklusive universella länkar och alternativet för automatisk öppning – finns i guiden för djupa länkar.

Hur man utlöser kampanjer från app-händelser

1.0 SDK:ets trackEvent-anrop förvandlar all beteende i appen till en kampanjutlösare – en övergiven kundvagn, ett slutfört onboarding-steg, en genomsökt kategori:

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

Instrumentera händelsen en gång; marknadsföring skapar och itererar kampanjer mot den på obestämd tid. Guiden för händelseutlösta kampanjer har hela taxonomin och kopplingarna för kundvagn, onboarding och återaktivering.

Vad du ska göra nu när du har ett iOS push-notiser SDK

Integration är början, inte mållinjen. Sekvensen som ger snabbast utdelning: skydda din opt-in-frekvens med ett förberett tillståndflöde, skicka ut sekvensen för övergivna kundvagnar (den kampanj med högst ROI för e-handelsappar), lägg till målföljning så att varje kampanj rapporterar intäkter istället för öppningar, och bygg sedan ut livscykeln – onboarding-serier i front-end, återaktivering i back-end. Guiden för app push-marknadsföring täcker det strategiska lagret från ände till ände, och installationsdokumentationen guidar genom varje skärm i instrumentpanelen. Varje betald plan har en 14-dagars pengarna-tillbaka-garanti – och SDK:et är MIT-licensierat på GitHub, så du kan läsa exakt vad du skickar.