Configurer les Notifications Push pour Apps Mobiles
Pour vous permettre d'utiliser les notifications push dans votre stratégie multicanal, Actito est directement intégré à notre plateforme Notificare, une solution de notifications push récemment acquise par Actito.
Cette section vous guidera à travers les instructions que vous devez suivre pour configurer le canal de notification push de type App (pour les applications mobiles).
Si vous avez uniquement un site web, veuillez suivre le guide de set-up pour le Web Push.
Si vous voulez déployer le canal push à la fois sur votre site web et votre app, veuillez suivre les deux guides. Le set-up peut être fait en parallèle ou l'un à la suite de l'autre.
Les utilisateurs de smartphone peuvent naviguer sur la version mobile de votre site web. Tant que c'est fait via un navigateur web et pas une app, cela compte comme le canal Web.
Il y a 3 étapes :
-
Étape n°1 : Configuration des plateformes
-
Étape n°2 : Configuration de votre application native et de votre site Web
-
Étape n°3 : Définition de la pop-up pour obtenir des abonnements
Étape #1 : Mise en place de la configuration des plateformes
En fonction de la plateforme utilisée pour envoyer la notification push (application Android/iOS/Huawei), Actito doit configurer le canal pour envoyer correctement la notification push via Notificare.
Pour commencer, veuillez suivre le document de set-up pour la plateforme correspondante (voir ci-dessous) pour créer un compte de service Firebase (Android), une clé d'authentification APNS (iOS) et/ou un projet HMS (Huawei). Les clés ou identifiants correspondants devront être fournis aux équipes Actito.
Si possible, nous vous recommandons de conserver les mêmes identifiants et de garder le compte Firebase, la clé APNS et/ou le projet HMS existant.
Veuillez les fournir aux équipes Actito (via la Transfer Box de votre licence) et suivre le guide de migration.
| Plateforme | Ce dont Actito a besoin pour la configuration | Ressources pour vous aider à fournir des informations à Actito | Ce qu'Actito vous fournit |
|---|---|---|---|
| Android | Clé du compte de service (fichier json) | Document de configuration Android | Fichiers de configuration du SDK pour Android |
| iOS | Clé d'authentification APNS : - Fichier .p8 - ID de clé - ID de bundle - ID d'équipe | Document de configuration iOS | Fichiers de configuration du SDK pour iOS |
| Huawei | ID de l'application Secret key de l'application | Document de configuration HMS | - Fichiers de configuration SDK pour Android - Adresse de rappel - Certificat HTTPS (format pem) - Utilisateur de callback - Clé de callback |
Pour partager des éléments sensibles comme les fichiers SDK ou les clés pour les plateformes Android/Huawei/iOS, nous utilisons la Transfer Box d'Actito.
Les fichiers de configuration du SDK pour applications seront déposés dans la Transfer Box de votre licence.
Actito vous avertira lorsque la ou les plates-formes auront été configurées avec succès, vous pourrez ainsi passer à l'étape 2.
Étape #2 : Configurer votre application native
Le set-up technique peut se résumer en 2 étapes principales :
1. Récupérer le SDK
Connectez-vous à votre licence Actito et accédez à l'application Transfer box. Vous pourrez récupérer le fichier de configuration du Software Development Kit (SDK), mis en ligne par l'équipe Actito en fonction du type de plateforme.
Vous devez également récupérer le Répertoire Git Notificaire pour l'App push pertinent.
2. Implémenter le SDK
Le processus étant très différent entre Android et IOS, veuillez suivre le guide approprié.
Guides d'implémentation
Plateforme native
| Plateforme | Implémentation | Troubleshooting | Ressources |
|---|---|---|---|
| Android | Implémentation Android | Dépannage Android | - Échantillons - Tailles des dépendances |
| iOS | Implémentation iOS | Dépannage iOS | - Échantillons - Tailles des dépendances |
Framework Si vous utilisez un framework spécifique pour développer votre application (comme Cordova, Ionic, Flutter ou React) veuillez suivre le guide dédié.
| Plateforme | Implémentation | Troubleshooting | Ressources |
|---|---|---|---|
| Cordova | Implémentation Cordova | Dépannage Cordova | Échantillons Cordova |
| Ionic native | Implémentation ionic | Dépannage Ionic | Échantillons ionic |
| Flutter | Implémentation Flutter | Dépannage Flutter | Échantillons Flutter |
| React native | Implémentation React | Dépannage React | Échantillons React |
Fonctions de base
Comme tous les sites web ne vont pas faire usages de toutes les fonctionnalités offertes par le canal push, le SDK est flexible et vous pouvez choisir quels modules sont implémentées (voir les fonctionnalités supportées ci-dessous).
Les fonctionnalités suivantes sont prises en charge dans le module de notifications push Actito :
Enregistrement de l'appareil
- S'inscrire en tant qu'utilisateur
- Remplacer la langue de l'appareil
Notifications à distance
- Demander une autorisation
- Activer les notifications
- Désactiver les notifications à distance
- Recevoir des notifications
Inbox
D'autres fonctionnalités que vous avez peut-être trouvées directement dans la documentation de Notificare ou dans les liens de Github (telles que la section Server Keys et la fonctionnalité Google Maps) ne sont actuellement pas prises en charge.
3. Attribuer un identifiant de client final à un appareil abonné
En enregistrant un identifiant de client final sur l'appareil abonné, Actito pourra relier l'appareil à un profil existant dans Actito et créer une vue centralisée autour du profil.
L'identifiant du client final sera défini par votre système (ex : votre CRM).
L'attribution de l'identifiant du client final à un appareil aura lieu lorsqu'un profil opte pour les notifications push et est connu de votre système (ex : connecté à votre site/application) et que vous avez bien configuré la fonction "Register as a user".
Le même identifiant client final doit être disponible dans la table des profils Actito, pour pouvoir connecter les profils sur les 3 systèmes.
Par conséquent, pour choisir le bon identifiant de client final :
- Les données doivent être disponibles sous forme de clé dans Actito grâce à la synchronisation des données entre votre système et Actito.
- Les données doivent être disponibles sur votre site internet ou sur votre application mobile.
Veuillez utiliser un attribut déjà défini comme unique sur votre table de profil Actito.
Si vous devez ajouter un nouvel attribut unique, cela est possible, mais soyez prudent car cela pourrait avoir des impacts sur votre processus de synchronisation des données entre votre système et Actito. Demandez à votre expert en données d'intégration si nécessaire.
Étape n°3 : Configuration de la pop-up pour obtenir des abonnements
Pour les applications natives, la pop-up doit être gérée en utilisant la fonction d'activation et de désactivation des notifications (implémentation technique nécessaire dans l'application)
Veuillez vous assurer de bien implémenter les sections "Requesting permission" (Android) ou "Authorization options" (iOS) des guides d'implémentation.
Portée du canal
Seuls les profils qui mettent à jour leur application native avec la version contenant le SDK fourni lors de la configuration peuvent être ciblés par les campagnes Actito.