Aviso

AppboyKit (também conhecido como o SDK Objective-C) não é mais suportado e foi substituído pelo Swift SDK. Não receberá mais novos recursos, correções de bugs, atualizações de segurança ou suporte técnico—no entanto, o envio de mensagens e a análise de dados continuarão a funcionar normalmente. Para saber mais, veja Apresentando o Novo SDK Braze Swift.

Botões de ação

O SDK da Braze para iOS aceita categorias de push padrão, incluindo suporte ao tratamento de URL para cada botão de ação por push. Atualmente, as categorias padrão têm quatro conjuntos de botões de ação por push: Accept/Decline, Yes/No, Confirm/Cancel e More.

Para registrar nossas categorias de push padrão, siga as instruções de integração:

Etapa 1: Adicionando categorias de push padrão da Braze

Use o código a seguir para registrar nossas categorias de push padrão ao registrar para push:

• objective-c
• swift

1
2
3
4
5
6
7
8
9

// For UserNotification.framework (iOS 10+ only)
NSSet *appboyCategories = [ABKPushUtils getAppboyUNNotificationCategorySet];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:appboyCategories];

// For UIUserNotificationSettings (before iOS 10)
NSSet *appboyCategories = [ABKPushUtils getAppboyUIUserNotificationCategorySet];
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge
                                                                         categories:appboyCategories];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];

1
2
3
4
5
6
7
8

// For UserNotification.framework (iOS 10+ only)
let appboyCategories = ABKPushUtils.getAppboyUNNotificationCategorySet()
UNUserNotificationCenter.current().setNotificationCategories(appboyCategories)

// For UIUserNotificationSettings (before iOS 10)
let appboyCategories = ABKPushUtils.getAppboyUIUserNotificationCategorySet()
let settings = UIUserNotificationSettings.init(types: .badge, categories: appboyCategories)
UIApplication.shared.registerUserNotificationSettings(settings)

Clicar nos botões de ação por push com modo de ativação em segundo plano apenas descartará a notificação, sem abrir o app. Na próxima vez que o usuário abrir o app, a análise de dados do clique no botão para essas ações será enviada ao servidor.

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

Etapa 2: Ativar o tratamento de push interativo

Se você usa o framework UNNotification e implementou os delegates da Braze, esse método já deve estar integrado.

Para ativar o tratamento dos 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 delegate (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler: do seu app:

• objective-c
• swift

1
2
3

[[Appboy sharedInstance] userNotificationCenter:center
                           didReceiveNotificationResponse:response
                               withCompletionHandler:completionHandler];

1
2
3

Appboy.sharedInstance()?.userNotificationCenter(center,
                                                didReceive: response,
                                                withCompletionHandler: completionHandler)

Se você não estiver usando o framework UNNotification, precisará adicionar o seguinte código ao método application:handleActionWithIdentifier:forRemoteNotification:completionHandler: do seu app para ativar o tratamento dos botões de ação por push:

• objective-c
• swift

1
2
3

[[Appboy sharedInstance] getActionWithIdentifier:identifier
                           forRemoteNotification:userInfo
                               completionHandler:completionHandler];

1
2
3

Appboy.sharedInstance()?.getActionWithIdentifier(identifier,
                                                 forRemoteNotification: userInfo,,
                                                 completionHandler: completionHandler)

Importante

Recomendamos fortemente que quem usa handleActionWithIdentifier comece a utilizar o framework UNNotification. Essa recomendação se deve à descontinuação de handleActionWithIdentifier.

Personalização de categorias de push

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

Se você não estiver usando o framework UserNotifications, consulte a documentação de categorias alternativas.

Essas categorias podem então ser atribuídas a notificações por push por meio do nosso dashboard para disparar as configurações de botões de ação do seu design. Veja um exemplo que utiliza a LIKE_CATEGORY exibida no dispositivo: