Stories por push

Pré-requisitos

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

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

Configurando Push Stories

Etapa 1: Adicionando o alvo da Notification Content Extension

No projeto do seu app, acesse o menu File > New > Target e adicione um novo alvo Notification Content Extension e ative-o.

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

• NotificationViewController.swift
• MainInterface.storyboard

Etapa 2: Ativar capacidades

No Xcode, adicione a capacidade Background Modes usando o painel Signing & Capabilities ao alvo principal do app. Marque as caixas de seleção Background fetch e Remote notifications.

Adicionando um grupo de apps

Além disso, no painel Signing & Capabilities do Xcode, adicione a capacidade App Groups tanto ao alvo principal do app quanto aos alvos da Notification Content Extension. Em seguida, clique no botão +. Use o bundle ID do seu app para criar o grupo de apps. Por exemplo, se o bundle ID do seu app for com.company.appname, você pode nomear o grupo de apps como group.com.company.appname.xyz.

Importante

Neste contexto, grupos de apps referem-se ao App Groups Entitlement da Apple, e não ao ID do seu espaço de trabalho (anteriormente grupo de apps) da Braze.

Se você não adicionar seu app a um grupo de apps, ele poderá falhar ao preencher determinados campos da carga útil do push e não funcionará completamente como esperado.

Etapa 3: Adicionando o framework Push Story ao seu app

• swift package manager
• cocoapods
• manual

Depois de seguir o guia de integração do Swift Package Manager, adicione BrazePushStory à sua Notification Content Extension:

Adicione a seguinte linha ao seu Podfile:

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

Nota

Para saber mais sobre como implementar notificações por push avançadas, consulte Notificações por push avançadas.

Depois de atualizar o Podfile, navegue até o diretório do projeto do seu app no Xcode pelo terminal e execute pod install.

Baixe o BrazePushStory.zip mais recente na página de releases do GitHub, extraia-o e adicione o BrazePushStory.xcframework à Notification Content Extension do seu projeto.

Importante

Certifique-se de que Do Not Embed esteja selecionado para BrazePushStory.xcframework na coluna Embed.

Etapa 4: Atualizando o controlador de visualização de notificação

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 {}

Tratamento personalizado de eventos de Push Stories

Se você deseja implementar sua própria lógica personalizada para tratar eventos de notificação de Push Stories, herde BrazePushStory.NotificationViewController conforme mostrado no exemplo anterior e sobrescreva os métodos didReceive conforme o exemplo a seguir.

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: Configurando o plist da Notification Content Extension

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

Além disso, adicione o seguinte dicionário Braze de nível superior ao mesmo arquivo Info.plist, substituindo REPLACE_WITH_APPGROUP pelo grupo de apps que você criou na Etapa 2:

Seu arquivo Info.plist deve corresponder à imagem a seguir:

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

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