Historias push

Prerequisites

Before you can use this feature, you’ll need to integrate the Cordova Braze SDK. También tendrás que configurar las notificaciones push, lo que incluye implementar el framework UNNotification.

Se necesitan las siguientes versiones del SDK para recibir historias push:

Configuración de las 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 Firma y capacidades 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 Firma y capacidades de Xcode, añade la capacidad Grupos de aplicaciones a tu objetivo de aplicación principal, así como a los objetivos 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:

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)