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 d'AEM Mobile à l'application installée sur votre téléphone. En outre, cette section décrit comment configurer la fonction Liaison profonde pour vos notifications Push.
Les notifications Push ne sont pas garanties de diffusion ; ce sont plutôt des annonces. Le meilleur effort est fait pour s'assurer que tout le monde les reçoit, mais ce n'est pas un mécanisme de diffusion garanti. En outre, le temps nécessaire pour diffuser une notification Push peut varier de moins d'une seconde à une demi-heure.
L’utilisation de notifications Push avec AEM nécessite quelques technologies différentes. Tout d'abord, un prestataire 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 : Amazon Simple Notification Service (ou SNS) et Pushwoosh. Deuxièmement, la technologie Push pour le système d'exploitation mobile donné doit passer par le service approprié — Service de notification Push (ou APNS) d'Apple pour les périphériques iOS ; et Google Cloud Messaging (ou GCM) pour appareils Android. Bien que AEM ne communique pas directement avec ces services spécifiques à la plate-forme, des informations de configuration connexes doivent être fournies par AEM avec les notifications pour que ces services exécutent la commande push.
Une fois installé et configuré (comme expliqué ci-dessous), il fonctionne comme suit :
Cette version d’AEM prend en charge les périphériques mobiles iOS et Android.
Pour utiliser les notifications Push dans une application AEM Mobile, les étapes de haut niveau suivantes doivent être effectuées.
En règle générale, un développeur AEM :
Un administrateur AEM :
Accédez à la page Apple ici pour vous familiariser avec le service de notifications Push Apple.
Pour utiliser APNS, vous aurez besoin d’un fichier Certificate (un fichier .cer), d’une clé privée push (un 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.
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 à Créer un projet d'API Google, Activer le service GCM et Obtenir une clé d'API. Vous aurez besoin de la clé d'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 :
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si cela ne fonctionne pas, réessayez avec "test.test".)Enregistrez la clé d'API du serveur. Cette valeur est saisie sur le site de votre fournisseur de notifications Push.
aem est configuré pour utiliser l’un des trois services pour les notifications Push :
Les configurations Amazon SNSet ** Pushwooshs vous permettront d'envoyer des messages push depuis AEM écrans.
La configuration de 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 cette configuration pour activer les notifications Push AMS).
Vous trouverez des informations sur Amazon SNS et un lien pour créer un nouveau compte AWS ici. Vous pouvez obtenir un compte gratuit pour 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 :
S'inscrire au SNS Amazon
Créer une clé et un ID d’accès
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 sont décrites ci-dessous :
Création d’une rubrique
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.
Création d’applications de plateformes
Cliquez sur Applications, puis sur Créer une application de plateforme. Choisissez un nom et sélectionnez une plate-forme (APNS pour iOS, GCM pour Android). En fonction de la plateforme, d’autres champs devront être renseignés :
Répétez l’étape ci-dessus une fois pour chaque plateforme que vous prendrez en charge. Pour être en mesure d’effectuer des notifications Push sur iOS et Android, deux applications de plateforme doivent être créées.
Création d’un pool d’identité
Configurer l’accès
{ "Version" : "2012-10-17", "Instruction": [ { "Action": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effet" : "Allow", "Resource": [ "*" ] } ] }
|
Si vous ne souhaitez pas utiliser Pushwoosh, vous pouvez ignorer cette étape.
Pour utiliser Pushwoosh :
S'inscrire avec Pushwoosh
Création d’un Jeton d'accès d’API
Créer une application
Si une seconde application est configurée dans AEM avec le même ID d’application (et les autres valeurs associées) : JETON D'ACCÈS d’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.
Créez deux noeuds de contenu (un dans app-config et un dans app-config-dev) appelés notificationsConfig :
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigAvec 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="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
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.
Les bibliothèques clientes de notification Push doivent être ajoutées à l’application en procédant comme suit :
En CRXDE Lite :
Si des 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.
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.
Pour iOS, vous devez utiliser un ordinateur Mac OS et rejoindre le Programme de développement iOS. Certaines sociétés disposent de 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.
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 du développeur sur périphérique pour plus d’informations sur cette opération.
Avant de créer et de déployer sur votre périphérique mobile configuré, vous devez configurer les paramètres de notification du service de messagerie que vous avez décidé d’utiliser.
Remarque : Reportez-vous également à nos instructions ci-dessous pour créer des applications PhoneGap.
Il existe deux façons 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 notification Push (Apple ou Google) et le périphérique. Le matériel et les émulateurs Mac/PC actuels ne prennent pas en charge cette fonction.
PhoneGap Buildis est un service proposé 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. Consultez la documentation sur le PhoneGap Build pour savoir comment configurer et utiliser le PhoneGap Build.
L'interface de ligne de commande PhoneGap (CLI) vous permet d'utiliser un ensemble riche de commandes PhoneGap sur votre ligne de commande pour créer, déboguer et déployer votre application. Consultez la documentation destinée aux développeurs PhoneGap pour savoir comment configurer et utiliser l’interface de ligne de commande PhoneGap.
Pour créer une notification et l’envoyer, procédez comme suit.
Créer une notification
Envoyer la notification
Traitement des résultats
Si le service de notification Push (Amazon SNS ou Pushwoosh) reçoit la demande Envoyer, la confirme comme valide et l’envoie aux fournisseurs natifs (APNS et GCM), la boîte de dialogue Envoyer se ferme sans message. Dans la liste de notification, 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 de nouveau. Dans le événement d’une erreur, des informations d’erreur supplémentaires doivent apparaître dans le journal des erreurs du serveur.
Notez qu’il existe certaines différences de plate-forme entre les notifications Push iOS et Android. Parmi eux :
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.
Les notifications Push ne sont pas garanties de diffusion ; ce sont plutôt des annonces. Le meilleur effort est fait pour s'assurer que tout le monde l'entend, mais ce n'est pas un mécanisme de diffusion garanti. En outre, le temps nécessaire pour diffuser une notification Push peut varier de moins d'une seconde à une demi-heure.
Qu'est-ce que la liaison profonde ? Dans le contexte d’une notification Push, il s’agit d’un moyen d’autoriser l’ouverture ou la redirection (le cas échéant) d’une application à 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 sélectionne la page qu’ils souhaitent lier dans la notification, via un navigateur de chemins d’accès visuel. Lorsqu’elle est envoyée, 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 spécifié ("Afficher moi !"). apparaît également. En cliquant sur le nouveau bouton, l’application accède à la page indiquée dans l’application. Cliquez sur Ignorer pour ignorer le message.
Si l’application n’est pas ouverte, l’ombrage apparaîtra normalement. Une 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 à la mosaïque Notification Push dans votre tableau de bord, suivez les étapes ci-dessous.
Cliquez sur l’édition située dans le coin supérieur droit de la mosaïque Gérer les Cloud Services.
Sélectionnez Connexion Pushwoosh. Cliquez sur Next (Suivant).
Saisissez les détails des propriétés et cliquez sur Envoyer.
Une fois votre configuration envoyée, la mosaïque Notifications Push s’affiche dans le tableau de bord.
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 :
Cliquez sur le symbole d’ajout situé dans le coin supérieur droit de la mosaïque Notifications Push pour ouvrir l’Assistant Créer une notification.
Cliquez sur l’icône Parcourir dans le chemin du lien pour présenter à l’utilisateur 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.
Saisissez le texte Détails 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 de la mosaïque 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.
Une fois que vous avez compris les détails des notifications Push pour votre application, voir Personnalisation du contenu AEM Mobile.