Notificações Rich
As notificações Rich são notificações por push com imagens, GIFs e vídeos. Para habilitar essa funcionalidade, você deve criar uma extensão de serviço de notificação - um tipo de extensão que ativa a modificação de uma carga útil por push antes que ela seja exibida. Consulte o site da Apple
UNNotificationAttachment
da Apple para obter uma lista dos tipos e tamanhos de arquivos compatíveis.
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 Apple Developer Portal 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:
-
No Xcode, em frameworks e bibliotecas, selecione o ícone de adicionar para adicionar um framework.
-
Selecione a estrutura “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
Para obter instruções sobre como implementar stories por push, consulte a documentação.
Depois de atualizar o Podfile, navegue até o diretório de seu projeto de app do Xcode em 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.