Historias push

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Swift Braze. También tendrás que configurar las notificaciones push, lo que incluye implementar elUNNotificationmarco.

Se requiere la siguiente versión mínima de SDK para recibir historias push:

Configuración de historias push

Paso 1: Añadir el objetivo de la extensión de contenido de notificación

En el proyecto de tu aplicación, ve al menú Archivo > Nuevo > Objetivo y añade un nuevo objetivo Notification Content Extension y actívalo.

Xcode debe generar un nuevo objetivo para usted y crear archivos automáticamente para ti, entre ellos:

• NotificationViewController.swift
• MainInterface.storyboard

Paso 2: Habilitar capacidades

En Xcode, añade la capacidad Modos de fondo utilizando el panel Capacidades& de firma al objetivo principal de la aplicación. Selecciona las casillas de verificación Obtención en segundo plano y Notificaciones remotas.

Añadir un grupo de aplicaciones

Además, desde el panel Capacidades& de firma de Xcode, añade la capacidad Grupos de aplicaciones a tu destino de aplicación principal, así como a los destinos de Extensión de contenido de notificaciones. Después, haz clic en el botón +. Utiliza el ID del paquete de tu aplicación para crear el grupo de aplicaciones. Por ejemplo, si el ID del paquete de tu aplicación es com.company.appname, puedes llamar a tu grupo de aplicaciones group.com.company.appname.xyz.

Si no añades tu aplicación a un grupo de aplicaciones, es posible que tu aplicación no rellene determinados campos de la carga útil push y no funcione completamente como se espera.

Paso 3: Añadir el framework de historias push a tu aplicación

• swift package manager
• cocoapods
• manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
target 'YourAppTarget' do
pod 'BrazeKit'
pod 'BrazeUI'
pod 'BrazeLocation'
end

target 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

Paso 4: Actualizar tu controlador de vista de notificación

En NotificationViewController.swift, añade la siguiente línea para importar los archivos de cabecera:

1
import BrazePushStory

A continuación, sustituye la implementación predeterminada heredando BrazePushStory.NotificationViewController:

1
class NotificationViewController: BrazePushStory.NotificationViewController {}

Manejo personalizado de eventos de historias push

Si quieres implementar tu propia lógica personalizada para gestionar eventos de notificación push de historias push, hereda BrazePushStory.NotificationViewController como se indica arriba y anula los métodos didReceive como se indica a continuación.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import BrazePushStory
import UserNotifications
import UserNotificationsUI

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // Custom handling logic
  }
  
  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)
    
    // Custom handling logic
  }
}

Paso 5: Configuración del plist de Extensión de Contenido de Notificación

Abre el archivo Info.plist del Notification Content Extension, luego añade y cambia las siguientes claves en NSExtension \ NSExtensionAttributes:

Además, añade el siguiente diccionarioBraze de nivel superior al mismoInfo.plistarchivo, sustituyendoREPLACE_WITH_APPGROUPpor el grupo de aplicaciones que has creado en el paso 2:

Tu archivo Info.plist debe coincidir con la siguiente imagen:

Paso 6: Actualizar la integración de Braze en tu aplicación principal

Antes de inicializar Braze, asigna el nombre de tu grupo de aplicaciones a la propiedad push.appGroup de tu configuración Braze.

1
2
3
4
let configuration = Braze.Configuration(apiKey: "<YOUR-BRAZE-API-KEY>",
                                        endpoint: "<YOUR-BRAZE-ENDPOINT>")
configuration.push.appGroup = "REPLACE_WITH_APPGROUP"
let braze = Braze(configuration: configuration)