Intégration de notifications Push pour iOS

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

Étape 1 : Choisir une intégration des notifications push automatique ou manuelle

Braze fournit une solution Unity native pour l’automatisation des intégrations de notifications push iOS.

• Si vous préférez réaliser l’intégration manuellement en modifiant votre projet Xcode créé, suivez nos instructions de notifications push iOS natives.
• Si vous passez d’une intégration manuelle à une intégration automatisée, suivez les instructions relatives à la transition vers une intégration automatisée.
• Notre solution de notification push automatique tire parti de la fonctionnalité d’autorisation provisoire d’iOS 12 et n’est pas disponible pour utiliser avec la fenêtre contextuelle d’invite de notification push native.

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

Configurer les notifications push

Suivez notre documentation de configuration des notifications push iOS pour configurer Braze à l’aide d’un fichier .p8.

Activer l’intégration automatique de notifications push

Ouvrez les paramètres de configuration de Braze dans l’éditeur Unity en sélectionnant Braze > Configuration Braze.

Cochez Intégrer Push avec Braze pour inscrire automatiquement les utilisateurs aux notifications push, transmettre les jetons push à Braze, suivre l’analyse/analytique des ouvertures de push et tirer parti de notre gestion par défaut des notifications push.

Activer la poussée en arrière-plan (facultatif)

Cochez Enable Background Push si vous souhaitez activer background mode pour les notifications push. Cela permet au système de réveiller votre application à partir de l’état suspended lorsqu’une notification push est reçue, permettant à votre application de télécharger le contenu en réponse aux notifications push. Le fait de cocher cette option est nécessaire pour notre fonctionnalité de suivi de la désinstallation.

Désactiver l’enregistrement automatique (optionnel)

Les utilisateurs qui n’ont pas encore opté pour des notifications push seront automatiquement autorisés aux notifications push lors de l’ouverture de votre application. Pour désactiver cette fonctionnalité et enregistrer manuellement les utilisateurs pour le push, cochez Désactiver l’enregistrement push automatique.

• Si la case Désactiver l’autorisation provisoire n’est pas cochée sous iOS 12 ou une version ultérieure, l’utilisateur sera provisoirement (silencieusement) autorisé à recevoir le push silencieux. Si cette option est cochée, l’utilisateur affiche l’invite de notification push native.
• Si vous devez configurer exactement quand l’invite est affichée lors de l’exécution, désactivez l’enregistrement automatique de l’éditeur de configuration Braze et utilisez AppboyBinding.PromptUserForPushPermissions() à la place.

Étape 3 : 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.

L’auditeur a reçu la notification push

Le récepteur push reçu est déclenché lorsqu’un utilisateur reçoit une notification push alors qu’il utilise activement l’application (par exemple, lorsque l’application est au premier plan). Définissez l’auditeur de notification push reçu dans l’éditeur de configuration Braze. Si vous devez configurer votre auditeur d’objet de jeu lors de l’exécution, utilisez AppboyBinding.ConfigureListener() et spécifiez BrazeUnityMessageType.PUSH_RECEIVED.

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 notifications push à Unity, définissez le nom de votre objet de jeu et de la méthode de rappel d’écoute ouverte des notifications push sous l’option Définir l’auditeur ouvert de notifications push :

Si vous devez configurer votre auditeur d’objet de jeu lors de l’exécution, utilisez AppboyBinding.ConfigureListener() et spécifiez BrazeUnityMessageType.PUSH_OPENED.

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
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  
  }
}

Fonctionnalités avancées

Fonction de rappel de jeton de notification push

Pour recevoir une copie des jetons d’appareil de Braze à partir du système d’exploitation, définissez un délégué à l’aide de AppboyBinding.SetPushTokenReceivedFromSystemDelegate().

Autres fonctions

Pour implémenter des fonctionnalités avancées telles que des liens profonds, des nombres de badges et des sons personnalisés, consultez nos instructions de notifications push iOS natives.