Notifications Push push-notifications
La possibilité d’alerter instantanément les utilisateurs de l’application mobile Adobe Experience Manager (AEM) avec des notifications importantes est essentielle à la valeur d’une application mobile et de ses campagnes marketing. Ici, des étapes doivent être suivies pour permettre à votre application de recevoir des notifications push. Vous apprenez également à configurer et à envoyer des notifications push d’AEM Mobile vers l’application installée sur le téléphone. Cette section décrit également comment configurer la fonction Lien profond pour vos notifications push.
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 énumérations et les appareils (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é : Apple Push Notification Service (ou APNS) pour les appareils iOS et Google Cloud Messaging (ou GCM) pour les 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 pour que ces services exécutent la notification push.
Une fois installé et configuré (comme expliqué ci-dessous), il fonctionne comme suit :
- Une notification push est créée dans AEM et envoyée au prestataire (Amazon SNS ou Pushwoosh).
- Le prestataire le reçoit et l'envoie au prestataire principal (APNS ou GCM).
- Le fournisseur principal envoie la notification à tous les appareils enregistrés pour cette notification push. Pour chaque appareil, il utilise le réseau de données cellulaires ou le Wi-Fi, selon ce qui est disponible sur l’appareil.
- La notification s’affiche sur l’appareil 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 in-app s’affiche.
Cette version d’AEM prend en charge les appareils mobiles iOS et Android™.
Présentation et procédure overview-and-procedure
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 Experience Manager effectue les opérations suivantes :
- Enregistrement auprès des services de messagerie Apple et Google
- Enregistrez-vous avec un service de messagerie push et configurez-le.
- Ajout de la prise en charge des notifications push à l’application
- Préparation d’un téléphone pour le test
Lorsqu’un administrateur Experience Manager effectue les opérations suivantes :
- Configuration des notifications push sur les applications AEM
- Création et déploiement de l’application
- Envoi d’une notification push
- Configuration de liens profonds (facultatif)
Étape 1 : Enregistrement auprès des services de messagerie Apple et Google step-register-with-apple-and-google-messaging-services
Utilisation du service de notification push Apple (APNS) using-the-apple-push-notification-service-apns
Accédez à la page Apple ici pour vous familiariser avec le service de notification push Apple.
Pour utiliser les APN, vous avez 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 pour le faire ici.
Utilisation du service Google Cloud Messaging (GCM) using-the-google-cloud-messaging-gcm-service
Accédez à la page Google ici pour vous familiariser avec Google Cloud Messaging pour Android™.
Suivez ces étapes pour créer un projet d’API Google, activer le service GCM et obtenir une clé API. Vous avez besoin de la clé API pour envoyer des notifications push aux appareils 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 de clés API GCM :
- Connectez-vous à Google et accédez à la page développeur Google.
- Sélectionnez votre application dans la liste (ou créez-en une).
- Sous Android™ Nom de module, saisissez votre ID d’application, c’est-à-dire
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si cela ne fonctionne pas, réessayez avec "test.test".) - Cliquez sur Continuer pour sélectionner et configurer des services
- Sélectionnez Cloud Messaging, puis cliquez sur Activer Google Cloud Messaging.
- La nouvelle clé API du serveur et l’ ID d’expéditeur (nouveau ou existant) s’affichent alors.
Étape 2 : enregistrement et configuration d’un service de messagerie push step-register-and-configure-a-push-messaging-service
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 permettent d’envoyer des messages push depuis AEM écrans.
La configuration 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 définie pour activer les notifications push AMS).
Utilisation du service de messagerie SNS Amazon using-the-amazon-sns-messaging-service
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
- Enregistrez votre ID de compte. Le format doit être 12 chiffres sans espaces ni tirets, c’est-à-dire "123456789012".
- Assurez-vous que vous vous trouvez dans la région "us-est" ou "eu", car une étape ultérieure (Création de pool d’identités) nécessite l’une d’elles.
- Après l’enregistrement, connectez-vous à la console de gestion et sélectionnez SNS (Service de notification push). Cliquez sur "Commencer" s’il apparaît.
-
Créer une clé d’accès et un ID
- Cliquez sur votre nom de connexion en haut à droite de l’écran, puis sélectionnez Informations d’identification de sécurité dans le menu.
- Cliquez sur Accéder aux clés, puis, dans l’espace ci-dessous, cliquez sur Créer une clé d’accès.
- Cliquez sur Afficher la clé d’accès, copiez et enregistrez l’identifiant 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 obtenez un fichier csv contenant les mêmes valeurs.
- D’autres certificats liés à la sécurité, et d’autres, peuvent être gérés sur cette page.
note note NOTE Une clé d’accès peut être utilisée pour plusieurs applications. Pour les organisations qui utilisent un compte "AWS Sandbox", les étapes sont similaires et décrites ici :
- Cliquez sur votre nom de connexion en haut à droite de l’écran, puis sélectionnez Mes informations d’identification de sécurité dans le menu.
- Cliquez sur Utilisateurs dans la liste d’actions à gauche, puis sélectionnez votre nom d’utilisateur.
- Cliquez sur l’onglet Informations d’identification de sécurité .
- 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.
-
Créer une rubrique
- Cliquez sur Créer une rubrique et choisissez un nom de rubrique. Enregistrez tous les champs tels que Topic ARN, Topic Owner, Region, Display name.
- 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.
- Cliquez sur Mettre à jour la stratégie.
note note NOTE Vous pouvez créer plusieurs rubriques pour différents scénarios tels que le développement, le test et la démonstration. Le reste de la configuration SNS peut rester le même. Créez l’application avec les différentes rubriques ; les notifications push envoyées à cette rubrique ne seront reçues que par l’application créée avec cette rubrique. -
Créer des applications de plateforme
-
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. les autres champs doivent être renseignés :
- Pour APNS, un fichier P12, un mot de passe, un certificat et une clé privée doivent tous être renseignés. Elles doivent avoir été obtenues à l’étape Utilisation du service de notification push Apple (APNS) ci-dessus.
- Pour GCM, une clé API doit être saisie. Cela aurait dû être obtenu à l’étape Utilisation du service Google Cloud Messaging (GCM) ci-dessus.
-
Répétez l’étape ci-dessus une fois pour chaque plateforme que vous prenez en charge. Pour pouvoir envoyer des notifications push vers iOS et Android™, deux applications Platform doivent être créées.
-
-
Créer un pool d’identités
- Utilisez Cognito pour créer un pool d’identités qui stockera les données de base des utilisateurs non authentifiés. Remarque : Actuellement, seules les régions "us-east" (nous-est) et "eu" sont prises en charge par Amazon Cognito.
- Attribuez-lui un nom et cochez la case "Autoriser l’accès aux identités non authentifiées".
- Sur la page suivante ("Vos identités de cookies requièrent l’accès à vos ressources"), cliquez sur Autoriser.
- Dans le coin supérieur droit de la page, cliquez sur le lien "Modifier le pool d’identités". L’identifiant du pool d’identités s’affiche. Enregistrez ce texte pour plus tard.
- Sur la même page, sélectionnez la liste déroulante en regard de "Rôle non authentifié" et assurez-vous qu’il dispose du rôle Cognito_<nom du pool>UnauthRole sélectionné. Enregistrez vos modifications.
-
Configurer l’accès
- Connectez-vous à Identity and Access Management (IAM).
- Sélectionnez Rôles.
- Cliquez sur le rôle créé à l’étape précédente, appelé Cognito_<yourIdentityPoolName>Unauth_Role. Enregistrez le "Role ARN" affiché.
- Ouvrez "Stratégies intégrées" si elles ne sont pas déjà ouvertes. Vous devriez y voir une stratégie portant le nom oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
- Cliquez sur "Modifier la stratégie". Remplacez le contenu du document de stratégie par ce fragment de code JSON :
table 0-row-1 html-authored no-header {
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
"SNS:Subscribe"
],
"Effet" : "Autoriser",
"Resource": [
"*"
]
}
]
}
- Cliquez sur Appliquer la stratégie.
Utilisation du service de messagerie Pushwoosh using-the-pushwoosh-messaging-service
Si vous ne souhaitez pas utiliser Pushwoosh, vous pouvez ignorer cette étape.
Pour utiliser Pushwoosh :
-
Inscrivez-vous auprès de Pushwoosh
- Accédez à pushwoosh.com et créez un compte.
-
Création d’un jeton d’accès API
- Sur le site Pushwoosh, accédez à l’option de menu Accès à l’API pour générer un jeton d’accès à l’API. Enregistrez ce jeton en toute sécurité.
-
Créer une application
- Pour la prise en charge d’Android™, vous devez fournir votre clé d’API GCM.
- Lors de la configuration de l’application, sélectionnez Cordova comme structure.
- Pour la prise en charge d’iOS, vous devez fournir le fichier de certificat (.cer), le certificat push (.p12) et le mot de passe de la clé privée. Ils doivent avoir été obtenus à partir du site APNS Apple. Pour Framework, sélectionnez Cordova.
- Pushwoosh génère un ID d’application pour cette application, sous la forme "XXXXX-XXXXX", où chaque X est une valeur hexadécimale (de 0 à F).
Étape 3 : Ajout de la prise en charge des notifications push à l’application step-add-push-support-to-the-app
Ajouter la configuration ContentSync add-contentsync-configuration
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://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html"
jcr:primaryType="nt:unstructured"
excludeProperties="[appAPIAcessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
Ajout de bibliothèques clientes add-client-libraries
Les bibliothèques clientes de notification push doivent être ajoutées à l’application en procédant comme suit :
En CRXDE Lite :
- Accédez à /etc/designs/phonegap/<nom de l’application>/clientlibsall.
- Double-cliquez sur la section incorporer dans le volet des propriétés.
- Dans la boîte de dialogue qui s’affiche, ajoutez une bibliothèque cliente en cliquant sur le bouton + .
- Dans le nouveau champ de texte, ajoutez "cq.mobile.push", puis cliquez sur OK.
- Ajoutez-en un autre appelé cq.mobile.push.amazon, puis cliquez sur OK.
- Enregistrez les modifications.
Étape 4 : Préparation d’un téléphone pour les tests step-prepare-a-phone-for-testing
IOS ios
Pour iOS, utilisez un ordinateur macOS et rejoignez 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 .
Android™ 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 du développeur sur l’appareil pour plus d’informations à ce sujet.
Étape 5 : configuration des notifications push sur les applications AEM step-configure-push-on-aem-apps
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.
- Créez les groupes d’autorisations appropriés pour les notifications push.
- Connectez-vous à AEM en tant qu’utilisateur approprié, cliquez sur l’onglet Applications .
- Cliquez sur l’application.
- Recherchez la mosaïque Gérer les Cloud Service et cliquez sur le crayon pour modifier vos configurations cloud.
- Sélectionnez Amazon SNS Connection, Pushwoosh Connection ou Adobe Mobile Services comme configuration de notification.
- Saisissez les propriétés du fournisseur et cliquez sur Envoyer pour les enregistrer, puis sur Terminé. Elles ne sont pas vérifiées à distance à ce stade, sauf s’il existe AMS.
- Vous devriez maintenant voir la configuration que vous venez de saisir dans la mosaïque Gérer les Cloud Service .
Étape 6 : création et déploiement de l’application step-build-and-deploy-the-app
Remarque : Voir les instructions ici sur la création d'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 va créer votre application pour vous sur leurs serveurs et vous permettre de la télécharger directement sur votre appareil. Pour découvrir comment configurer et utiliser le PhoneGap Build, consultez la documentation du PhoneGap Build à l’adresse
https://build.phonegap.com/
. -
L’interface de ligne de commande PhoneGap vous permet d’utiliser un large 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 (
https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
) pour savoir comment configurer et utiliser l’interface de ligne de commande PhoneGap.
Étape 7 : envoi d’une notification push step-send-a-push-notification
Pour créer une notification et l'envoyer, procédez comme suit.
-
Créer une notification
- Dans le tableau de bord de votre application AEM Mobile, recherchez la vignette Notifications push .
- Dans le menu en haut à droite, sélectionnez "Créer". Ce bouton n’est pas disponible tant que la configuration cloud n’a 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.
-
Envoyer la notification
- Dans le tableau de bord Applications, recherchez la vignette Notifications push .
- Sélectionnez la notification ou cliquez sur le bouton de 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 (uniquement) et cliquez sur le bouton "Envoyer la notification" au-dessus de la liste. Vous avez la possibilité d’annuler ou d’envoyer la notification dans la boîte de dialogue qui s’affiche.
-
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 Envoyer 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, l'état de cette notification est signalé comme Erreur, mais si le problème est corrigé, 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 :
- La création avec l’interface de ligne de commande démarre l’application après son déploiement sur Android™. Sur iOS, vous devez le démarrer manuellement. Comme l’étape d’enregistrement push se produit au démarrage, les applications Android™ peuvent recevoir immédiatement des notifications push (car elles ont déjà commencé et sont enregistrées), contrairement aux applications iOS.
- Sur Android™, le texte du bouton OK se trouve en majuscules (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 en AEM des notifications avec AWS et Pushwoosh.
Configuration de liens profonds avec des notifications push configuring-deep-linking-with-push-notifications
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 cela fonctionne-t-il ? L’auteur d’une notification push peut éventuellement ajouter une étiquette de bouton (c’est-à-dire "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 exclure le message.
Si l’application n’est pas ouverte, l’ombrage apparaît normalement. L’action sur la notification à l’ombre 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 :
-
Cliquez sur la modification dans le coin supérieur droit de la mosaïque Gérer les Cloud Service .
-
Sélectionnez la connexion Pushwoosh. Cliquez sur Suivant.
-
Saisissez les détails des propriétés et cliquez sur Submit.
Une fois la configuration envoyée, la mosaïque Notifications push s’affiche dans le tableau de bord.
Assistant de création de notification create-notification-wizard
Une fois que la mosaïque 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 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.
note note NOTE 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 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 de la mosaïque Notifications push .
Vous pouvez modifier les propriétés, envoyer des notifications ou supprimer la notification.
Les étapes suivantes the-next-steps
Une fois que vous avez compris les détails des notifications push pour votre application, voir AEM Mobile Content Personalization.