Guide d'intégration avancée du SDK iOS

Cette section fournit des informations sur l’intégration avancée du SDK iOS de Pushwoosh.

Modes d’arrière-plan

Attention

Par défaut, iOS n’autorise pas les applications à traiter les notifications push lorsqu’elles sont en arrière-plan. Cela inclut les notifications push silencieuses, qui sont utiles pour mettre à jour les données de l’application sans interaction de l’utilisateur.

Pour activer cette fonctionnalité, vous devez ajouter les modes d’arrière-plan (Background Modes) à votre projet.

Étapes pour activer les modes d’arrière-plan

1. Ouvrez votre projet dans Xcode et sélectionnez-le dans le Project Navigator.
2. Choisissez la cible de votre application dans le panneau de gauche.
3. Accédez à l’onglet Signing & Capabilities.
4. Cliquez sur le bouton + Capability dans le coin supérieur gauche.
5. Recherchez et sélectionnez Background Modes dans la liste.
6. Dans la section Background Modes, activez Remote notifications en cochant la case.

Une fois cette opération terminée, votre application pourra gérer les notifications push, y compris les notifications silencieuses, lorsqu’elle s’exécute en arrière-plan.

Modes de premier plan

Par défaut, le SDK iOS de Pushwoosh affiche la bannière de notification lorsque l’application est en cours d’exécution au premier plan.

Vous pouvez contrôler ce comportement en définissant l’indicateur booléen suivant dans votre code (par exemple, dans votre AppDelegate) :

Swift

// Set false to disable foreground notifications, true to enable it
Pushwoosh.sharedInstance().showPushnotificationAlert = true

Exemple (Swift)

Objective-C

// Set 0 to disable foreground notifications, 1 to enable it
[[Pushwoosh sharedInstance] setShowPushnotificationAlert:0];

Exemple (Objective-C)

Niveau de journalisation

Le SDK iOS de Pushwoosh prend en charge les niveaux de journalisation suivants :

• NONE - Aucun journal du SDK.
• ERROR - Affiche uniquement les messages d’erreur dans la console.
• WARNING - Affiche les avertissements en plus des erreurs.
• INFO - Inclut les messages d’information (paramètre par défaut).
• DEBUG - Inclut des informations de débogage détaillées.

Par défaut, le niveau de journalisation est défini sur INFO, garantissant que le SDK fournit des informations pertinentes sans encombrer la console du développeur.

Pour modifier le niveau de journalisation, mettez à jour la clé Pushwoosh_LOG_LEVEL dans le fichier Info.plist de votre application :

<key>Pushwoosh_LOG_LEVEL</key>
<string>YOUR_LOG_LEVEL</string>

Alternativement, vous pouvez modifier le niveau de journalisation en utilisant l’extrait de code ci-dessous :

Pushwoosh.Debug.setLogLevel(.PW_LL_DEBUG)

Remplacez YOUR_LOG_LEVEL par le niveau souhaité (par exemple, DEBUG ou ERROR).

UNNotificationCenterDelegate personnalisé

Si vous souhaitez utiliser votre propre UNNotificationCenterDelegate (par exemple, pour les notifications locales), vous devez en informer le SDK Pushwoosh pour un comportement correct. Vous pouvez le faire avec la propriété notificationCenterDelegateProxy de l’instance Pushwoosh :

Swift

Pushwoosh.sharedInstance()?.notificationCenterDelegateProxy.add(my_delegate)

Exemple (Swift)

Objective-C

[Pushwoosh.sharedInstance.notificationCenterDelegateProxy addNotificationCenterDelegate:my_delegate];

Exemple (Objective-C)

Ensuite, implémentez les méthodes UNNotificationCenterDelegate dans votre délégué :

Swift

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
) {
    if (!PWMessage.isPushwooshMessage(notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler(UNNotificationPresentationOptions.alert)
    }
}

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void
) {
    if (!PWMessage.isPushwooshMessage(response.notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler()
    }
}

Exemple (Swift)

Objective-C

- (void)userNotificationCenter:(UNNotificationCenter *)center
        willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
    if (![PWMessage isPushwooshMessage:notification.request.content.userInfo]) {
        // Handle your message
        completionHandler(UNNotificationPresentationOptionAlert);
    }
}

- (void)userNotificationCenter:(UNNotificationCenter *)center
        didReceiveNotificationResponse:(UNNotificationResponse *)response
        withCompletionHandler:(void (^)(void))completionHandler {
    if (![PWMessage.isPushwooshMessage:response.notification.request.content.userInfo]) {
        // Handle your message
        completionHandler();
    }
}

Exemple (Objective-C)

Initialisation paresseuse de Pushwoosh

L’indicateur Pushwoosh_LAZY_INITIALIZATION empêche l’initialisation automatique du SDK Pushwoosh au démarrage de l’application. Cela permet un meilleur contrôle sur le moment où les services du SDK Pushwoosh sont démarrés.

Lorsque cet indicateur est activé, le SDK Pushwoosh ne démarre pas ses services tant que les méthodes du SDK iOS de Pushwoosh ne sont pas explicitement appelées.

Ajoutez l’entrée suivante à Info.plist :

<key>Pushwoosh_LAZY_INITIALIZATION</key>
<true/>

Cas d’utilisation

1. Initialisation contrôlée du SDK – L’indicateur Pushwoosh_LAZY_INITIALIZATION permet de retarder le démarrage du SDK Pushwoosh, offrant un meilleur contrôle sur le moment où les services push sont activés.

2. Activation différée des notifications push – Dans certaines applications, les notifications push ne doivent être initialisées que sous des conditions spécifiques. L’activation de cet indicateur garantit que le SDK Pushwoosh ne démarre que lorsqu’il est explicitement demandé.

3. Configuration push spécifique à l’utilisateur – Certaines applications peuvent nécessiter la personnalisation des paramètres de notification push en fonction des préférences de l’utilisateur ou des paramètres du compte. Avec l’initialisation paresseuse, le SDK Pushwoosh ne démarre qu’après que la configuration appropriée a été déterminée.

Liste complète des propriétés Info.plist

Propriété	Description	Valeurs possibles
Pushwoosh_APPID	Définit l’ID d’application Pushwoosh pour la version de production.	XXXXX-XXXXX Type : String
Pushwoosh_APPID_Dev	Définit l’ID d’application Pushwoosh pour la version de développement.	XXXXX-XXXXX Type : String
Pushwoosh_SHOW_ALERT	Affiche l’alerte de notification au premier plan.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALERT_TYPE	Définit le style d’alerte de notification.	BANNER (par défaut) / ALERT / NONE Type : String
Pushwoosh_BASEURL	Remplace l’URL de base du serveur Pushwoosh.	https://cp.pushwoosh.com/json/1.3/ (par défaut) Type : String
Pushwoosh_AUTO_ACCEPT_DEEP_LINK_FOR_SILENT_PUSH	Si YES, les liens profonds (Deep Links) reçus dans les notifications push silencieuses seront traités automatiquement.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALLOW_SERVER_COMMUNICATION	Autorise le SDK à envoyer des requêtes réseau aux serveurs Pushwoosh.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_DATA	Autorise le SDK à collecter et à envoyer les données de l’appareil (version du système d’exploitation, paramètres régionaux et modèle) au serveur.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_OS_VERSION	Autorise le SDK à collecter et à envoyer la version du système d’exploitation de l’appareil au serveur.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_LOCALE	Autorise le SDK à collecter et à envoyer les paramètres régionaux de l’appareil au serveur.	YES (par défaut) / NO Type : Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_MODEL	Autorise le SDK à collecter et à envoyer le modèle de l’appareil au serveur.	YES (par défaut) / NO Type : Boolean
Pushwoosh_LOG_LEVEL	Niveau de journalisation du SDK Pushwoosh. Pour plus de détails, consultez Contrôle du niveau de journalisation.	NONE / ERROR / WARNING / INFO (par défaut) / DEBUG / VERBOSE Type : String
Pushwoosh_PURCHASE_TRACKING_ENABLED	Autorise le SDK à suivre les achats intégrés à l’application. Nécessaire pour le Customer Journey Builder.	YES / NO (par défaut) Type : Boolean