Stories por push

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Swift Braze SDK. Você também precisará configurar notificações por push, o que inclui a implementação da estrutura UNNotification.

A seguinte versão mínima do SDK é necessária para receber o Push Stories:

Configurando o Push Stories

Etapa 1: Adicionando o alvo de Extensão de Conteúdo de Notificação

No seu projeto de app, Acessar o menu Arquivo > Novo > Alvo e adicionar um novo Notification Content Extension alvo e ativá-lo.

O Xcode deve gerar um novo alvo e criar arquivos automaticamente para você, incluindo:

• NotificationViewController.swift
• MainInterface.storyboard

Etapa 2: Ativar capacidades

No Xcode, adicione o recurso Background Modes usando o painel Signing & Capabilities ao destino principal do app. Selecione as caixas de seleção Busca em segundo plano e Notificações remotas.

Adicionando um grupo de app

Além disso, no painel Signing & Capabilities (Recursos de ) no Xcode, adicione o recurso App Groups (Grupos de aplicativos) ao destino de seu aplicativo principal, bem como aos destinos Notification Content Extension (Extensão de conteúdo de notificação). Em seguida, clique no botão +. Use o ID do pacote do seu app para criar o grupo de app. Por exemplo, se o ID do pacote do seu app for com.company.appname, você pode nomear seu grupo de app group.com.company.appname.xyz.

Se você não adicionar seu app a um grupo de app, seu app pode falhar em preencher certos campos da carga útil do push e não funcionará totalmente como esperado.

Etapa 3: Adicionando o framework de story por push ao seu app

• 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 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

Etapa 4: Atualizando seu controlador de visualização de notificações

Em NotificationViewController.swift, adicione a seguinte linha para importar os arquivos de cabeçalho:

1
import BrazePushStory

Em seguida, substitua a implementação padrão herdando BrazePushStory.NotificationViewController:

1
class NotificationViewController: BrazePushStory.NotificationViewController {}

Eventos de story por push de manipulação personalizada

Se você quiser implementar sua própria lógica personalizada para lidar com eventos de notificação de story por push, herde BrazePushStory.NotificationViewController como acima e substitua os métodos didReceive como abaixo.

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

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // Custom handling logic
  }
  
  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)
    
    // Custom handling logic
  }
}

Etapa 5: Definindo a extensão de conteúdo de notificação plist

Abra o Info.plist arquivo do Notification Content Extension, depois adicione e altere as seguintes chaves em NSExtension \ NSExtensionAttributes:

Seu Info.plist arquivo deve corresponder à seguinte imagem:

Etapa 6: Atualizando a integração da Braze no seu app principal

Antes de inicializar o Braze, atribua o nome do seu grupo de app à propriedade push.appGroup da configuração do 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)