Aller au contenu principal

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.

PlateformeCe dont Actito a besoin pour la configurationRessources pour vous aider à fournir des informations à ActitoCe qu'Actito vous fournit
AndroidClé du compte de service (fichier json)Document de configuration AndroidFichiers de configuration du SDK pour Android
iOSClé d'authentification APNS :
- Fichier .p8
- ID de clé
- ID de bundle
- ID d'équipe
Document de configuration iOSFichiers de configuration du SDK pour iOS
HuaweiID 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

PlateformeImplémentationTroubleshootingRessources
AndroidImplémentation AndroidDépannage Android- Échantillons
- Tailles des dépendances
iOSImplémentation iOSDépannage iOS- Échantillons
- Tailles des dépendances

Framework

PlateformeImplémentationTroubleshootingRessources
CordovaImplémentation CordovaDépannage CordovaÉchantillons Cordova
Ionic nativeImplémentation ionicDépannage IonicÉchantillons ionic
FlutterImplémentation FlutterDépannage FlutterÉchantillons Flutter
React nativeImplémentation ReactDé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)
remarque

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.