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 se registrar em nossas categorias de push padrão ao se 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 o modo de ativação em segundo plano apenas descartará a notificação e não abrirá o app. Na próxima vez que o usuário abrir o app, a análise de dados do clique do 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 do botão de ação.

Etapa 2: Ativar o tratamento interativo de push

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

Para ativar o tratamento dos 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 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 UNNotification Framework, precisará adicionar o seguinte código ao application:handleActionWithIdentifier:forRemoteNotification:completionHandler: do seu app para ativar o tratamento dos nossos 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 as pessoas que usam handleActionWithIdentifier comecem a usar o framework UNNotification. Recomendamos isso devido à descontinuação de handleActionWithIdentifier.

Personalização da categoria 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 categorias no seu aplicativo, você pode usar o dashboard da Braze para enviar categorias de notificação aos seus usuários.

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

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