Configuración de historias push

La función de historias push requiere el framework UNNotification y iOS 10. La función solo está disponible a partir de la versión 3.2.1 del SDK de iOS.

Paso 1: Habilitar push en tu aplicación

Sigue la integración de notificaciones push para habilitar el push en tu aplicación.

Paso 2: Añadir el objetivo de la extensión de contenido de notificación

En el proyecto de tu aplicación, ve al menú Archivo > Nuevo > Objetivo… y añade un nuevo objetivo Notification Content Extension y actívalo.

Xcode debe generar un nuevo objetivo para usted y crear archivos automáticamente para ti, entre ellos:

• objective-c
• swift

Paso 3: Habilitar capacidades

La característica Historias push requiere el modo de fondo en la sección Capacidades del objetivo principal de la aplicación. Después de activar los modos en segundo plano, selecciona Background fetch y Remote notifications.

Añadir un grupo de aplicaciones

También hay que añadir Capability App Groups. Si no tienes ningún grupo de aplicaciones en tu aplicación, ve a la Capacidad del objetivo principal de la aplicación, activa App Groups, y 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. Debes activar App Groups tanto para la aplicación principal como para las extensiones de contenido.

Si no añades tu aplicación a un grupo de aplicaciones, es posible que tu aplicación no rellene determinados campos de la carga útil push y no funcione completamente como se espera.

Paso 4: Añadir el framework de historias push a tu aplicación

• swift package manager
• cocoapods
• manual

1
2
3
target 'YourContentExtensionTarget' do
  pod 'Appboy-Push-Story'
end

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

• objective-c
• swift

1
#import <AppboyPushStory/AppboyPushStory.h>

1
2
@property (nonatomic) IBOutlet ABKStoriesView *storiesView;
@property (nonatomic) ABKStoriesViewDataSource *dataSource;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@implementation NotificationViewController

- (void)didReceiveNotification:(UNNotification *)notification {
  self.dataSource = [[ABKStoriesViewDataSource alloc] initWithNotification:notification
                                                               storiesView:self.storiesView
                                                                  appGroup:@"YOUR-APP-GROUP-IDENTIFIER"];
}

- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response
                     completionHandler:(void (^)(UNNotificationContentExtensionResponseOption option))completion {
  UNNotificationContentExtensionResponseOption option = [self.dataSource didReceiveNotificationResponse:response];
  completion(option);
}

- (void)viewWillDisappear:(BOOL)animated {
  [self.dataSource viewWillDisappear];
  [super viewWillDisappear:animated];
}

@end

1
import AppboyPushStory

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
class NotificationViewController: UIViewController, UNNotificationContentExtension {

  @IBOutlet weak var storiesView: ABKStoriesView!
  var dataSource: ABKStoriesViewDataSource?
    
  func didReceive(_ notification: UNNotification) {
    dataSource = ABKStoriesViewDataSource(notification: notification, storiesView: storiesView, appGroup: "YOUR-APP-GROUP-IDENTIFIER")
  }
    
  func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    if dataSource != nil {
      let option: UNNotificationContentExtensionResponseOption = dataSource!.didReceive(response)
      completion(option)
    }
  }
    
  override func viewWillDisappear(_ animated: Bool) {
    dataSource?.viewWillDisappear()
    super.viewWillDisappear(animated)
  }
}

Paso 6: Configura el guión gráfico de la extensión del contenido de la notificación

Abre el guión gráfico de Notification Content Extension y coloca un nuevo UIView en el controlador de la vista de notificación. Cambia el nombre de la clase a ABKStoriesView. Haz que la anchura y la altura de la vista se ajusten automáticamente al marco de la vista principal del controlador de la vista de notificación.

A continuación, enlaza el IBOutlet storiesView del controlador de la vista de notificación con el ABKStoriesView añadido.

Paso 7: Configura el plist de extensión del contenido de las notificaciones

Abre el archivo Info.plist de Notification Content Extension y añade y cambia las siguientes claves en NSExtension \ NSExtensionAttributes:

UNNotificationExtensionCategory = ab_cat_push_story_v2 ( tipoString ) UNNotificationExtensionDefaultContentHidden = YES ( tipoBoolean ) UNNotificationExtensionInitialContentSizeRatio = 0.65 ( tipoNumber )

Paso 8: Actualizar la integración de Braze en tu aplicación principal

Opción 1: Tiempo de ejecución

En el diccionario appboyOptions utilizado para configurar tu instancia de Braze, añade una entrada ABKPushStoryAppGroupKey y establece el valor de tu identificador de la API de tu espacio de trabajo.

• objective-c
• swift

1
2
3
4
5
6
NSMutableDictionary *appboyOptions = [NSMutableDictionary dictionary];
appboyOptions[ABKPushStoryAppGroupKey] = @"YOUR-APP-GROUP-IDENTIFIER";
[Appboy startWithApiKey:@"YOUR-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

1
2
3
4
let appboyOptions: [AnyHashable: Any] = [
  ABKPushStoryAppGroupKey : "YOUR-APP-GROUP-IDENTIFIER"
]
Appboy.start(withApiKey: "YOUR-API-KEY", in:application, withLaunchOptions:launchOptions, withAppboyOptions:appboyOptions)

Opción 2: Info.plist

Alternativamente, para configurar el espacio de trabajo de historias push desde tu archivo Info.plist, añade un diccionario llamado Braze a tu archivo Info.plist. Dentro del diccionario Braze, añade una subentrada de tipo cadena PushStoryAppGroup y establece el valor en el identificador de tu espacio de trabajo. Ten en cuenta que, antes de la versión 4.0.2 del SDK de iOS de Braze, debe usarse la clave de diccionario Appboy en lugar de Braze.

Próximos pasos

A continuación, consulta los pasos para la integración de botones de acción, necesaria para que los botones se muestren en un mensaje de historias push.