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 o 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 sua extensão de serviço.

Etapa 3: Adicionar um App Group

No Xcode, adicione a capacidade App Groups no painel Signing & Capabilities ao target principal do seu app, bem como ao target da Notification Service 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 seu grupo de apps 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 da Braze (anteriormente grupo de apps).

Você precisa de um App Group compartilhado para que o app principal e a Notification Service Extension possam acessar dados compartilhados. Se você não adicionar seu app a um grupo de apps, seu app pode falhar ao preencher certos campos da carga útil do push e não funcionará completamente 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 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

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

1. No Xcode, em frameworks e bibliotecas, selecione o ícone de adicionar 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 instruções sobre como implementar Push Stories, consulte a documentação.

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

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

Usando 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 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)

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 você deve planejar para grandes picos síncronos de solicitações se estiver hospedando seu conteúdo.