Notificaciones enriquecidas de iOS 10

iOS 10 introduce la posibilidad de enviar notificaciones push con imágenes, GIF y video. Para habilitar esta funcionalidad, los clientes deben crear un Service Extension, un nuevo tipo de extensión que permite modificar una carga útil push antes de que se muestre.

Crear una extensión de servicio

Para crear Notification Service Extension, ve a Archivo > Nuevo > Destino en Xcode y selecciona Extensión de 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.

Configuración de la extensión del servicio

Un Notification Service Extension 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 Notification Service Extension 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.

Configurar la extensión de servicio para que funcione con Braze

Braze envía una carga útil adjunta en la carga de APN bajo la clave ab que utilizamos para configurar, descargar y mostrar contenido enriquecido. Por ejemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "ab" :
    {
    ...

    "att" :
      {
       "url" : "http://mysite.com/myimage.jpg",
       "type" : "jpg"
       }
    },
  "aps" :
    {
    ...
    }
}

Los valores relevantes de la carga útil son:

1
2
3
4
5
6
7
8
9
10
11
// The Braze dictionary key
static NSString *const AppboyAPNSDictionaryKey = @"ab";

// The attachment dictionary
static NSString *const AppboyAPNSDictionaryAttachmentKey = @"att";

// The attachment URL
static NSString *const AppboyAPNSDictionaryAttachmentURLKey = @"url";

// The type of the attachment - a suffix for the file you save
static NSString *const AppboyAPNSDictionaryAttachmentTypeKey = @"type";

Para mostrar manualmente el push con una carga útil Braze, descarga el contenido del valor en AppboyAPNSDictionaryAttachmentURLKey, guárdalo como un archivo con el tipo de archivo almacenado en la clave AppboyAPNSDictionaryAttachmentTypeKey, y añádelo a los archivos adjuntos de la notificación.

Ejemplo de código

Puedes escribir la extensión del servicio en Objective-C o Swift.

Para utilizar nuestro código de ejemplo Objective-C, sustituye el contenido del NotificationService.m autogenerado de tu destino Notification Service Extension por el contenido del código de ejemplo Appboy NotificationService.m.

Para utilizar nuestro código Swift de ejemplo, sustituye el contenido del NotificationService.swift autogenerado de tu destino Notification Service Extension por el contenido del Appboy NotificationService.swift.

Crear una notificación enriquecida en tu panel de control

Para crear una notificación push enriquecida en tu panel Braze, crea un push de iOS, 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 prever grandes picos sincrónicos de solicitudes si alojas tus contenidos.

Consulta unnotificationattachment para consultar la lista de tipos y tamaños de archivo admitidos.