notificações ricas do iOS 10

O iOS 10 introduz a capacidade de enviar notificações por push com imagens, GIFs e vídeos. Para habilitar essa funcionalidade, os clientes devem criar um Service Extension, um novo tipo de extensão que ativa a modificação de uma carga útil push antes de ser exibida.

Criação de uma extensão de serviço

Para criar uma Notification Service Extension, acesse 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.

Configuração da extensão de serviço

O Notification Service Extension é um binário próprio que acompanha seu app. Ele deve ser configurado no Portal Apple Developer com seu próprio ID de app e perfil de provisionamento.

O ID do pacote do Notification Service Extension deve ser diferente do 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.

Configurar a extensão de serviço para funcionar com o Braze

A Braze envia uma carga útil de anexo no payload de APNs sob a chave ab que usamos para configurar, baixar e exibir conteúdo avançado. Por exemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "ab" :
    {
    ...

    "att" :
      {
       "url" : "http://mysite.com/myimage.jpg",
       "type" : "jpg"
       }
    },
  "aps" :
    {
    ...
    }
}

Os valores relevantes da carga útil são:

1
2
3
4
5
6
7
8
9
10
11
// The Braze dictionary key
static NSString *const AppboyAPNSDictionaryKey = @"ab";

// The attachment dictionary
static NSString *const AppboyAPNSDictionaryAttachmentKey = @"att";

// The attachment URL
static NSString *const AppboyAPNSDictionaryAttachmentURLKey = @"url";

// The type of the attachment - a suffix for the file you save
static NSString *const AppboyAPNSDictionaryAttachmentTypeKey = @"type";

Para exibir manualmente a notificação por push com uma carga útil do Braze, baixe o conteúdo do valor em AppboyAPNSDictionaryAttachmentURLKey, salve-o como um arquivo com o tipo de arquivo armazenado na chave AppboyAPNSDictionaryAttachmentTypeKey e adicione-o aos anexos da notificação.

Exemplo de código

Você pode escrever a extensão de serviço em Objective C ou Swift.

Para usar nosso código de exemplo em Objective C, substitua o conteúdo do direcionamento Notification Service Extension gerado automaticamente por NotificationService.m pelo conteúdo do Appboy NotificationService.m.

Para usar nosso código de amostra do Swift, substitua o conteúdo do Notification Service Extension direcionamento gerado automaticamente pelo NotificationService.swift pelo conteúdo do Appboy NotificationService.swift.

Criação de uma notificação Rich em seu dashboard

Para criar uma notificação Rich em seu dashboard do Braze, crie um push do iOS, 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.

Consulte unnotificationattachment para obter uma lista dos tipos e tamanhos de arquivos suportados.