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).
info
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 vous venez d'un autre fournisseur push
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 |
Avertissement
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 bon Software Development Kit (SDK), mis en ligne par l'équipe Actito en fonction du type de plateforme. Ensuite, suivez les guides de mise en oeuvre (liens ci-dessous).
2. Implémenter le SDK
Le processus étant très différent entre le Web, Android et IOS, et entre les frameworks spécifiques, veuillez vous référer directement à la documentation Notificare en fonction des plateformes concernées pour vos applications.
Vous pouvez suivre les sections Implementation, Device registration et Remote Notifications du guide de set-up (en vous aidant des échantillons du guide de dépannage si nécessaire).
astuce
Les configuration files référencées dans la section "Implementation" est le fichier du SDK que vous avez récupéré dans la transferbox.
Si vous utilisez une framework dédiée pour développer votre app (comme Cordova, Ionic, Flutter ou React), 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
| 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 fonctions minimums doivent être implémentées :
- Enregistrement de l'appareil (Device registration)
- Enregistrer un utilisateur (Register as a user)
- Demander une autorisation (Requesting permission ou 'Authorization options' pour iOS)
- Recevoir des notifications (Receiving Notifications)
note
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
La section de Server Key (legacy) section et la fonctionnalité de Google Maps n'est pas supportée.
3. Attribuer un identifiant de client final à un appareil abonné
Objectif
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.
info
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.