Guía de integración avanzada del SDK de iOS

Esta sección proporciona información sobre la integración avanzada del SDK de iOS de Pushwoosh.

Modos en segundo plano

Precaución

Por defecto, iOS no permite que las aplicaciones procesen notificaciones push cuando están en segundo plano. Esto incluye las notificaciones push silenciosas, que son útiles para actualizar los datos de la aplicación sin la interacción del usuario.

Para habilitar esta funcionalidad, debe añadir Modos en segundo plano a su proyecto.

Pasos para habilitar los modos en segundo plano

1. Abra su proyecto en Xcode y selecciónelo en el Project Navigator.
2. Elija el destino de su aplicación en el panel izquierdo.
3. Navegue a la pestaña Signing & Capabilities.
4. Haga clic en el botón + Capability en la esquina superior izquierda.
5. Busque y seleccione Background Modes de la lista.
6. En la sección Background Modes, habilite Remote notifications marcando la casilla.

Una vez completado, su aplicación podrá manejar notificaciones push, incluidas las silenciosas, mientras se ejecuta en segundo plano.

Modos en primer plano

Por defecto, el SDK de iOS de Pushwoosh muestra el banner de notificación cuando la aplicación se está ejecutando en primer plano.

Puede controlar este comportamiento configurando el siguiente indicador booleano en su código (es decir, en su AppDelegate):

Swift

// Set false to disable foreground notifications, true to enable it
Pushwoosh.sharedInstance().showPushnotificationAlert = true

Ejemplo (Swift)

Objective-C

// Set 0 to disable foreground notifications, 1 to enable it
[[Pushwoosh sharedInstance] setShowPushnotificationAlert:0];

Ejemplo (Objective-C)

Nivel de registro

El SDK de iOS de Pushwoosh admite los siguientes niveles de registro:

• NONE - No hay registros del SDK.
• ERROR - Muestra solo mensajes de error en la consola.
• WARNING - Muestra advertencias además de los errores.
• INFO - Incluye mensajes informativos (configuración predeterminada).
• DEBUG - Incluye información de depuración detallada.

Por defecto, el nivel de registro está configurado en INFO, asegurando que el SDK proporcione información relevante sin saturar la consola del desarrollador.

Para modificar el nivel de registro, actualice la clave Pushwoosh_LOG_LEVEL en el archivo Info.plist de su aplicación:

<key>Pushwoosh_LOG_LEVEL</key>
<string>YOUR_LOG_LEVEL</string>

Alternativamente, puede cambiar el nivel de registro usando el siguiente fragmento de código:

Pushwoosh.Debug.setLogLevel(.PW_LL_DEBUG)

Reemplace YOUR_LOG_LEVEL con el nivel deseado (por ejemplo, DEBUG o ERROR).

UNNotificationCenterDelegate personalizado

Si desea utilizar su propio UNNotificationCenterDelegate (por ejemplo, para notificaciones locales), debe informar al SDK de Pushwoosh para un comportamiento adecuado. Puede hacerlo con la propiedad notificationCenterDelegateProxy de la instancia de Pushwoosh:

Swift

Pushwoosh.sharedInstance()?.notificationCenterDelegateProxy.add(my_delegate)

Ejemplo (Swift)

Objective-C

[Pushwoosh.sharedInstance.notificationCenterDelegateProxy addNotificationCenterDelegate:my_delegate];

Ejemplo (Objective-C)

Luego, implemente los métodos UNNotificationCenterDelegate en su delegado:

Swift

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
) {
    if (!PWMessage.isPushwooshMessage(notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler(UNNotificationPresentationOptions.alert)
    }
}

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void
) {
    if (!PWMessage.isPushwooshMessage(response.notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler()
    }
}

Ejemplo (Swift)

Objective-C

- (void)userNotificationCenter:(UNNotificationCenter *)center
        willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
    if (![PWMessage isPushwooshMessage:notification.request.content.userInfo]) {
        // Handle your message
        completionHandler(UNNotificationPresentationOptionAlert);
    }
}

- (void)userNotificationCenter:(UNNotificationCenter *)center
        didReceiveNotificationResponse:(UNNotificationResponse *)response
        withCompletionHandler:(void (^)(void))completionHandler {
    if (![PWMessage.isPushwooshMessage:response.notification.request.content.userInfo]) {
        // Handle your message
        completionHandler();
    }
}

Ejemplo (Objective-C)

Inicialización diferida de Pushwoosh

El indicador Pushwoosh_LAZY_INITIALIZATION evita la inicialización automática del SDK de Pushwoosh cuando se inicia la aplicación. Esto permite un mayor control sobre cuándo se inician los servicios del SDK de Pushwoosh.

Cuando este indicador está habilitado, el SDK de Pushwoosh no inicia sus servicios hasta que se llaman explícitamente los métodos del SDK de iOS de Pushwoosh.

Añada la siguiente entrada a Info.plist:

<key>Pushwoosh_LAZY_INITIALIZATION</key>
<true/>

Casos de uso

1. Inicialización controlada del SDK – El indicador Pushwoosh_LAZY_INITIALIZATION permite retrasar el inicio del SDK de Pushwoosh, dando más control sobre cuándo se activan los servicios push.

2. Activación push diferida – En algunas aplicaciones, las notificaciones push solo deben inicializarse bajo condiciones específicas. Habilitar este indicador asegura que el SDK de Pushwoosh se inicie solo cuando se solicite explícitamente.

3. Configuración push específica del usuario – Algunas aplicaciones pueden requerir la personalización de la configuración de notificaciones push basada en las preferencias del usuario o la configuración de la cuenta. Con la inicialización diferida, el SDK de Pushwoosh se inicia solo después de que se determina la configuración adecuada.

Lista completa de propiedades de Info.plist

Propiedad	Descripción	Valores posibles
Pushwoosh_APPID	Establece el ID de aplicación de Pushwoosh para la compilación de producción.	XXXXX-XXXXX Tipo: String
Pushwoosh_APPID_Dev	Establece el ID de aplicación de Pushwoosh para la compilación de desarrollo.	XXXXX-XXXXX Tipo: String
Pushwoosh_SHOW_ALERT	Muestra la alerta de notificación en primer plano.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALERT_TYPE	Establece el estilo de alerta de notificación.	BANNER (predeterminado) / ALERT / NONE Tipo: String
Pushwoosh_BASEURL	Anula la URL base del servidor de Pushwoosh.	https://cp.pushwoosh.com/json/1.3/ (predeterminado) Tipo: String
Pushwoosh_AUTO_ACCEPT_DEEP_LINK_FOR_SILENT_PUSH	Si es YES, los Deep Links recibidos en notificaciones push silenciosas se procesarán automáticamente.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALLOW_SERVER_COMMUNICATION	Permite que el SDK envíe solicitudes de red a los servidores de Pushwoosh.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_DATA	Permite que el SDK recopile y envíe datos del dispositivo (versión del SO, configuración regional y modelo) al servidor.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_OS_VERSION	Permite que el SDK recopile y envíe la versión del SO del dispositivo al servidor.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_LOCALE	Permite que el SDK recopile y envíe la configuración regional del dispositivo al servidor.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_MODEL	Permite que el SDK recopile y envíe el modelo del dispositivo al servidor.	YES (predeterminado) / NO Tipo: Boolean
Pushwoosh_LOG_LEVEL	Nivel de registro del SDK de Pushwoosh. Para más detalles, consulte Control de nivel de registro.	NONE / ERROR / WARNING / INFO (predeterminado) / DEBUG / VERBOSE Tipo: String
Pushwoosh_PURCHASE_TRACKING_ENABLED	Permite que el SDK rastree las compras dentro de la aplicación. Necesario para Customer Journey Builder.	YES / NO (predeterminado) Tipo: Boolean