Créer et envoyer des messages in-app
Découvrez comment créer des messages in-app pour les applications mobiles avec le SDK Mobile Experience Platform et Journey Optimizer.
Journey Optimizer vous permet de créer des campagnes pour envoyer des messages in-app aux audiences ciblées. Les campagnes dans Journey Optimizer sont utilisées pour diffuser du contenu ponctuel vers une audience spécifique à l’aide de divers canaux. Avec les campagnes, les actions sont exécutées simultanément, immédiatement ou selon un planning spécifié. Lors de l’utilisation de parcours (voir la leçon Notifications push Journey Optimizer), les actions sont exécutées en séquence.
Avant d’envoyer des messages in-app avec Journey Optimizer, vous devez vous assurer que les configurations et intégrations appropriées sont en place. Pour comprendre le flux de données de messagerie in-app dans Journey Optimizer, reportez-vous à la documentation.
Conditions préalables
- Création et exécution de l’application avec les SDK installés et configurés.
- Configurez l’application pour Adobe Experience Platform.
- Accès à Journey Optimizer et autorisations suffisantes comme décrit ici. Vous avez également besoin d’une autorisation suffisante pour accéder aux fonctionnalités Journey Optimizer suivantes.
- Gérer les campagnes.
- Appareil ou simulateur iOS physique à tester.
Objectifs d'apprentissage
Dans cette leçon, vous allez
- Créez une surface d’application dans AJO.
- Installez et configurez l’extension de balise Journey Optimizer.
- Mettez à jour votre application pour enregistrer l’extension de balise Journey Optimizer.
- Validez la configuration dans Assurance.
- Définissez votre propre campagne et votre propre expérience de message in-app dans Journey Optimizer.
- Envoyez votre propre message in-app depuis l’application.
Configuration
Ajout d’une surface d’application dans la collecte de données
-
Dans l’ interface de collecte de données, sélectionnez App Surfaces dans le panneau de gauche.
-
Pour créer une configuration, sélectionnez Créer une surface d’application.
-
Saisissez un Nom pour la configuration, par exemple
Luma App Tutorial
. -
Dans Configuration d'application mobile, sélectionnez Apple iOS.
-
Saisissez l’ID du lot de l’application mobile dans le champ ID de l’application (ID du lot iOS) . Par exemple,
com.adobe.luma.tutorial.swiftui
. -
Sélectionnez Enregistrer.
Mise à jour de la configuration des flux de données
Pour vous assurer que les données envoyées de votre application mobile à l’Edge Network sont transférées vers Journey Optimizer, mettez à jour votre configuration Experience Edge.
-
Dans l’interface utilisateur de la collecte de données, sélectionnez Datastreams, puis sélectionnez votre flux de données, par exemple Luma Mobile App.
-
Sélectionnez pour Experience Platform et Modifier dans le menu contextuel.
-
Dans l’écran Datastreams > > Adobe Experience Platform, assurez-vous que Adobe Journey Optimizer est sélectionné. Voir Paramètres Adobe Experience Platform pour plus d’informations.
-
Pour enregistrer votre configuration de flux de données, sélectionnez Enregistrer.
Installation de l’extension de balises Journey Optimizer
Pour que votre application fonctionne avec Journey Optimizer, vous devez mettre à jour la propriété de balise.
- Accédez à Balises > Extensions > Catalogue.
- Ouvrez votre propriété, par exemple Luma Mobile App Tutorial.
- Sélectionnez Catalog.
- Recherchez l’extension Adobe Journey Optimizer.
- Installez l’extension .
Lorsque uniquement utilise des messages in-app dans votre application, dans Installer l’extension ou Configurer l’extension, vous n’avez rien à configurer. Cependant, si vous avez déjà suivi la leçon Notifications push du tutoriel, vous verrez que pour l’environnement de développement, le jeu de données Jeu de données d’expérience de suivi push AJO est sélectionné dans la liste Jeu de données d’événement.
Mise en oeuvre de Journey Optimizer dans l’application
Comme indiqué dans les leçons précédentes, l’installation d’une extension de balise mobile fournit uniquement la configuration. Vous devez ensuite installer et enregistrer le SDK de messagerie. Si ces étapes ne sont pas claires, consultez la section Installer les SDK .
-
Dans Xcode, assurez-vous que AEP Messaging est ajouté à la liste des packages dans les dépendances de modules. Voir Swift Package Manager.
-
Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.
-
Assurez-vous que
AEPMessaging
fait partie de votre liste d’importations.import AEPMessaging
-
Vérifiez que
Messaging.self
fait partie du tableau des extensions que vous enregistrez.code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
Validation de la configuration avec Assurance
-
Consultez la section instructions de configuration pour connecter votre simulateur ou périphérique à Assurance.
-
Dans l’interface utilisateur d’assurance, sélectionnez Configurer.
-
Sélectionnez le bouton en regard de la messagerie in-app.
-
Sélectionnez Enregistrer.
-
Sélectionnez Messagerie in-app dans le volet de navigation de gauche.
-
Sélectionnez l’onglet Validation . Confirmez que vous n’obtenez aucune erreur.
Créer votre propre message in-app
Pour créer votre propre message in-app, vous devez définir dans Journey Optimizer une campagne qui déclenche un message in-app en fonction des événements qui se produisent. Ces événements peuvent être :
- données envoyées à Adobe Experience Platform,
- les événements de suivi principaux, tels que l’action, l’état ou la collecte de données de PII, via les API génériques Mobile Core,
- les événements de cycle de vie des applications, tels que le lancement, l’installation, la mise à niveau, la fermeture ou le blocage,
- événements de géolocalisation, comme l’entrée ou la sortie d’un point ciblé.
Dans ce tutoriel, vous allez utiliser les API génériques Mobile Core et indépendantes de l’extension (voir API génériques Mobile Core) pour faciliter le suivi des événements des écrans utilisateur, des actions et des données de PII. Les événements générés par ces API sont publiés sur le centre d’événements du SDK et peuvent être utilisés par des extensions. Le hub d’événements SDK fournit la structure de données principale liée à toutes les extensions du SDK Mobile Platform, en conservant une liste d’extensions enregistrées et de modules internes, une liste d’écouteurs d’événements enregistrés et une base de données d’état partagée.
Le hub d’événements SDK publie et reçoit des données d’événement des extensions enregistrées afin de simplifier les intégrations avec les solutions d’Adobe et tierces. Par exemple, lorsque l’extension Optimize est installée, toutes les demandes et interactions avec le moteur d’offres Journey Optimizer - Gestion des décisions sont gérées par le hub d’événements.
-
Dans l’interface utilisateur de Journey Optimizer, sélectionnez Campagnes dans le rail de gauche.
-
Sélectionnez Créer une campagne.
-
Dans l'écran Créer une campagne :
-
Sélectionnez Message in-app et sélectionnez une surface d’application dans la liste surface d’application, par exemple Luma Mobile App.
-
Sélectionnez Créer
-
-
Dans l’écran de définition de campagne, à l’emplacement Propriétés, saisissez un Nom pour la campagne, par exemple
Luma - In-App Messaging Campaign
, et une Description, par exempleIn-app messaging campaign for Luma app
.
-
Faites défiler l’écran jusqu’à Action, puis sélectionnez Modifier le contenu.
-
Dans l’écran Message In-App :
-
Sélectionnez Modal comme Disposition du message.
-
Saisissez
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
pour l’ URL du média. -
Saisissez un En-tête, par exemple
Welcome to this Luma In-App Message
, puis un Corps, par exempleTriggered by pushing that button in the app...
. -
Saisissez Ignorer comme texte #1 bouton (principal).
-
Notez comment l’aperçu est mis à jour.
-
Sélectionnez Réviser pour activer.
-
-
Dans l’écran Réviser pour activer (Luma - Campagne de messagerie in-app), sélectionnez dans la mosaïque Planification.
-
De retour dans l'écran Luma - In-App Messaging Campaign, sélectionnez Edit Triggers.
-
Dans la boîte de dialogue Déclencheur de message in-app, vous configurez les détails de l’action de suivi qui déclenche le message in-app :
-
Pour supprimer événement de lancement d’application, sélectionnez .
-
Utilisez Add condition à plusieurs reprises pour créer la logique suivante pour Show message if.
-
Cliquez sur Terminé.
Vous avez défini une action de suivi, où Action est égal à
in-app
et où les données contextuelles avec l’action sont une paire de valeurs de clé"showMessage" : "true"
. -
-
De retour dans l’écran Luma - In-App Messaging Campaign, sélectionnez Réviser pour activer.
-
Dans l’écran Réviser pour activer (Luma - Campagne de messagerie in-app), sélectionnez Activer.
-
Votre Luma - In-App Messaging Campaign ayant le statut Live apparaît dans la liste Campagnes.
Déclencher le message in-app
Vous disposez de tous les ingrédients nécessaires pour envoyer un message in-app. Reste à savoir comment déclencher ce message in-app dans votre application.
-
Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode. Recherchez la fonction
func sendTrackAction(action: String, data: [String: Any]?)
et ajoutez le code suivant, qui appelle la fonctionMobileCore.track
, en fonction des paramètresaction
etdata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Accédez à Luma > Luma > Views > General > ConfigView dans le navigateur de projet Xcode. Recherchez le code du bouton Message in-app et ajoutez le code suivant :
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
Validation à l’aide de votre application
-
Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, en utilisant .
-
Accédez à l’onglet Paramètres .
-
Appuyez sur Message in-app. Le message in-app apparaît dans votre application.
{width="300"}
Validation de la mise en oeuvre dans Assurance
Vous pouvez valider vos messages in-app dans l’interface utilisateur d’assurance.
- Consultez la section instructions de configuration pour connecter votre simulateur ou périphérique à Assurance.
- Sélectionnez Messagerie In-App.
- Sélectionnez Event List.
- Sélectionnez une entrée Afficher le message.
- Inspect l’événement brut, en particulier
html
, qui contient la disposition et le contenu complets du message in-app.
Étapes suivantes
Vous devez maintenant disposer de tous les outils pour commencer à ajouter des messages in-app, le cas échéant et selon le cas. Par exemple, la promotion de produits en fonction d’interactions spécifiques dont vous effectuez le suivi dans votre application.
Suivant : Créer et afficher des offres