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 del servicio

Para crear una extensión del servicio de notificación, en Xcode ve a File > New > Target y selecciona Notification Service Extension.

Asegúrate de que Embed In Application esté configurado para incrustar la extensión en tu aplicación.

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

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

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

Paso 3: Añadir un grupo de aplicaciones

En Xcode, añade la capacidad App Groups desde el panel Signing & Capabilities tanto a tu destino principal de la aplicación como al destino de la extensión del servicio 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 a los App Groups Entitlement de Apple y no al ID de tu espacio de trabajo de Braze (anteriormente grupo de aplicaciones).

Necesitas un grupo de aplicaciones compartido para que tu aplicación principal y la extensión del servicio de notificación puedan acceder a datos compartidos. Si no añades tu aplicación a un grupo de aplicaciones, tu aplicación podría no poder rellenar ciertos campos de la carga útil del push y no funcionará completamente como se espera.

Paso 4: Integrar notificaciones push enriquecidas

Para obtener 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 de ejemplos.

Añadir el framework de push enriquecido a tu aplicación

• swift package administrador
• cocoapods
• manual

Después de seguir la guía de integración de Swift Package Administrador, añade BrazeNotificationService a tu Notification Service Extension haciendo lo siguiente:

1. En Xcode, en frameworks y bibliotecas, selecciona el icono para añadir un framework.
   
   
   
   

2. Selecciona el framework “BrazeNotificationService”.
   
   

Añade lo siguiente 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

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

Nota

Para obtener instrucciones sobre cómo implementar Push Stories, consulta la documentación.

Después de actualizar el archivo de bibliotecas, ve al directorio de tu proyecto de Xcode dentro de tu terminal y ejecuta pod install.

Para añadir BrazeNotificationService.xcframework a tu Notification Service Extension, consulta Integración manual.

Usar tu propio UNNotificationServiceExtension

Si necesitas usar tu propio UNNotificationServiceExtension, puedes en su lugar llamar 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: Configurar el grupo de aplicaciones en Braze

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)

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

Tu equipo de marketing también puede crear notificaciones enriquecidas desde el panel. Crea una notificación push a través del creador de push y adjunta una imagen o GIF, o proporciona una URL que aloje una imagen, GIF o video. Ten en cuenta que los activos se descargan al recibir las notificaciones push, por lo que debes planificar grandes picos síncronos en las solicitudes si alojas tu propio contenido.