Skip to content

Notificações de Rich push

Aprenda como configurar notificações por push ricas para o SDK Braze.

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

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: 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

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

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

    O ícone de adição está localizado em estruturas e bibliotecas no Xcode.

  2. Selecione a estrutura “BrazeNotificationService”.

    A estrutura "BrazeNotificationService" pode ser selecionada no modal que se abre.

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

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

Para adicionar BrazeNotificationService.xcframework ao seu Notification Service Extension, consulte Integração manual.

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 4: Criação de uma notificação Rich em seu dashboard

Sua equipe de marketing também pode criar notificações Rich a partir do dashboard. Crie uma notificação por push por meio do criador de push e simplesmente anexe uma imagem ou GIF, ou forneça um 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.

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Cordova Braze SDK. Você também precisará configurar notificações por push.

Configuração de notificações por push

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

Em seu projeto Xcode, crie uma extensão de serviço de notificação. Para obter um passo a passo completo, consulte o Tutorial de notificações de rich push para iOS.

Etapa 2: Adicionar um novo direcionamento

Abra seu Podfile e adicione BrazeNotificationService ao alvo da extensão do serviço de notificação que acabou de criar. Se o BrazeNotificationService já estiver adicionado a um alvo, remova-o antes de continuar. Para evitar erros de símbolos duplicados, use a vinculação estática.

1
2
3
4
target 'NOTIFICATION_SERVICE_EXTENSION' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

Substitua NOTIFICATION_SERVICE_EXTENSION pelo nome da extensão de seu serviço de notificação. Seu Podfile deve ser semelhante ao seguinte:

1
2
3
4
target 'MyAppRichNotificationService' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

Etapa 3: Reinstale suas dependências do CocoaPods

No terminal, acesse o diretório iOS de seu projeto e reinstale as dependências do CocoaPod.

1
2
cd PATH_TO_PROJECT/platform/ios
pod install

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o React Native Braze SDK. Você também precisará configurar notificações por push.

Usando o Expo para ativar notificações por push ricas

Para o SDK do React Native, notificações por push ricas estão disponíveis para Android por padrão.

Para ativar notificações por push avançadas no iOS usando o Expo, configure a propriedade enableBrazeIosRichPush como true em seu objeto expo.plugins em app.json:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "expo": {
    "plugins": [
      [
        "@braze/expo-plugin",
        {
          ...
          "enableBrazeIosRichPush": true
        }
      ]
    ]
  }
}

Por fim, adicione o identificador de pacote para essa extensão de app à configuração de credenciais de seu projeto: <your-app-bundle-id>.BrazeExpoRichPush. Para obter mais detalhes sobre esse processo, consulte Uso de extensões de app com o Expo Application Services.

New Stuff!