Come utilizzare un SDK di notifiche push iOS per la tua app (con codice)

Un SDK per le notifiche push iOS svolge due compiti: gestisce la connessione tra la tua app e il servizio di notifica push di Apple, e collega tale connessione a una piattaforma di campagne in modo che il tuo team di marketing possa effettivamente utilizzarla. Questa guida copre entrambi gli aspetti: i passaggi di integrazione reali con il codice che spedirai e ciò che diventa possibile nella dashboard una volta che l'SDK è attivo. Riflette l'SDK PushEngage per iOS 1.0, la versione attuale.

Perché usare un SDK per le notifiche push iOS per la tua app

Puoi comunicare direttamente con APNs: registrarti per un token del dispositivo, creare un mittente, gestire tu stesso le callback di consegna. Ciò che ottieni da APNs grezzo è la consegna; ciò che non ottieni è tutto ciò di cui il marketing ha bisogno: segmentazione, campagne pianificate e attivate, test A/B, analisi e attribuzione dei ricavi. Un SDK come quello di PushEngage collega la tua app a quel livello una volta, in modo che le campagne vengano create in una dashboard invece che in un progetto Xcode. Il risultato pratico: dopo la settimana di integrazione, le campagne push smettono di essere ticket di ingegneria.

Come installare l'SDK per le notifiche push iOS di PushEngage

Avrai bisogno di iOS 12+, Xcode 15+, una chiave APNs caricata sulla tua dashboard PushEngage e circa un pomeriggio. L'SDK viene fornito come due moduli: PushEngage per il tuo target dell'app e PushEngageExtension per i target di estensione delle notifiche.

Passaggio 1: Aggiungi il pacchetto

In Xcode, vai su File → Add Package Dependencies e inserisci l'URL del repository, oppure usa 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

Passaggio 2: Configura l'App Group

Aggiungi la funzionalità App Groups al tuo target dell'app e a ogni target di estensione delle notifiche, utilizzando lo stesso ID di gruppo, e dichiaralo nel file Info.plist di ciascun target:

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

L'app e le sue estensioni condividono lo stato dell'abbonato tramite questo container. Saltarlo è l'errore di integrazione più comune: senza di esso, le tue estensioni si avviano vuote ad ogni consegna.

Passaggio 3: Inizializza e richiedi il permesso

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

Dove inserisci quella chiamata di permesso è più importante di qualsiasi altra cosa in questa guida: iOS ti concede esattamente un prompt nativo. La guida al permission priming copre il modello di richiesta soft che lo protegge.

Come inviare notifiche push avanzate per app iOS

Immagini, pulsanti di azione e suoni personalizzati richiedono una Notification Service Extension: un piccolo target che intercetta ogni notifica e allega i media prima della visualizzazione. Aggiungi il target in Xcode, collega PushEngageExtension ad esso e inoltra le due chiamate del ciclo di vita:

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

Da lì, i contenuti multimediali avanzati sono una funzionalità della dashboard: il tuo team di marketing allega l'immagine del prodotto o la grafica principale quando crea la campagna e l'estensione la renderizza. Nessuna ulteriore modifica all'app per campagna.

Come creare notifiche push iOS personalizzate

La personalizzazione si basa su ciò che l'SDK sa di ogni abbonato. Identifica il tuo utente e allega attributi, e ogni campagna può segmentare e creare modelli in base ad essi:

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

Le chiamate identify ripetute con dati invariati si interrompono localmente, quindi chiamarla ad ogni avvio è sicuro. Una volta che gli attributi fluiscono, la segmentazione avviene nella dashboard: "acquirenti di capispalla di fascia alta in Texas" diventa un pubblico salvato, non una richiesta SQL.

Come aggiungere un deep link nelle notifiche push iOS

Ogni tocco di campagna dovrebbe atterrare sulla schermata promessa. Imposta l'handler di apertura della notifica una volta, reindirizza in base al deep link che trasporta:

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

Il marketer incolla il deep link nel modulo della campagna; il tuo handler si occupa del reindirizzamento. I modelli completi, inclusi i link universali e l'opzione di apertura automatica, sono nella guida ai deep link.

Come attivare campagne dagli eventi dell'app

La chiamata trackEvent dell'SDK 1.0 trasforma qualsiasi comportamento in-app in un trigger di campagna: un carrello abbandonato, un passaggio di onboarding completato, una categoria visualizzata:

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

Strumenta l'evento una volta; il marketing crea e itera le campagne su di esso indefinitamente. La guida alle campagne attivate da eventi contiene la tassonomia completa e il cablaggio per carrello, onboarding e recupero.

Cosa fare ora che hai un SDK per notifiche push iOS

L'integrazione è l'inizio, non il traguardo. La sequenza che paga più velocemente: proteggi il tuo tasso di opt-in con un flusso di permessi preparato, spedisci la sequenza di abbandono del carrello (la campagna con il ROI più alto per le app di e-commerce), aggiungi il tracciamento degli obiettivi in modo che ogni campagna riporti le entrate invece delle aperture, e poi costruisci il ciclo di vita: serie di onboarding nella parte anteriore, recupero nella parte posteriore. La guida al marketing push per app copre questo livello strategico end-to-end, e la documentazione di configurazione illustra ogni schermata della dashboard. Ogni piano a pagamento include una garanzia di rimborso di 14 giorni e l'SDK è concesso in licenza MIT su GitHub, quindi puoi leggere esattamente cosa stai spedendo.