Botões de ação

O Braze Swift SDK fornece suporte ao manuseio de URL para botões de ação por push.

Há quatro conjuntos de botões de ação por push padrão para as categorias de push padrão da Braze: Accept/Decline, Yes/No, Confirm/Cancel, e More.

Se você quiser criar suas próprias categorias de notificação personalizadas, consulte personalização do botão de ação.

Integração automática (recomendado)

Ao integrar o push usando a opção de configuração configuration.push.automation, o Braze registra automaticamente os botões de ação por push para as categorias de push padrão e lida com a análise de dados de cliques dos botões de ação por push e com o roteamento de URL.

Integração manual

Para ativar manualmente esses botões de ação por push, primeiro registre-se para as categorias push padrão. Em seguida, use o método delegado didReceive(_:completionHandler:) para ativar os botões de ação por push.

Etapa 1: Adição de categorias push padrão do Braze

Use o seguinte código para se registrar nas categorias push padrão ao se registrar no push:

• swift
• objective c

1
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)

1
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:BRZNotifications.categories];

Etapa 2: Ativar o manuseio interativo de push

Para ativar a manipulação de nossos botões de ação por push, incluindo análise de dados de cliques e roteamento de URL, adicione o seguinte código ao método delegado didReceive(_:completionHandler:) do seu app:

• swift
• objective c

1
AppDelegate.braze?.notifications.handleUserNotification(response: response, withCompletionHandler: completionHandler)

1
2
[AppDelegate.braze.notifications handleUserNotificationWithResponse:response
                                              withCompletionHandler:completionHandler];

Se você usar a estrutura UNNotification e tiver implementado os métodos de notificação do Braze, já deverá ter esse método integrado.

Personalização da categoria push

Além de fornecer um conjunto de categorias de notificação por push padrão, o Braze oferece suporte a categorias e ações de notificação personalizadas. Depois de registrar as categorias no seu aplicativo, você pode usar o dashboard do Braze para enviar essas categorias de notificação personalizadas aos seus usuários.

Essas categorias podem ser atribuídas a notificações por push por meio de nosso dashboard para disparar as configurações do botão de ação de seu design.

Exemplo de categoria de push personalizado

Aqui está um exemplo que aproveita o endereço LIKE_CATEGORY exibido no dispositivo:

Etapa 1: Registre uma categoria

Para registrar uma categoria no seu app, use uma abordagem semelhante à seguinte:

• swift
• objective c

1
2
3
4
5
6
7
8
9
10
Braze.Notifications.categories.insert(
  .init(identifier: "LIKE_CATEGORY",
        actions: [
          .init(identifier: "LIKE_IDENTIFIER", title: "Like", options: [.foreground]),
          .init(identifier: "UNLIKE_IDENTIFIER", title: "Unlike", options: [.foreground])
        ],
        intentIdentifiers: []
       )
)
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
NSMutableSet<UNNotificationCategory *> *categories = [BRZNotifications.categories mutableCopy];

UNNotificationAction *likeAction = [UNNotificationAction actionWithIdentifier:@"LIKE_IDENTIFIER"
                                                                        title:@"Like"
                                                                      options:UNNotificationActionOptionForeground];

UNNotificationAction *unlikeAction = [UNNotificationAction actionWithIdentifier:@"UNLIKE_IDENTIFIER"
                                                                          title:@"Unlike"
                                                                        options:UNNotificationActionOptionForeground];

UNNotificationCategory *likeCategory = [UNNotificationCategory categoryWithIdentifier:@"LIKE_CATEGORY"
                                                                              actions:@[likeAction, unlikeAction]
                                                                    intentIdentifiers:@[]
                                                                              options:UNNotificationCategoryOptionNone];

[categories addObject:likeCategory];
[UNUserNotificationCenter.currentNotificationCenter setNotificationCategories:categories];

Etapa 2: Selecione suas categorias

Depois de registrar uma categoria, use o dashboard do Braze para enviar notificações desse tipo aos usuários.

1. No dashboard do Braze, selecione Envio de mensagens > Notificações por push e, em seguida, escolha sua campanha de push para iOS.
2. Em Compose push notification (Notificação por push de composição), ative os botões de ação.
3. No menu suspenso Categoria de notificação do iOS, selecione Inserir categoria personalizada pré-registrada do iOS.
4. Por fim, insira uma das categorias que você criou anteriormente. O exemplo a seguir usa a categoria personalizada: LIKE_CATEGORY.