Notificações de Rich 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.

Configuração de notificações por push ricas

Etapa 1: Criar uma extensão de serviço

Para criar uma extensão de serviço de notificação, navegue até File > New > Target no Xcode e selecione Notification Service Extension.

Verifique se Embed In Application está configurado para incorporar a extensão no seu aplicativo.

Etapa 2: Configurar a extensão de serviço de notificação

Uma extensão de serviço de notificação é um binário próprio que é empacotado com seu app. Ela deve ser configurada no Apple Developer Portal com seu próprio app ID e perfil de provisionamento.

O bundle ID da extensão de serviço de notificação deve ser diferente do bundle ID do target principal do seu app. Por exemplo, se o bundle ID do seu app for com.company.appname, você pode usar com.company.appname.AppNameServiceExtension para a extensão de serviço.

Etapa 3: Adicionar um App Group

No Xcode, adicione a capacidade App Groups no painel Signing & Capabilities tanto ao target principal do app quanto ao target da Notification Service Extension. Em seguida, clique no botão +. Use o bundle ID do seu app para criar o app group. Por exemplo, se o bundle ID do seu app for com.company.appname, você pode nomear seu app group como group.com.company.appname.xyz.

Importante

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

Você precisa de um App Group compartilhado para que seu app principal e a Notification Service Extension possam acessar dados compartilhados. Se você não adicionar seu app a um app group, ele pode falhar ao preencher determinados campos da carga útil de push e não funcionará totalmente como esperado.

Etapa 4: Integrar notificações por push ricas

Para um guia passo a passo sobre como integrar notificações por push ricas com o BrazeNotificationService, consulte nosso tutorial.

Para ver um exemplo, consulte o uso em NotificationService do nosso app de exemplos.

Adicionar o framework de push rico ao seu app

• swift package manager
• cocoapods
• manual

Depois de seguir o guia de integração do Swift Package Manager, adicione o BrazeNotificationService à sua Notification Service Extension fazendo o seguinte:

1. No Xcode, em frameworks e libraries, selecione o ícone para adicionar um framework.
   
   
   
   

2. Selecione o framework “BrazeNotificationService”.
   
   

Adicione o seguinte 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
  pod 'BrazePushStory'
end

Nota

Para saber mais sobre a implementação de Push Stories, consulte Push Stories.

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

Para adicionar BrazeNotificationService.xcframework à sua Notification Service Extension, consulte Integração manual.

Usar sua própria UNNotificationServiceExtension

Se você precisar usar sua própria UNNotificationServiceExtension, pode chamar brazeHandle no seu método didReceive.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

import BrazeNotificationService
import UserNotifications

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(
    _ request: UNNotificationRequest,
    withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
  ) {
    if brazeHandle(request: request, contentHandler: contentHandler) {
      return
    }

    // Custom handling here

    contentHandler(request.content)
  }
}

Etapa 5: Configurar o App Group na Braze

Antes de inicializar a Braze, atribua o nome do seu app group à 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)

Etapa 6: Criar uma notificação rica no dashboard

Sua equipe de marketing também pode criar notificações ricas pelo dashboard. Crie uma notificação por push pelo criador de push e anexe uma imagem ou GIF, ou forneça uma URL que hospede uma imagem, GIF ou vídeo. Os ativos são baixados no recebimento das notificações por push, então planeje picos grandes e síncronos de requisições caso esteja hospedando seu conteúdo.