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

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.

Certifique-se de que Embed In Application esteja configurado para incorporar a extensão em seu app.

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

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

O bundle ID da extensão de serviço de notificação deve ser diferente do bundle ID do alvo 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 sua extensão de serviço.

Etapa 3: Adicionar um App Group

No Xcode, adicione a capacidade App Groups no painel Signing & Capabilities tanto ao alvo principal do app quanto ao alvo da extensão de serviço de notificação. 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 neste contexto se refere 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 seu app principal e a extensão de serviço de notificação possam acessar dados compartilhados. Se você não adicionar seu app a um grupo de apps, seu app pode falhar ao preencher determinados campos da carga útil do push e não funcionará completamente como esperado.

Etapa 4: Integrar notificações por push ricas

Para obter 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 adição 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 seu projeto Xcode no 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, em vez disso 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 planeje-se para grandes picos sincronizados de requisições caso esteja hospedando seu próprio conteúdo.