Notificaciones push silenciosas

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.

Limitaciones de iOS

El sistema operativo iOS puede restringir las notificaciones para algunas características. Ten en cuenta que, si tienes dificultades con estas características, la restricción de notificaciones silenciosas de iOS podría ser la causa. Para más detalles, consulta la documentación de Apple sobre métodos de instancia y notificaciones no recibidas.

Configuración de notificaciones push silenciosas

Para utilizar notificaciones push silenciosas que desencadenen trabajo en segundo plano, debes configurar tu aplicación para recibir notificaciones incluso cuando esté en segundo plano. Para ello, añade la capacidad Background Modes utilizando el panel Signing & Capabilities al objetivo principal de la aplicación en Xcode. Selecciona la casilla Remote notifications.

Incluso con el modo en segundo plano de notificaciones remotas habilitado, el sistema no lanzará tu aplicación en segundo plano si el usuario ha forzado el cierre de la aplicación. El usuario debe iniciar la aplicación de forma explícita o reiniciar el dispositivo antes de que el sistema pueda lanzarla automáticamente en segundo plano.

Para más información, consulta pushing background updates y la documentación de application:didReceiveRemoteNotification:fetchCompletionHandler:.

Envío de notificaciones push silenciosas

Para enviar una notificación push silenciosa, establece el indicador content-available en 1 en la carga útil de una notificación push.

Nota

Lo que Apple llama notificación remota es simplemente una notificación push normal con el indicador content-available activado.

El indicador content-available se puede establecer en el panel de Braze, así como dentro de nuestro objeto push de Apple en la API de mensajería.

Advertencia

No se recomienda incluir tanto un título como un cuerpo con content-available=1, ya que puede provocar un comportamiento indefinido. Para garantizar que una notificación sea verdaderamente silenciosa, excluye tanto el título como el cuerpo al establecer el indicador content-available en 1. Para más información, consulta la documentación oficial de Apple sobre actualizaciones en segundo plano.

Al enviar una notificación push silenciosa, también puedes incluir algunos datos en la carga útil de la notificación, para que tu aplicación pueda hacer referencia al evento. Esto podría ahorrarte algunas solicitudes de red y mejorar la capacidad de respuesta de tu aplicación.

Ignorar las notificaciones push internas

Braze utiliza notificaciones push silenciosas para gestionar internamente ciertas características avanzadas, como Uninstall Tracking. Si tu aplicación realiza acciones automáticas al iniciar la aplicación o con push en segundo plano, considera controlar esa actividad para que no se desencadene por ninguna notificación push interna.

Por ejemplo, si tienes una lógica que llama a tus servidores para obtener contenido nuevo con cada push en segundo plano o inicio de la aplicación, es posible que desees evitar que se desencadenen los push internos de Braze para evitar tráfico de red innecesario. Dado que Braze envía ciertos tipos de push internos a todos los usuarios aproximadamente al mismo tiempo, podría producirse una carga significativa en el servidor si las llamadas de red al iniciar desde push internos no están controladas.

Paso 1: Comprueba las acciones automáticas en tu aplicación

Comprueba las acciones automáticas en los siguientes lugares de tu aplicación y actualiza tu código para ignorar los push internos de Braze:

1. Receptores de push. Las notificaciones push en segundo plano llamarán a application:didReceiveRemoteNotification:fetchCompletionHandler: en el UIApplicationDelegate.
2. Delegado de la aplicación. Los push en segundo plano pueden iniciar aplicaciones suspendidas en segundo plano, desencadenando los métodos application:willFinishLaunchingWithOptions: y application:didFinishLaunchingWithOptions: en tu UIApplicationDelegate. Comprueba las launchOptions de estos métodos para determinar si la aplicación se ha iniciado desde un push en segundo plano.

Paso 2: Usa el método de utilidad de push interno

Puedes usar el método de utilidad estático en Braze.Notifications para comprobar si tu aplicación ha recibido o fue iniciada por un push interno de Braze. Braze.Notifications.isInternalNotification(_:) devuelve true para todas las notificaciones push internas de Braze, que incluyen Uninstall Tracking y las notificaciones de sincronización de conmutadores de características.

Por ejemplo:

• swift
• objective-c

1
2
3
4
5
6
7

func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if (!Braze.Notifications.isInternalNotification(userInfo)) {
    // Gated logic here (for example pinging server for content)
  }
}

1
2
3
4
5

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
  if (![BRZNotifications isInternalNotification:userInfo]) {
    // Gated logic here (for example pinging server for content)
  }
}