AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.
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 l’application AEM Mobile avec des notifications importantes est essentielle à la valeur d’une application mobile et de ses campagnes marketing. Nous décrivons ici les étapes à suivre pour permettre à votre application de recevoir des notifications push, ainsi que la configuration et l’envoi de notifications push d’AEM Mobile vers l’application installée sur le téléphone. En outre, cette section décrit comment configurer la variable Lien profond de vos notifications push.
La diffusion des notifications push n’est pas garantie ; ce sont plutôt des annonces. Un effort est fourni pour s’assurer que chacun les reçoit mais qu’il ne s’agit pas d’un mécanisme de livraison garanti. En outre, la durée de diffusion d’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 fournisseur de service de notification push doit être utilisé pour gérer les notifications et les appareils (AEM ne le fait pas encore). Deux fournisseurs sont configurés d’usine 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é : Apple Push Notification Service (ou APNS) pour les appareils iOS ; et Google Cloud Messaging (ou GCM) pour appareils Android. Bien qu’AEM ne communique pas directement avec ces services spécifiques à la plateforme, des informations de configuration associées doivent être fournies par AEM avec les notifications afin que ces services exécutent la notification push.
Une fois installé et configuré (comme expliqué ci-dessous), il fonctionne comme suit :
Cette version d’AEM prend en charge les appareils 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 :
Pendant qu’un administrateur AEM :
Accédez à la page Apple here pour vous familiariser avec le service de notification push Apple.
Pour utiliser APNS, vous aurez besoin d’une Certificat fichier (fichier .cer), un fichier push Clé privée (un fichier .p12) et un Mot de passe de la clé privée d’Apple. Vous trouverez des instructions pour le faire here.
Google remplace GCM par un service similaire appelé Firebase Cloud Messaging (FCM). Pour plus d’informations sur FCM, cliquez sur here.
Accédez à la page Google . here pour vous familiariser avec Google Cloud Messaging pour Android.
Vous devrez suivre les étapes here to Création d’un projet d’API Google, Activation du service GCM, et Obtention d’une clé API. Vous aurez besoin de la variable Clé API pour envoyer des notifications push aux appareils Android. Enregistrez également votre Numéro de projet, qui est également parfois appelé Identifiant expéditeur GCM.
Les étapes suivantes présentent une autre méthode de création de clés d’API GCM :
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si cela ne fonctionne pas, réessayez avec "test.test".)Enregistrez la clé API du serveur. Cette valeur est saisie sur le site de votre fournisseur de services push.
AEM est configuré pour utiliser l’un des trois services pour les notifications push :
Amazon SNS et Pushwoosh les configurations vous permettent d’envoyer des notifications push depuis AEM écrans.
Adobe Mobile Services La configuration 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).
Vous trouverez des informations sur Amazon SNS et un lien pour créer un compte AWS. here. Vous pouvez avoir 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 :
Enregistrement auprès du SNS Amazon
Création d’une clé d’accès et d’un identifiant
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 ici :
Création d’une rubrique
Vous pouvez créer plusieurs rubriques pour différents scénarios tels que développement, test, 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 seront uniquement reçues par l’application créée avec cette rubrique.
Création d’applications Platform
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). En fonction de la plateforme, d'autres champs doivent être renseignés :
Répétez l’étape ci-dessus une fois pour chaque plateforme que vous prendrez en charge. Pour pouvoir envoyer des notifications push vers iOS et Android, deux applications Platform doivent être créées.
Création d’un pool d’identités
Configurer l’accès
{ "Version": "2012-10-17", "Instruction": [ { "Action": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effet" : "Autoriser", "Ressource": [ "*" ] } ] }
|
Si vous ne souhaitez pas utiliser Pushwoosh, vous pouvez ignorer cette étape.
Pour utiliser Pushwoosh :
Inscrivez-vous auprès de Pushwoosh
Création d’un jeton d’accès API
Créer une application
Si une seconde application est configurée en AEM avec le même ID d’application (et d’autres valeurs associées : Jeton d’accès API et ID GCM), toutes les notifications push envoyées via la seconde application sur AEM iront à toute autre application ayant 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=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0🔗" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="nt:unstructured"
excludeProperties="[appAPIActainToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
Le gestionnaire de synchronisation de contenu recherche ces noeuds. 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 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.
Pour les notifications push, vous devez tester un appareil 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 disponibles pour 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 la case à cocher 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éation et déploiement de l’application), vous devez d’abord mettre le téléphone en "mode développeur". Voir Activation des options du développeur sur appareil pour plus d’informations.
Avant de créer et de déployer sur votre appareil mobile configuré, vous devez configurer les paramètres de notification pour le service de messagerie que vous avez décidé d’utiliser.
Remarque : Reportez-vous également à nos instructions here lors de la création des applications PhoneGap.
Il existe deux manières de créer et 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 push (Apple ou Google) et l’appareil. Les émulateurs et le matériel Mac/PC actuels ne prennent pas en charge cette fonctionnalité.
PhoneGap Build est un service proposé par PhoneGap qui crée votre application pour vous sur leurs serveurs et vous permet de la télécharger directement sur votre appareil. Reportez-vous à la section Documentation du PhoneGap Build pour apprendre à configurer et à utiliser le PhoneGap Build.
Interface de ligne de commande PhoneGap (interface de ligne de commande) vous permet d’utiliser un vaste ensemble de commandes PhoneGap sur votre ligne de commande pour créer, déboguer et déployer votre application. Reportez-vous à la section Documentation destinée aux développeurs PhoneGap pour savoir comment configurer et utiliser l’interface de ligne de commande de 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 d’envoi, la confirme comme valide et l’envoie correctement 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 Envoyé.
Si l’envoi push échoue, la boîte de dialogue affiche un message indiquant le problème. Dans la liste des notifications, le statut de cette notification sera renseigné en tant qu'Erreur, mais si le problème est résolu, la notification peut être de nouveau envoyée. 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 plateforme 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.
La diffusion des notifications push n’est pas garantie ; ce sont plutôt des annonces. Un effort est fait pour s'assurer que tout le monde l'entend, mais qu'il ne s'agit pas d'un mécanisme de livraison garanti. En outre, la durée de diffusion d’une notification push peut varier de moins d’une seconde à une demi-heure.
Qu’est-ce que la création de liens profonds ? Dans le cadre d’une notification push, il est possible d’ouvrir ou de rediriger une application (si ouverte) vers un emplacement spécifié dans l’application.
Comment ça marche ? L’auteur d’une notification push ajoute éventuellement un libellé de bouton (c.-à-d. "Montrez-moi !") à la notification et choisissez la page qu'il souhaite lier dans la notification, via un navigateur de chemin 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 est spécifié ("Afficher moi !"). s’affiche également. Si vous cliquez 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’ombre s’affiche normalement. L’action sur la notification à l’ombre de celle-ci ouvre l’application, puis présente à 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, procédez comme suit.
Cliquez sur la modification dans le coin supérieur droit de la Gestion des Cloud Services mosaïque.
Sélectionnez la Connexion Pushwoosh. Cliquez sur Suivant.
Saisissez les détails des propriétés, puis cliquez sur Envoyer.
Une fois que vous avez envoyé votre configuration, la variable Notifications push s’affiche dans le tableau de bord.
Une fois que la variable Notifications push s’affiche dans votre tableau de bord, utilisez l’assistant de création de notification pour ajouter le contenu :
Cliquez sur le symbole d’ajout dans le coin supérieur droit de la Notifications push pour ouvrir la mosaïque 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 associé n’est pas disponible, confirmer l’action du lien profond amènera l’utilisateur à la page principale de l’application.
Saisissez le Détails du texte dans le 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 Notifications push mosaïque.
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 sous forme de module complémentaire à partir du partage de package.
Une fois que vous avez compris les détails des notifications push pour votre application, reportez-vous à la section Personnalisation du contenu AEM Mobile.