FAQ du SDK iOS

Vous pouvez intégrer le SDK Pushwoosh en utilisant soit le Swift Package Manager, soit CocoaPods.

Dans Xcode, naviguez jusqu’à la section Package Dependencies et ajoutez le package en utilisant l’URL suivante : https://github.com/Pushwoosh/Pushwoosh-XCFramework.

Ouvrez le Podfile de votre projet et ajoutez la ligne pod 'PushwooshXCFramework'. Ensuite, exécutez la commande pod install dans le terminal.

Dans la section Signing & Capabilities des paramètres de votre projet, vous devez ajouter les capacités Push Notifications et Background Modes. En ajoutant Background Modes, assurez-vous de cocher la case Remote notifications.

Si vous prévoyez d’utiliser les notifications urgentes (Time Sensitive Notifications) (iOS 15+), vous devez également ajouter la capacité Time Sensitive Notifications.

Le code d’initialisation doit être ajouté à votre classe AppDelegate.

Veuillez vous référer à l’exemple de code Swift fourni pour l’intégration de Pushwoosh dans un projet SwiftUI.

Veuillez vous référer à l’exemple de code Swift fourni pour l’intégration de Pushwoosh dans un projet Swift standard.

Veuillez vous référer à l’exemple de code Objective-C fourni pour l’intégration de Pushwoosh dans un projet Objective-C.

Vous devez ajouter la clé Pushwoosh_APPID définie sur votre Application Code et la clé PW_API_TOKEN définie sur votre API Token dans le fichier Info.plist de votre application.

Pushwoosh prend en charge le suivi des événements de livraison pour les notifications push en utilisant la Notification Service Extension.

Dans Xcode, allez dans File > New > Target…, choisissez Notification Service Extension, et appuyez sur Next. Entrez un nom de cible et appuyez sur Finish. Lorsqu’on vous demande de l’activer, appuyez sur Cancel.

Ajoutez l’extrait de code Swift ou Objective-C fourni au fichier principal .swift ou .m de votre Notification Service Extension. Ce code utilise PWNotificationExtensionManager pour gérer la requête de notification.

La capacité App Groups est requise pour permettre à la Notification Service Extension de communiquer avec l’application principale.

Pour les deux cibles, allez dans Signing & Capabilities, ajoutez la capacité App Groups, et créez un nouveau groupe en appuyant sur le bouton +. Assurez-vous que le nom du groupe commence par group. et utilisez le même nom de groupe pour les deux cibles.

Dans le fichier Info.plist de votre cible principale, ajoutez la clé PW_APP_GROUPS_NAME et définissez sa valeur sur le nom de votre groupe App Groups.

Dans le fichier Info.plist de votre Notification Service Extension, ajoutez la clé PW_APP_GROUPS_NAME (définie sur le nom de votre App Groups) et la clé Pushwoosh_APPID (définie sur votre Application Code).

Après avoir compilé et exécuté votre projet, rendez-vous dans le Panneau de Contrôle Pushwoosh (Control Panel) et envoyez une notification push à votre application. Vous devriez voir la notification apparaître sur votre appareil.

Les deux principaux rappels sont onMessageReceived et onMessageOpened.

La méthode onMessageReceived est appelée lorsqu’une notification push est reçue par l’application.

La méthode onMessageOpened est appelée lorsque l’utilisateur interagit avec une notification push et l’ouvre.

La charge utile d’un objet PWMessage (passé aux rappels onMessageReceived et onMessageOpened) est accessible via sa propriété payload.

Utilisez la méthode setUserId(_:) de l’objet Pushwoosh.sharedInstance(), en passant l’ID de l’utilisateur en argument.

Utilisez la méthode setEmail(_:) de l’objet Pushwoosh.sharedInstance(), en fournissant l’e-mail de l’utilisateur.

Utilisez la méthode setTags(_:) de l’objet Pushwoosh.sharedInstance(), en passant un dictionnaire où les clés sont les noms des tags et les valeurs sont les valeurs correspondantes.

Utilisez la méthode postEvent(_:withAttributes:) de PWInAppManager.shared(), en fournissant le nom de l’événement (par ex., "login") et un dictionnaire d’attributs (par ex., "name", "last_login").

Utilisez la méthode postEvent(_:withAttributes:) de PWInAppManager.shared() avec le nom d’événement "purchase" et un dictionnaire contenant les détails du produit comme "product_id", "product_name", "price", et "quantity".

Dans votre contrôleur de vue ou une autre classe appropriée, conformez-vous au protocole PWRichMediaPresentingDelegate et définissez la propriété delegate de PWRichMediaManager.shared() sur votre instance conforme.

Utilisez l’objet PWModalWindowConfiguration.shared() pour configurer des propriétés telles que la position de la fenêtre modale et les animations de présentation/fermeture en utilisant la méthode configureModalWindow(with:present:dismiss:).

Les méthodes du délégué donnent accès à l’objet PWRichMedia, qui contient des informations sur le contenu rich media, y compris son pushPayload. La méthode presentingDidFailForRichMedia:withError: fournit également un objet Error décrivant l’échec.

Si vous voyez le message d’erreur “Your provisioning profile does not have APS entry.”, assurez-vous que votre profil de provisionnement est compatible avec les notifications push et qu’il contient la chaîne aps-environment avec la valeur production ou development. Le moyen le plus simple de vérifier est d’ouvrir le profil de provisionnement mobile dans n’importe quel éditeur de texte et de rechercher la chaîne aps-environment. Elle devrait s’y trouver.

Si c’est le cas et que vous continuez à recevoir l’erreur, cela signifie que Xcode sélectionne toujours un profil “non compatible avec les notifications push”. Veuillez vous assurer de signer avec le bon profil - parfois, si vous avez deux profils pour le même App ID, Xcode peut s’emmêler les pinceaux et signer avec l’ancien.

Les étapes recommandées sont :

1. Supprimez tous les profils de Xcode ;
2. Ajoutez le seul et unique nouveau profil ;
3. Recompilez l’application.

Les tokens push d’appareils iOS sont des chaînes de 64 symboles hexadécimaux. Exemple de token push :
03df25c845d460bcdad7802d2vf6fc1dfde97283bf75cc993eb6dca835ea2e2f
Assurez-vous que les tokens push iOS que vous utilisez pour cibler des appareils spécifiques dans vos requêtes API sont en minuscules.

Pushwoosh utilise l’IDFV comme HWID de l’appareil. Notez qu’il peut changer si l’utilisateur réinstalle toutes les applications d’un même fournisseur.

CBAF8ED1-17FB-49A3-73BD-DC79B63AEF93

Par défaut, notre dernier SDK iOS affiche la bannière de notification lorsque l’application s’exécute au premier plan.
Vous pouvez contrôler ce comportement en modifiant les indicateurs suivants dans le fichier Info.plist :

Indicateur Pushwoosh_ALERT_TYPE – type chaîne de caractères, les valeurs sont :

• BANNER – valeur par défaut, affiche une alerte de type bannière dans l’application
• ALERT – notification de type alerte
• NONE – n’affiche pas les notifications lorsque l’application est au premier plan

Pour obtenir le token push de votre appareil iOS,

1. Ouvrez Xcode => Devices & Simulators ;
2. Connectez l’appareil de test à votre ordinateur ;
3. Sélectionnez votre appareil connecté dans la liste des appareils à gauche ;
4. Cliquez sur le bouton Open Console.

Lancez l’application pour laquelle vous avez besoin du token push, et repérez votre token de 64 caractères hexadécimaux dans la ligne “Registered for push notifications” :

C’est un comportement attendu - les pastilles sont gérées par iOS lui-même et leurs valeurs sont stockées dans les préférences de l’application, qui ne sont pas supprimées instantanément lorsque vous désinstallez votre application. La valeur d’une pastille y reste pendant un certain temps en cas de réinstallation immédiate, ce qui fait que les mêmes pastilles sont affichées après la réinstallation de l’application.