Intégration de notifications Push pour Android

Cet article de référence couvre l’intégration de notifications push Android pour la plateforme Unity.

Ces instructions concernent l’intégration de push avec Firebase Cloud Messaging (FCM).

Consultez notre documentation Unity ADM pour les instructions d’intégration de l’ADM.

Étape 1 : Activer Firebase

Pour commencer, suivez la documentation de configuration de Firebase Unity.

Étape 2 : Définir vos informations d’identification Firebase

Vous devez saisir votre clé de serveur Firebase et votre ID d’expéditeur dans le tableau de bord de Braze : Pour ce faire, connectez-vous à la Firebase Developers Console et sélectionnez votre projet Firebase. Ensuite, sélectionnez l’option Cloud Messaging sous Settings et copiez la clé du serveur et l’ID de l’expéditeur :

Dans Braze, sélectionnez votre application Android sur la page Paramètres de l’application, sous Gérer les paramètres. Saisissez ensuite votre clé de serveur Firebase dans le champ Clé du serveur Firebase Cloud Messaging et ID d’expéditeur Firebase dans le champ ID Expéditeur de Firebase Cloud Messaging.

Étape 3 : Implémenter l’intégration de notification push automatique

Le SDK Braze peut gérer automatiquement l’enregistrement des notifications push avec les serveurs Firebase Cloud Messaging pour que les appareils reçoivent des notifications push.

• Activation de l’enregistrement automatique de l’envoi de messages dans le nuage Firebase
  Donne l’ordre au SDK Braze de récupérer et d’envoyer automatiquement un jeton de notification push FCM pour un appareil.
• ID de l’expéditeur de Firebase Cloud Messaging
  L’identifiant de l’expéditeur provenant de votre console Firebase.
• Manipulez automatiquement les liens profonds (Push Deeplinks)
  Si le SDK doit traiter des liens profonds ou ouvrir l’application lorsque des notifications push sont cliquées.
• Petite icône de notification dessinable
  Le drawable doit être affiché comme petite icône chaque fois qu’une notification push est reçue. La notification utilisera l’icône de l’application comme petite icône si aucune icône n’est fournie.

Étape 4 : Définir les auditeurs de notifications push

Si vous souhaitez transmettre des charges utiles de notification push à Unity ou prendre des mesures supplémentaires lorsqu’un utilisateur reçoit une notification push, Braze offre la possibilité de définir des auditeurs de notification push.

Dans Braze, sélectionnez votre application Android sur la page Paramètres de l’application, sous Gérer les paramètres. Saisissez ensuite votre clé de serveur Firebase dans le champ Paramètres des notifications push et ID d’expéditeur Firebase dans le champ ID Paramètres des notifications push.

L’auditeur a reçu la notification push

L’auditeur de notification push reçu est déclenché lorsqu’un utilisateur reçoit une notification push. Pour envoyer la charge utile push à Unity, définissez le nom de votre objet de jeu et poussez la méthode de rappel de l’auditeur reçu sous la rubrique Définir l’auditeur reçu des notifications push.

Auditeur ouvert de notification push

L’auditeur ouvert est déclenché lorsqu’un utilisateur lance l’application en cliquant sur une notification push. Pour envoyer la charge utile de notification push à Unity, définissez le nom de votre objet de jeu et appuyez sur la méthode de rappel de l’écoute ouverte dans Définir l’auditeur ouvert de notifications push.

Auditeur push supprimé (Android uniquement)

L’auditeur push supprimé est déclenché lorsqu’un utilisateur balaye ou rejette une notification push. Pour envoyer la charge utile push à Unity, définissez le nom de votre objet de jeu et la méthode de rappel push deleted listener sous la rubrique Définir l’auditeur supprimé des notifications push.

Exemple d’implémentation d’auditeur de notification push

L’exemple suivant implémente l’objet de jeu BrazeCallback utilisant respectivement un nom de méthode de rappel de PushNotificationReceivedCallback, PushNotificationOpenedCallback, et PushNotificationDeletedCallback.

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
  }
}

Exemple d’implémentation

L’exemple de projet dans le référentiel du SDK Unity de Braze contient un exemple d’application parfaitement fonctionnelle incluant FCM.

Ressources liens profonds vers in-app

Bien que Braze puisse gérer des liens profonds standard par défaut (tels que les URL de sites Internet, les URI Android, etc.), la création de liens profonds personnalisés nécessite une configuration du Manifeste supplémentaire.

Pour obtenir des conseils sur la configuration, consultez la page Création de liens profonds vers des ressources In-App.

Ajout d’icônes de notification push Braze

Pour ajouter des icônes push à votre projet, créez un plug-in Android Archive (AAR) ou une bibliothèque Android contenant les fichiers d’image des icônes. Pour connaître les étapes et les informations, reportez-vous à la documentation d’Unity : Projets de bibliothèques Android et plug-ins Android Archive.