Cómo usar un SDK de notificaciones push de iOS para tu aplicación (con código)

Un SDK de notificaciones push para iOS hace dos cosas: maneja la conexión entre tu app y el servicio de notificaciones push de Apple, y conecta esa conexión a una plataforma de campañas para que tu equipo de marketing pueda usarla. Esta guía cubre ambos aspectos: los pasos reales de integración con el código que enviarás, y lo que se vuelve posible en el panel una vez que el SDK está instalado. Refleja el SDK de PushEngage para iOS 1.0, la versión actual.

Por qué usar un SDK de notificaciones push para iOS en tu app

Puedes hablar directamente con APNs: registrar un token de dispositivo, crear un remitente, manejar las devoluciones de llamada de entrega tú mismo. Lo que obtienes de APNs en bruto es la entrega; lo que no obtienes es todo lo que marketing necesita: segmentación, campañas programadas y disparadas, pruebas A/B, análisis y atribución de ingresos. Un SDK como el de PushEngage conecta tu app a esa capa una vez, para que las campañas se creen en un panel en lugar de en un proyecto de Xcode. El resultado práctico: después de la semana de integración, las campañas push dejan de ser tickets de ingeniería.

Cómo instalar el SDK de notificaciones push para iOS de PushEngage

Necesitarás iOS 12+, Xcode 15+, una clave APNs subida a tu panel de PushEngage y aproximadamente una tarde. El SDK se distribuye como dos módulos: PushEngage para tu objetivo de app y PushEngageExtension para objetivos de extensión de notificación.

Paso 1: Añadir el paquete

En Xcode, ve a Archivo → Añadir dependencias de paquetes e introduce la URL del repositorio, o 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

Paso 2: Configurar el Grupo de Apps

Añade la capacidad Grupos de Apps a tu objetivo de app y a cada objetivo de extensión de notificación, usando el mismo ID de grupo, y decláralo en el Info.plist de cada objetivo:

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

La app y sus extensiones comparten el estado del suscriptor a través de este contenedor. Omitirlo es el error de integración más común: sin él, tus extensiones se inician en blanco en cada entrega.

Paso 3: Inicializar y solicitar permiso

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

Dónde coloques esa llamada de permiso importa más que cualquier otra cosa en esta guía: iOS te concede exactamente un aviso nativo. La guía de preparación de permisos cubre el patrón de solicitud suave que lo protege.

Cómo enviar notificaciones push enriquecidas para apps iOS

Las imágenes, botones de acción y sonidos personalizados requieren una Extensión de Servicio de Notificación: un pequeño objetivo que intercepta cada notificación y adjunta medios antes de mostrarla. Añade el objetivo en Xcode, enlaza PushEngageExtension a él y reenvía las dos llamadas del ciclo de vida:

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

Desde allí, los elementos multimedia enriquecidos son una característica del panel: tu equipo de marketing adjunta la imagen del producto o el gráfico principal al crear la campaña, y la extensión la renderiza. No se necesitan más cambios en la aplicación por campaña.

Cómo crear notificaciones push personalizadas para iOS

La personalización se basa en lo que el SDK sabe de cada suscriptor. Identifica a tu usuario y adjunta atributos, y cada campaña puede segmentar y usar plantillas en función de ellos:

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

Repetir las llamadas a identify con datos sin cambios se cortocircuita localmente, por lo que llamar a esta función en cada inicio es seguro. Una vez que los atributos fluyen, la segmentación se realiza en el panel: "compradores de ropa de abrigo de nivel oro en Texas" se convierte en una audiencia guardada, no en una solicitud SQL.

Cómo añadir un enlace profundo en notificaciones push para iOS

Cada toque en una campaña debe aterrizar en la pantalla prometida. Configura el manejador de apertura de notificaciones una vez y enruta según el enlace profundo que contenga:

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

El profesional de marketing pega el enlace profundo en el formulario de la campaña; tu manejador se encarga del enrutamiento. Los patrones completos, incluidos los enlaces universales y la opción de apertura automática, se encuentran en la guía de enlaces profundos.

Cómo activar campañas a partir de eventos de la aplicación

La llamada trackEvent del SDK 1.0 convierte cualquier comportamiento dentro de la aplicación en un desencadenante de campaña: un carrito abandonado, un paso de incorporación completado, una categoría explorada:

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

Instrumenta el evento una vez; marketing crea e itera las campañas basándose en él indefinidamente. La guía de campañas activadas por eventos contiene la taxonomía completa y la configuración de carritos, incorporación y recuperación.

Qué hacer ahora que tienes un SDK de notificaciones push para iOS

La integración es el principio, no la línea de meta. La secuencia que da mejores resultados más rápido: protege tu tasa de opt-in con un flujo de permisos preparado, envía la secuencia de abandono de carritos (la campaña de mayor ROI para aplicaciones de comercio), añade seguimiento de objetivos para que cada campaña informe de ingresos en lugar de aperturas, y luego crea el ciclo de vida: series de incorporación en el front-end, recuperación en el back-end. La guía de marketing de push para aplicaciones cubre esa capa estratégica de principio a fin, y la documentación de configuración recorre cada pantalla del panel. Cada plan de pago incluye una garantía de devolución de dinero de 14 días, y el SDK tiene licencia MIT en GitHub, por lo que puedes leer exactamente lo que estás enviando.