Historias push

Requisitos previos

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

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

Configuración de historias push

Paso 1: Agregar el objetivo de la extensión de contenido de notificación

En el proyecto de tu aplicación, ve al menú File > New > Target y agrega un nuevo objetivo Notification Content Extension y actívalo.

Xcode debería generar un nuevo objetivo y crear archivos automáticamente para ti, incluyendo:

• NotificationViewController.swift
• MainInterface.storyboard

Paso 2: Habilitar capacidades

En Xcode, agrega la capacidad Background Modes usando el panel Signing & Capabilities al objetivo principal de la aplicación. Selecciona las casillas de verificación Background fetch y Remote notifications.

Agregar un grupo de aplicaciones

Además, desde el panel Signing & Capabilities en Xcode, agrega la capacidad App Groups tanto al objetivo principal de tu aplicación como a los objetivos de la extensión de contenido de notificación. Luego, haz clic en el botón +. Usa el ID de paquete de tu aplicación para crear el grupo de aplicaciones. Por ejemplo, si el ID de paquete de tu aplicación es com.company.appname, puedes nombrar tu grupo de aplicaciones group.com.company.appname.xyz.

Importante

Los grupos de aplicaciones en este contexto se refieren al App Groups Entitlement de Apple y no al ID de tu espacio de trabajo de Braze (anteriormente grupo de aplicaciones).

Si no agregas tu aplicación a un grupo de aplicaciones, es posible que tu aplicación no logre completar ciertos campos de la carga útil del push y no funcionará completamente como se espera.

Paso 3: Agregar el framework de historias push a tu aplicación

• swift package manager
• cocoapods
• manual

Después de seguir la guía de integración de Swift Package Manager, agrega BrazePushStory a tu Notification Content Extension:

Agrega la siguiente línea a tu archivo de bibliotecas:

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

Nota

Para instrucciones sobre cómo implementar notificaciones push enriquecidas, consulta Notificaciones enriquecidas.

Después de actualizar el archivo de bibliotecas, navega al directorio del proyecto de tu aplicación Xcode dentro de tu terminal y ejecuta pod install.

Descarga el último BrazePushStory.zip de la página de lanzamientos de GitHub, extráelo y agrega BrazePushStory.xcframework a la Notification Content Extension de tu proyecto.

Importante

Asegúrate de que Do Not Embed esté seleccionado para BrazePushStory.xcframework en la columna Embed.

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

En NotificationViewController.swift, agrega la siguiente línea para importar los archivos de encabezado:

1

import BrazePushStory

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

1

class NotificationViewController: BrazePushStory.NotificationViewController {}

Manejo personalizado de eventos de historias push

Si deseas implementar tu propia lógica personalizada para manejar los eventos de notificación de historias push, hereda BrazePushStory.NotificationViewController como se muestra en el ejemplo anterior y sobrescribe los métodos didReceive del siguiente ejemplo.

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: Configurar el plist de la extensión de contenido de notificación

Abre el archivo Info.plist de la Notification Content Extension, luego agrega y cambia las siguientes claves en NSExtension \ NSExtensionAttributes:

Además, agrega el siguiente diccionario Braze de nivel superior al mismo archivo Info.plist, reemplazando REPLACE_WITH_APPGROUP con el grupo de aplicaciones que creaste en el Paso 2:

Tu archivo Info.plist debería 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 la configuración de 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)