Notificaciones push enriquecidas

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.

Configuración de notificaciones push enriquecidas

Paso 1: Crear una extensión de servicio

Para crear una extensión del servicio de notificación, ve a Archivo > Nuevo > Destino en Xcode y selecciona Extensión del servicio de notificación.

Asegúrate de que la opción Incrustar en la aplicación está activada para incrustar la extensión en tu aplicación.

Paso 2: Configuración de la extensión del servicio de notificación

Una extensión del servicio de notificación es un binario propio que se incluye con tu aplicación. Debe configurarse en el Portal del Desarrollador de Apple con su propio ID de aplicación y perfil de aprovisionamiento.

El ID del paquete de la extensión del servicio de notificación debe ser distinto del ID del paquete de tu aplicación principal. Por ejemplo, si el ID del paquete de tu aplicación es com.company.appname, puedes utilizar com.company.appname.AppNameServiceExtension para la extensión de tu servicio.

Paso 3: Añadir un grupo de aplicaciones

En Xcode, añade la función Grupos de aplicaciones desde el panel Funciones& de firma a tu objetivo de aplicación principal, así como al objetivo Extensión del servicio 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.

Necesitas un grupo de aplicaciones compartido para que tu aplicación principal y la extensión del servicio de notificaciones puedan acceder a los datos compartidos. Si no añades tu aplicación a un grupo de aplicaciones, es posible que tu aplicación no pueda rellenar determinados campos de la carga útil de la notificación push y no funcione correctamente como se espera.

Paso 4: Integración de notificaciones push enriquecidas

Para una guía paso a paso sobre la integración de notificaciones push enriquecidas con BrazeNotificationService, consulta nuestro tutorial.

Para ver un ejemplo, consulta el uso en NotificationService de nuestra aplicación Ejemplos.

Añadir el framework de notificaciones push enriquecidas 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
  pod 'BrazePushStory'
end

Utilizar tu propia UNNotificationServiceExtension

Si necesitas utilizar tu propia UNNotificationServiceExtension, puedes llamar en su lugar a brazeHandle en tu método didReceive.

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

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(
    _ request: UNNotificationRequest,
    withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
  ) {
    if brazeHandle(request: request, contentHandler: contentHandler) {
      return
    }

    // Custom handling here

    contentHandler(request.content)
  }
}

Paso 5: Configuración del grupo de aplicaciones en Braze

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)

Paso 6: Crear una notificación enriquecida en tu panel de control

Tu equipo de marketing también puede crear notificaciones enriquecidas desde el panel. Crea una notificación push a través del compositor push y adjunta una imagen o un GIF, o proporciona una URL que aloje una imagen, un GIF o un video. Ten en cuenta que los activos se descargan al recibir las notificaciones push, por lo que debes prever grandes picos sincrónicos de solicitudes si alojas tus contenidos.