Hoe een iOS Pushmeldingen SDK te gebruiken voor uw app (met code)

Een iOS pushmeldingen SDK doet twee dingen: het regelt de infrastructuur tussen je app en de Apple Push Notification service, en het verbindt die infrastructuur met een campagneplatform zodat je marketingteam het daadwerkelijk kan gebruiken. Deze handleiding behandelt beide: de echte integratiestappen met de code die je gaat leveren, en wat er mogelijk wordt in het dashboard zodra de SDK is geïnstalleerd. Het weerspiegelt de PushEngage iOS SDK 1.0, de huidige release.

Waarom een iOS pushmeldingen SDK gebruiken voor je app

Je kunt rechtstreeks met APNs praten: registreer voor een apparaattoken, bouw een verzender, handel zelf leveringscallbacks af. Wat je krijgt van ruwe APNs is levering; wat je niet krijgt is alles wat marketing nodig heeft: segmentatie, geplande en getriggerde campagnes, A/B-testen, analyses en inkomstentoewijzing. Een SDK zoals die van PushEngage verbindt je app eenmalig met die laag, zodat campagnes worden aangemaakt in een dashboard in plaats van in een Xcode-project. Het praktische resultaat: na de integratieweek stoppen pushcampagnes met het zijn van technische tickets.

Hoe de PushEngage iOS pushmeldingen SDK te installeren

Je hebt iOS 12+, Xcode 15+, een APNs-sleutel geüpload naar je PushEngage-dashboard en ongeveer een middag nodig. De SDK wordt geleverd als twee modules: PushEngage voor je app-doel en PushEngageExtension voor notificatie-extensiedoelen.

Stap 1: Voeg het pakket toe

Ga in Xcode naar Bestand → Pakketafhankelijkheden toevoegen en voer de repository-URL in - of gebruik 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

Stap 2: Configureer de App Group

Voeg de App Groups-mogelijkheid toe aan je app-doel en elk notificatie-extensiedoel, met dezelfde groeps-ID, en declareer deze in de Info.plist van elk doel:

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

De app en zijn extensies delen abonneestatus via deze container. Het overslaan hiervan is de meest voorkomende integratiefout - zonder dit starten je extensies leeg bij elke levering.

Stap 3: Initialiseren en toestemming vragen

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

Waar je die toestemmingsoproep plaatst, is belangrijker dan al het andere in deze handleiding - iOS geeft je precies één native prompt. De handleiding voor toestemmingspriming behandelt het soft-ask-patroon dat deze beschermt.

Hoe rijke app pushmeldingen voor iOS te verzenden

Afbeeldingen, actieknoppen en aangepaste geluiden vereisen een Notification Service Extension - een klein doel dat elke melding onderschept en media toevoegt vóór weergave. Voeg het doel toe in Xcode, koppel PushEngageExtension eraan, en forward de twee levenscyclusaanroepen:

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

Vanaf daar is rich media een dashboardfunctie: uw marketingteam voegt de productafbeelding of de hoofdgraphic toe wanneer ze de campagne bouwen, en de extensie rendert deze. Geen verdere app-wijzigingen per campagne.

Hoe u gepersonaliseerde iOS pushmeldingen maakt

Personalisatie werkt op basis van wat de SDK weet over elke abonnee. Identificeer uw gebruiker en koppel attributen, en elke campagne kan daartegen segmenteren en sjablonen maken:

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

Herhaalde identify-aanroepen met ongewijzigde gegevens worden lokaal afgebroken, dus het is veilig om deze bij elke lancering aan te roepen. Zodra attributen stromen, gebeurt segmentatie in het dashboard — 'klanten van topkwaliteit outerwear in Texas' wordt een opgeslagen publiek, geen SQL-verzoek.

Hoe u een deep link toevoegt aan iOS pushmeldingen

Elke campagneklik moet landen op het scherm dat beloofd werd. Stel de meldingsafhandelaar voor het openen eenmalig in, routeer op de deep link die deze meedraagt:

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

De marketeer plakt de deep link in het campagneformulier; uw handler regelt de routering. Volledige patronen — inclusief universele links en de optie voor automatisch openen — vindt u in de handleiding voor deep linking.

Hoe u campagnes triggert vanuit app-gebeurtenissen

De trackEvent-aanroep van de 1.0 SDK verandert elk gedrag in de app in een campagnetrigger — een verlaten winkelwagen, een voltooide onboardingstap, een bekeken categorie:

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

Instrumenteer de gebeurtenis eenmalig; marketing bouwt en itereert de campagnes ertegen voor onbepaalde tijd. De handleiding voor gebeurtenisgestuurde campagnes bevat de volledige taxonomie en de configuratie voor winkelwagens, onboarding en win-back.

Wat te doen nu u een iOS pushmeldingen SDK heeft

Integratie is het begin, niet de finishlijn. De reeks die het snelst loont: bescherm uw opt-in-percentage met een voorbereide toestemmingsstroom, lever de reeks voor verlaten winkelwagens (de campagne met de hoogste ROI voor e-commerce-apps), voeg doeltracking toe zodat elke campagne inkomsten rapporteert in plaats van opens, en bouw vervolgens het levenscyclus uit — onboarding-serie aan de voorkant, win-back aan de achterkant. De handleiding voor app pushmarketing behandelt die strategielaag van begin tot eind, en de installatiedocumentatie leidt u door elke dashboardpagina. Elk betaald abonnement heeft een 14-daagse niet-goed-geld-teruggarantie — en de SDK is MIT-gelicentieerd op GitHub, dus u kunt precies lezen wat u levert.