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.

Configurando notificações ricas por push

Etapa 1: Criação de 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 definido para incorporar a extensão em seu aplicativo.

Etapa 2: Configuração da extensão do serviço de notificação

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

A ID do pacote da extensão do serviço de notificação deve ser diferente da ID do pacote do direcionamento do seu aplicativo principal. Por exemplo, se o ID do pacote do seu app for com.company.appname, você poderá usar com.company.appname.AppNameServiceExtension para a extensão do serviço.

Etapa 3: Adicionando um grupo de app

No Xcode, adicione a capacidade de Grupos de App no painel Assinatura & Capacidades ao seu alvo principal do app, bem como ao alvo da Extensão de Serviço 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.

Você precisa de um Grupo de App 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 app, seu app pode falhar ao preencher certos campos da carga útil do push e não funcionará totalmente como esperado.

Etapa 4: Integração de notificações por push avançadas

Para obter um guia passo a passo sobre a integração de notificações por push com BrazeNotificationService, consulte nosso tutorial.

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

Adição da estrutura rich push ao seu aplicativo

• 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

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

Uso de sua própria extensão UNNotificationServiceExtension

Se você precisar usar seu próprio UNNotificationServiceExtension, poderá chamar brazeHandle em 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: Configurando o Grupo de App no Braze

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)

Etapa 6: Criação de uma notificação Rich em seu dashboard

Sua equipe de marketing também pode criar notificações ricas a partir do dashboard. Crie uma notificação por push através do criador de push e anexe uma imagem ou GIF, ou forneça uma URL que hospede uma imagem, GIF ou vídeo. Note que os ativos são baixados no recebimento de notificações por push, portanto, planeje-se para grandes picos síncronos de solicitações se estiver hospedando seu conteúdo.