Integração de notificação por push do Android

Este artigo de referência cobre a integração de notificação por push do Android para a plataforma Unity.

Estas instruções são para integrar push com Firebase Cloud Messaging (FCM).

Consulte nossa documentação do Unity ADM para obter instruções de integração do ADM.

Etapa 1: ativar Firebase

Para começar, siga a documentação de configuração do Firebase Unity.

Etapa 2: Defina suas credenciais do Firebase

Você precisa inserir sua chave de servidor do Firebase e o ID do remetente no dashboard da Braze. Para fazer isso, registre-se no console de desenvolvedores do Firebase e selecione seu projeto Firebase. Em seguida, selecione envio de mensagens na nuvem em Configurações e copie a Chave do Servidor e o ID do Remetente:

No Braze, selecione seu app Android na página de Configurações do App em Gerenciar Configurações. Em seguida, insira sua chave de servidor do Firebase no campo Firebase Cloud Messaging Server Key e o ID do remetente do Firebase no campo Firebase Cloud Messaging Sender ID.

Etapa 3: Implementar integração automática de push

O SDK da Braze pode lidar automaticamente com o registro de push com os servidores do Firebase Cloud Messaging para que os dispositivos recebam notificações por push.

• Registro automático de envio de mensagens do Firebase ativado
  Instrui o Braze SDK a recuperar e enviar automaticamente um token por push FCM para um dispositivo.
• ID de remetente do Firebase Cloud Messaging
  O ID do remetente do seu console do Firebase.
• Manipular deeplinks de push automaticamente
  Se o SDK deve lidar com a abertura de links profundos ou abrir o app quando notificações por push são clicadas.
• Pequeno Ícone de Notificação Drawable
  O drawable deve ser exibido como o ícone pequeno sempre que uma notificação por push for recebida. A notificação usará o ícone do aplicativo como o ícone pequeno se nenhum ícone for fornecido.

Etapa 4: Definir ouvintes de push

Se você deseja passar cargas úteis de notificação por push para o Unity ou tomar medidas adicionais quando um usuário recebe uma notificação por push, o Braze oferece a opção de configurar ouvintes de notificação por push.

No Braze, selecione seu app Android na página de Configurações do App em Gerenciar Configurações. Em seguida, insira sua chave de servidor do Firebase no campo Configurações de notificação por push e o ID do remetente do Firebase no campo de ID Configurações de notificação por push.

Ouvinte de push recebido

O ouvinte recebido de push é acionado quando um usuário recebe uma notificação por push. Para enviar a carga útil do push para o Unity, defina o nome do seu objeto de jogo e envie o método de retorno de chamada do ouvinte recebido em Set Push Received Listener.

Ouvinte de push aberto

O ouvinte aberto de push é acionado quando um usuário lança o app clicando em uma notificação por push. Para enviar a carga útil push para o Unity, defina o nome do seu objeto de jogo e o método de retorno de chamada do ouvinte de push aberto em Set Push Opened Listener.

Push excluiu ouvinte (somente Android)

O ouvinte de exclusão de push é acionado quando um usuário desliza ou descarta uma notificação por push. Para enviar a carga útil do push para o Unity, defina o nome do seu objeto de jogo e o método de retorno de chamada do ouvinte de push excluído em Set Push Deleted Listener.

Exemplo de implementação do ouvinte de push

O exemplo a seguir implementa o objeto de jogo BrazeCallback usando um método de retorno de chamada chamado PushNotificationReceivedCallback, PushNotificationOpenedCallback e PushNotificationDeletedCallback respectivamente.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
public class MainMenu : MonoBehaviour {
  void PushNotificationReceivedCallback(string message) {
#if UNITY_ANDROID
    Debug.Log("PushNotificationReceivedCallback message: " + message);
    PushNotification pushNotification = new PushNotification(message);
    Debug.Log("Push Notification received: " + pushNotification);   
#elif UNITY_IOS
    ApplePushNotification pushNotification = new ApplePushNotification(message);
    Debug.Log("Push received Notification event: " + pushNotification);   
#endif  
  }

  void PushNotificationOpenedCallback(string message) {
#if UNITY_ANDROID
    Debug.Log("PushNotificationOpenedCallback message: " + message);
    PushNotification pushNotification = new PushNotification(message);
    Debug.Log("Push Notification opened: " + pushNotification);  
#elif UNITY_IOS
    ApplePushNotification pushNotification = new ApplePushNotification(message);
    Debug.Log("Push opened Notification event: " + pushNotification);   
#endif  
  }

  void PushNotificationDeletedCallback(string message) {
#if UNITY_ANDROID
    Debug.Log("PushNotificationDeletedCallback message: " + message);
    PushNotification pushNotification = new PushNotification(message);
    Debug.Log("Push Notification dismissed: " + pushNotification);  
#endif
  }
}

Exemplo de implementação

O projeto de exemplo no repositório do Braze Unity SDK contém um aplicativo de exemplo completo que inclui FCM.

Deep linking para recursos in-app

Embora a Braze possa lidar com links profundos padrão (como URLs de sites, URIs do Android, etc.) por padrão, a criação de links profundos personalizados requer uma configuração adicional do Manifesto.

Para obter orientações de configuração, visite Deep linking para recursos no aplicativo.

Adição de ícones de notificação por push do Braze

Para adicionar ícones push ao seu projeto, crie um plug-in do Android Archive (AAR) ou uma biblioteca do Android que contenha os arquivos de imagem do ícone. Para obter etapas e informações, consulte a documentação da Unity: Projetos de biblioteca do Android e plug-ins do Android Archive.