Show Menu
SUJETS×

Notifications Push

Adobe recommande d’utiliser l’éditeur d’application d’une seule page (SPA) pour les projets nécessitant un rendu côté client basé sur la structure SPA (par exemple, React). En savoir plus .
La possibilité d'alerter instantanément les utilisateurs de votre application AEM Mobile avec des notifications importantes est essentielle à la valeur d'une application mobile et de ses campagnes marketing. Ici, nous décrivons les étapes à suivre pour permettre à votre application de recevoir des notifications Push, et comment configurer et envoyer des notifications Push depuis AEM Mobile vers l'application installée sur votre téléphone. En outre, cette section décrit comment configurer la fonction de liaison #deeplinking profonde pour vos notifications Push.
La remise des notifications Push n'est pas garantie ; ce sont plutôt des annonces. Le mieux est de s'assurer que tout le monde les reçoit, mais ce n'est pas un mécanisme de livraison garanti. En outre, le temps nécessaire pour diffuser une notification Push peut varier de moins d’une seconde à une demi-heure.
L’utilisation des notifications Push avec AEM requiert quelques technologies différentes. Tout d’abord, un fournisseur de service de notification Push doit être utilisé pour gérer les notifications et les périphériques (AEM ne le fait pas encore). Deux fournisseurs sont configurés prêts à l’emploi avec AEM : Service de notification Amazon Simple (SNS) et Pushwoosh . Deuxièmement, la technologie Push du système d'exploitation mobile donné doit passer par le service approprié : Service de notifications Push (ou APNS) d’Apple pour les périphériques iOS ; et Google Cloud Messaging (ou GCM) pour périphériques Android. Bien qu’AEM ne communique pas directement avec ces services spécifiques à la plate-forme, AEM doit fournir certaines informations de configuration connexes avec les notifications pour que ces services exécutent la notification Push.
Une fois installé et configuré (comme expliqué ci-dessous), il fonctionne comme suit :
  1. Une notification Push est créée dans AEM et envoyée au fournisseur de services (Amazon SNS ou Pushwoosh).
  2. Le fournisseur de services le reçoit et l’envoie au fournisseur principal (APNS ou GCM).
  3. Le fournisseur principal envoie la notification à tous les périphériques enregistrés pour cette notification Push. Pour chaque périphérique, il utilise le réseau de données cellulaires ou le Wi-Fi, selon ce qui est actuellement disponible sur le périphérique.
  4. La notification s’affiche sur le périphérique si l’application pour laquelle il est enregistré n’est pas en cours d’exécution. Un utilisateur qui appuie sur la notification démarre l’application et affiche la notification dans l’application. Si l’application est déjà en cours d’exécution, seule la notification intégrée s’affiche.
Cette version d’AEM prend en charge les périphériques mobiles iOS et Android.

Aperçu et procédure

Pour utiliser les notifications Push dans une application AEM Mobile, vous devez suivre les étapes de haut niveau suivantes.
En règle générale, un développeur AEM :
  1. S’inscrire aux services de messagerie Apple et Google
  2. S’inscrire à un service de messagerie push et le configurer
  3. Ajout de la prise en charge Push à l’application
  4. Préparation d’un téléphone pour le test
Un administrateur AEM :
  1. Configuration de la fonction Push sur les applications AEM
  2. Création et déploiement de l’application
  3. Envoyer une notification Push
  4. Configuration d’un lien profond (facultatif)

Étape 1 : S’inscrire aux services de messagerie Apple et Google

Utilisation du service de notifications Push Apple (APNS)

Accédez à la page Apple ici pour vous familiariser avec le service de notifications Push Apple.
Pour utiliser APNS, vous devez disposer d’un fichier de certificat (fichier .cer), d’une clé ​privée Push (fichier .p12) et d’un mot de passe de clé privée d’Apple. Vous trouverez des instructions sur la façon de le faire ici .

Utilisation du service Google Cloud Messaging (GCM)

Google remplace GCM par un service similaire appelé Firebase Cloud Messaging (FCM). Pour plus d'informations sur FCM, cliquez ici .
Accédez à la page Google ici pour vous familiariser avec Google Cloud Messaging for Android.
Vous devez suivre les étapes ici pour créer un projet d’API Google, activer le service GCM et obtenir une clé API. Vous aurez besoin de la clé ​API pour envoyer des notifications Push aux périphériques Android. Enregistrez également votre numéro de projet, parfois appelé ID d’expéditeur GCM.
Les étapes suivantes montrent une autre méthode de création des clés d’API GCM :
  1. Connectez-vous à Google et accédez à la page Développeur de Google.
  2. Choisissez votre application dans la liste (ou créez-en une nouvelle).
  3. Sous Nom du pack Android, saisissez l’ID de votre application, c.-à-d. com.adobe.cq.mobile.weretail.outdoorsapp . (Si cela ne fonctionne pas, réessayez avec "test.test".)
  4. Cliquez sur Continuer pour sélectionner et configurer des services.
  5. Sélectionnez Cloud Messaging, puis cliquez sur Activer Google Cloud Messaging .
  6. La nouvelle clé d'API du serveur et (nouvelle ou existante) l'ID de l'expéditeur s'affichent alors.
Enregistrez la clé d’API du serveur. Cette valeur est saisie sur le site de votre fournisseur de services Push.

Étape 2 : Enregistrement et configuration d’un service de messagerie Push

AEM est configuré pour utiliser l’un des trois services pour les notifications Push :
  • SNS Amazon
  • Pushwoosh
  • Adobe Mobile Services
Les configurations Amazon SNS et Pushwoosh vous permettront d’envoyer des messages push depuis les écrans AEM.
La configuration d’Adobe Mobile Services vous permet de configurer et d’envoyer des notifications Push depuis Adobe Mobile Services à l’aide d’un compte Adobe Analytics (mais l’application doit être créée avec ce jeu de configuration pour activer les notifications Push AMS).

Utilisation du service de messagerie SNS Amazon

Vous trouverez des informations sur Amazon SNS et un lien pour créer un compte AWS ici . Vous pouvez obtenir un compte gratuit pendant un an.
Si vous ne souhaitez pas utiliser Amazon SNS, vous pouvez ignorer ces étapes.
Pour configurer Amazon SNS pour les notifications Push, procédez comme suit :
  1. Inscrivez-vous au SNS Amazon
    1. Enregistrez votre ID de compte. Le format doit être douze chiffres sans espace ni tiret, c’est-à-dire "123456789012".
    2. Assurez-vous d’être dans la région "us-east" (nous-est) ou "eu" (UE), car une étape ultérieure (Création d’un pool d’identités) nécessite l’une d’elles.
    3. Après l’enregistrement, connectez-vous à la console de gestion et sélectionnez SNS (service de notifications Push). Cliquez sur "Commencer" s'il apparaît.
  2. Créer une clé d’accès et un ID
    1. Cliquez sur votre nom de connexion dans l'angle supérieur droit de l'écran, puis choisissez Informations d'identification de sécurité dans le menu.
    2. Cliquez sur Clés d'accès et, dans l'espace ci-dessous, cliquez sur Créer une clé d'accès.
    3. Cliquez sur Afficher la clé d'accès, puis copiez et enregistrez l'ID de clé d'accès et la clé d'accès secrète affichés. Si vous choisissez l’option de téléchargement des clés, vous obtiendrez un fichier CSV contenant les mêmes valeurs.
    4. D’autres certificats liés à la sécurité, et d’autres, peuvent être gérés sur cette page.
    Une clé d’accès peut être utilisée pour plusieurs applications.
    Pour les organisations qui utilisent un compte "AWS Sandbox", les étapes sont très similaires et décrites ci-dessous :
    1. Cliquez sur votre nom de connexion dans l'angle supérieur droit de l'écran, puis choisissez Mes informations d'identification de sécurité dans le menu.
    2. Cliquez sur Utilisateurs dans la liste de gauche, puis choisissez votre nom d’utilisateur.
    3. Cliquez sur l’onglet Informations d’identification de sécurité.
    4. A partir de là, vous voyez vos clés et créez de nouvelles clés. Enregistrez les clés pour une utilisation ultérieure.
  3. Création d’une rubrique
    1. Cliquez sur Créer une rubrique et choisissez un nom de rubrique. Enregistrez tous les champs tels que ARN de la rubrique, Propriétaire de la rubrique, Région, Nom d’affichage.
    2. Cliquez sur Autres actions de rubrique > Modifier la stratégie de rubrique. Sous Autoriser ces utilisateurs à s’abonner à cette rubrique , sélectionnez Tout le monde.
    3. Cliquez sur Mettre à jour la stratégie .
    Vous pouvez créer plusieurs rubriques pour différents scénarios tels que le développement, le test, la démonstration, etc. Le reste de la configuration SNS peut rester le même. Créez l’application avec une rubrique différente ; Les notifications Push envoyées à cette rubrique ne seront reçues que par l’application créée avec cette rubrique.
  4. Création d’applications de plateformes
    1. Cliquez sur Applications, puis sur Créer une application de plateforme. Choisissez un nom et sélectionnez une plateforme (APNS pour iOS, GCM pour Android). Selon la plateforme, d’autres champs devront être remplis :
      1. Pour APNS, vous devez saisir un fichier P12, un mot de passe, un certificat et une clé privée. Ces informations auraient dû être obtenues lors de l’étape Utilisation du service de notifications Push Apple (APNS) ci-dessus.
      2. Pour GCM, une clé d’API doit être saisie. Cela aurait dû être obtenu lors de l’étape Utilisation du service Google Cloud Messaging (GCM) ci-dessus.
    2. Répétez l’étape ci-dessus une fois pour chaque plateforme que vous prendrez en charge. Pour pouvoir effectuer un push sur iOS et Android, deux applications de plateforme doivent être créées.
  5. Création d’un pool d’identité
    1. Utilisez Cognito pour créer un pool d’identités, qui stockera les données de base des utilisateurs non authentifiés. Notez que seules les régions "us-east" (nous-est) et "eu" sont actuellement prises en charge par Amazon Cognito.
    2. Donnez-lui un nom et cochez la case "Activer l’accès aux identités non authentifiées".
    3. Dans la page suivante (" Votre identité de cookie nécessite l’accès à vos ressources "), cliquez sur Autoriser.
    4. En haut à droite de la page, cliquez sur le lien " Modifier le pool d'identité" . L’ID du pool d’identités s’affiche. Enregistrez ce texte pour plus tard.
    5. Sur la même page, sélectionnez la liste déroulante en regard de "Rôle non authentifié" et assurez-vous qu’il a le rôle Cognito_<nom du pool>Rôle non autorisé sélectionné. Enregistrez vos modifications.
  6. Configurer l’accès
    1. Sélectionner des rôles
    2. Cliquez sur le rôle créé à l’étape précédente, appelé Cognito_<yourIdentityPoolName>Unauth_Role. Enregistrez le "ARN du rôle" affiché.
    3. Ouvrez "Stratégies en ligne" s’il n’est pas déjà ouvert. Une stratégie doit s’y afficher sous un nom tel que oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
    4. Cliquez sur "Modifier la stratégie". Remplacez le contenu du document de stratégie par ce fragment de code JSON :
    {
    "Version" : "2012-10-17",
    "Instruction": [
    {
    "Action": [
    "mobileanalytics:PutEvents",
    "cognito-sync:*",
    "SNS:CreatePlatformEndpoint",
    "SNS:Abonnement"
    ],
    "Effet" : "Allow",
    "Ressource": [
    "*"
    ]
    }
    ]
    }
    1. Cliquez sur Appliquer la stratégie

Utilisation du service de messagerie Pushwoosh

Si vous ne souhaitez pas utiliser Pushwoosh, vous pouvez ignorer cette étape.
Pour utiliser Pushwoosh :
  1. S'inscrire à Pushwoosh
    1. Allez sur pushwoosh.com et créez un compte.
  2. Création d’un jeton d’accès API
    1. Sur le site Pushwoosh, accédez au menu Accès API pour générer un jeton d’accès API. Vous devrez enregistrer ceci en toute sécurité.
  3. Créer une application
    1. Pour la prise en charge d’Android, vous devez fournir votre clé d’API GCM.
    2. Lors de la configuration de l'application, sélectionnez Cordova comme cadre.
    3. Pour la prise en charge iOS, vous devez fournir le fichier de certificat (.cer), le certificat Push (.p12) et le mot de passe de clé privée ; ils auraient dû être obtenus à partir du site APNS d’Apple. Pour Framework, sélectionnez Cordova.
    4. Pushwoosh génère un ID d’application pour cette application, sous la forme "XXXXX-XXXXX", où chaque X est une valeur hexadécimale (0 à F).
Si une seconde application est configurée dans AEM avec le même ID d’application (et d’autres valeurs associées : Jeton d’accès à l’API et ID GCM), toutes les notifications Push envoyées via la seconde application sur AEM iront à toute autre application avec cet ID d’application.

Étape 3 : Ajout de la prise en charge Push à l’application

Ajout de la configuration ContentSync

Créez deux noeuds de contenu (un dans app-config et un dans app-config-dev) appelés notificationsConfig :
  • /content/ <your app> /shell/jcr:content/page-app/app-config-dev/notificationsConfig
  • /content/ <your app> /shell/jcr:content/page-app/app-config/notificationsConfig
Avec ces propriétés (fichiers .content.xml) : <jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0 " xmlns:nt=" https://www.jcp.org/jcr/nt/1.0 " jcr:PrimaryType="nt:unstructured" excludeProperties=" #" path="../../../.." targetRootDirectory="www" type="notifications-config"/>
Le gestionnaire de synchronisation de contenu recherche ces noeuds et, s’ils ne sont pas présents, il n’écrit pas le fichier page-notifications-config.json.

Ajouter des bibliothèques clientes

Les bibliothèques clientes de notification Push doivent être ajoutées à l’application en procédant comme suit :
Dans CRXDE Lite :
  1. Accédez à /etc/designs/phonegap/<nom de l’application>/clientlibsall.
  2. Cliquez deux fois sur la section d’intégration dans le volet des propriétés.
  3. Dans la boîte de dialogue qui s'affiche, ajoutez une nouvelle bibliothèque cliente en cliquant sur le bouton +.
  4. Dans le nouveau champ de texte, ajoutez "cq.mobile.push", puis cliquez sur OK.
  5. Ajoutez-en un autre appelé cq.mobile.push.amazon, puis cliquez sur OK.
  6. Enregistrez les modifications.
Si les notifications Push sont supprimées, ou ne sont pas utilisées, pour des raisons d’espace sur l’application et pour éviter les messages d’erreur de la console, supprimez ces clientlibs de votre application.

Étape 4 : Préparation d’un téléphone pour le test

Pour les notifications Push, vous devez effectuer un test sur un périphérique réel, car les émulateurs ne peuvent pas recevoir de notifications Push.

IOS

Pour iOS, vous devez utiliser un ordinateur Mac OS et rejoindre le programme de développement iOS. Certaines sociétés ont des licences d'entreprise qui peuvent être mises à la disposition de tous les développeurs.
Avec XCode 8.1, avant d’utiliser les notifications Push, vous devez accéder à l’onglet Fonctionnalités de votre projet et activer/désactiver l’option Notifications Push.

Android

Pour installer l’application sur un téléphone Android à l’aide de l’interface de ligne de commande (voir ci-dessous : Étape 6 - Créer et déployer l’application ), vous devez d’abord mettre le téléphone en "mode développeur". Voir Activation des options pour les développeurs sur périphérique pour en savoir plus.

Étape 5 : Configuration de la fonction Push sur les applications AEM

Avant de créer et de déployer sur votre périphérique mobile configuré, vous devez configurer les paramètres de notification pour le service de messagerie que vous avez décidé d’utiliser.
  1. Créez les groupes d’autorisations appropriés pour les notifications Push.
  2. Connectez-vous à AEM en tant qu’utilisateur approprié, puis cliquez sur l’onglet Applications.
  3. Cliquez sur l’application.
  4. Recherchez la mosaïque Gérer les services cloud et cliquez sur le crayon pour modifier vos configurations de cloud.
  5. Sélectionnez Amazon SNS Connection, Pushwoosh Connection ou Adobe Mobile Services comme configuration de notification.
  6. Saisissez les propriétés du fournisseur, puis cliquez sur Envoyer pour les enregistrer, puis sur Terminé. Elles ne sont pas vérifiées à distance à ce stade, sauf dans le cas de l'AMS.
  7. Vous devriez maintenant voir la configuration que vous venez de saisir dans le volet Gérer les services Cloud.

Étape 6 : Création et déploiement de l’application

​Remarque : Reportez-vous également à nos instructions ici sur la création d'applications PhoneGap.
Il existe deux manières de créer et de déployer votre application à l’aide de PhoneGap.
​Remarque : Pour les tests de notification Push, les émulateurs ne suffiront pas, car les notifications Push utilisent un protocole distinct entre le fournisseur de notifications Push (Apple ou Google) et le périphérique. Le matériel et les émulateurs Mac/PC actuels ne le prennent pas en charge.
  1. PhoneGap Build est un service offert par PhoneGap qui va créer votre application pour vous sur leurs serveurs et vous permettre de la télécharger directement sur votre appareil. Reportez-vous à la documentation de PhoneGap Build pour savoir comment configurer et utiliser PhoneGap Build.
  2. L’interface de ligne de commande PhoneGap (CLI) vous permet d’utiliser un riche ensemble de commandes PhoneGap sur votre ligne de commande pour créer, déboguer et déployer votre application. Reportez-vous à la documentation destinée aux développeurs PhoneGap pour savoir comment configurer et utiliser PhoneGap CLI.

Étape 7 : Envoyer une notification Push

Pour créer une notification et l’envoyer, procédez comme suit.
  1. Créer une notification
    • Dans le tableau de bord de votre application AEM Mobile, recherchez le volet Notifications Push.
    • Dans le menu en haut à droite, choisissez "Créer". Notez que ce bouton ne sera pas disponible tant que la configuration du cloud n’aura pas été définie pour la première fois.
    • Dans l'Assistant Créer une notification, saisissez un titre et un message, puis cliquez sur le bouton Créer. Votre notification est maintenant prête à être envoyée immédiatement ou ultérieurement. Il peut être modifié et le message et/ou le titre peuvent être modifiés et enregistrés.
  2. Envoyer la notification
    • Dans le tableau de bord Applications, recherchez le volet Notifications Push.
    • Sélectionnez la notification ou cliquez sur le bouton des détails en bas à droite (.. .), pour afficher la liste des notifications. Cette liste indique également si une notification est prête à être envoyée, a déjà été envoyée ou si une erreur s’est produite lors de l’envoi.
    • Cochez la case correspondant à une notification (seulement) et cliquez sur le bouton "Envoyer la notification" au-dessus de la liste. Vous aurez la possibilité d’annuler ou d’envoyer la notification dans la boîte de dialogue qui s’affiche.
  3. Traitement des résultats
    • Si le service de notification Push (Amazon SNS ou Pushwoosh) reçoit la demande d’envoi, la confirme comme valide et l’envoie aux fournisseurs natifs (APNS et GCM), la boîte de dialogue d’envoi se ferme sans message. Dans la liste des notifications, le statut de cette notification est indiqué comme Envoyé.
    • Si l'envoi push échoue, la boîte de dialogue affiche un message indiquant le problème. Dans la liste de notification, l’état de cette notification est indiqué comme Erreur, mais si le problème est résolu, la notification peut être envoyée à nouveau. En cas d’erreur, des informations d’erreur supplémentaires doivent apparaître dans le journal des erreurs du serveur.
    • Notez qu’il existe des différences de plate-forme entre les notifications Push iOS et Android. Parmi eux :
      • Une fois l’application déployée sur Android, elle sera lancée lors de la création avec l’interface de ligne de commande. Sous iOS, vous devez le démarrer manuellement. Comme l’étape d’enregistrement Push se produit au démarrage, les applications Android peuvent recevoir des notifications Push immédiatement (puisqu’elles auront démarré et sont enregistrées), contrairement aux applications iOS.
      • Sous Android, le texte du bouton OK se trouve dans toutes les capitales (et dans tous les autres boutons ajoutés à la notification in-app), contrairement à iOS.
Pour les notifications Push AMS, les notifications doivent être composées et envoyées à partir du serveur AMS. AMS fournit des fonctionnalités de notification Push supplémentaires au-delà de celles fournies par les notifications AEM avec AWS et Pushwoosh.
La remise des notifications Push n'est pas garantie ; ce sont plutôt des annonces. Le mieux est de s'assurer que tout le monde l'entend, mais ce n'est pas un mécanisme de livraison garanti. En outre, le temps nécessaire pour diffuser une notification Push peut varier de moins d’une seconde à une demi-heure.

Configuration de liens profonds avec des notifications Push

Qu'est-ce que le lien profond ? Dans le contexte d’une notification Push, il s’agit d’un moyen de permettre à une application d’être ouverte ou dirigée (si elle est ouverte) vers un emplacement spécifié dans l’application.
Comment ça marche ? L’auteur d’une notification Push ajoute éventuellement une étiquette de bouton (c.-à-d. "Montre-moi !") à la notification et choisit la page qu’il souhaite lier dans la notification, via un navigateur de chemin visuel. Lors de l’envoi, la notification Push se produit normalement, sauf que dans le message in-app, le bouton OK est remplacé par un bouton "Ignorer" et le nouveau bouton est spécifié ("Afficher !"). apparaît également. En cliquant sur le nouveau bouton, l’application accède à la page spécifiée dans l’application. En cliquant sur Ignorer, vous ignorez simplement le message.
Si l’application n’est pas ouverte, l’ombrage apparaîtra normalement. L’action sur la notification à l’ombre ouvrira l’application, puis présentera à l’utilisateur les boutons de lien profond en fonction de ce qui a été configuré dans la notification Push.
Créez la notification, ajoutez un texte de bouton et un chemin de lien pour le lien profond facultatif :
.Pour accéder au volet Notification Push dans votre tableau de bord, procédez comme suit.
  1. Cliquez sur la modification dans le coin supérieur droit du volet Gérer les services Cloud.
  2. Sélectionnez Connexion Pushwoosh. Cliquez sur Suivant .
  3. Saisissez les détails des propriétés, puis cliquez sur Envoyer .
    Une fois votre configuration envoyée, la mosaïque Notifications ​Push s’affiche dans le tableau de bord.

Assistant de création de notification

Une fois que la mosaïque Notifications ​Push s’affiche dans votre tableau de bord, utilisez l’assistant de création de notifications pour ajouter le contenu :
  1. Cliquez sur le symbole d’ajout dans le coin supérieur droit du volet Notifications ​Push pour ouvrir l’Assistant ​Créer une notification.
  2. En cliquant sur l’icône Parcourir dans le chemin du lien, l’utilisateur voit la structure de contenu de l’application.
    Une fois le chemin sélectionné, cliquez sur l’icône représentant une coche.
    Le texte du bouton de lien est limité à 20 caractères.
    Si l’utilisateur final ne dispose pas de la dernière version de l’application et que le chemin d’accès lié n’est pas disponible, la confirmation de l’action du lien profond amènera l’utilisateur sur la page principale de l’application.
  3. Saisissez les détails du texte dans l’Assistant ​Créer une notification et cliquez sur Créer .
    Ouvrez les détails en cliquant sur la notification Push que vous avez créée à partir du volet Notifications Push.
    Vous pouvez modifier les propriétés, envoyer des notifications ou supprimer la notification.
Informations supplémentaires :
Pushwoosh et Amazon SNS ne seront pas pris en charge après la version 6.4 et seront disponibles en tant que module complémentaire à partir du partage de package.

Étapes suivantes

Une fois que vous avez compris les détails des notifications Push pour votre application, reportez-vous à la page Personnalisation du contenu AEM Mobile.