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 Notifications push Journey Optimizer leçon), 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 la messagerie in-app dans Journey Optimizer, reportez-vous à la section 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 here. 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 la Interface de collecte de données, sélectionnez Surfaces de l’application 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
. -
De Configuration des applications mobiles, sélectionnez Apple iOS.
-
Saisissez l’ID du lot de l’application mobile dans la ID d’application (ID de bundle iOS) champ . 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 au réseau Edge 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électionner pour Experience Platform et sélectionnez Modifier dans le menu contextuel.
-
Dans le Datastreams > > Adobe Experience Platform écran, vérifiez Adobe Journey Optimizer est sélectionnée. 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électionner Catalogue.
- Recherchez le Adobe Journey Optimizer extension .
- Installez l’extension .
When only utilisation de messages in-app dans votre application, in Installer l’extension ou Configuration de l’extension, vous n’avez rien à configurer. Toutefois, si vous avez déjà suivi la méthode Notifications push dans le tutoriel, vous verrez cela pour le Développement l’environnement, Jeu de données d’événement de suivi push AJO le jeu de données est sélectionné dans la variable Jeu de données d’événement liste.
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, passez en revue la Installation des SDK .
-
Dans Xcode, assurez-vous que Messagerie AEP est ajouté à la liste des modules 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
-
Assurez-vous 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 le simulateur ou l’appareil à Assurance.
-
Dans l’interface utilisateur d’assurance, sélectionnez Configurer.
-
Sélectionnez la variable bouton en regard de Messagerie in-app.
-
Sélectionnez Enregistrer.
-
Sélectionner Messagerie in-app dans le volet de navigation de gauche.
-
Sélectionnez la variable 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 Core pour mobile) 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électionner Créer une campagne.
-
Dans le Créer une campagne écran :
-
Sélectionner Message in-app et sélectionnez une surface d’application dans la Surface de l’application liste, par exemple Luma Mobile App.
-
Sélectionner Créer
-
-
Dans l’écran de définition de campagne, à l’adresse Propriétés, saisissez une Nom pour la campagne, par exemple
Luma - In-App Messaging Campaign
, et a Description, par exempleIn-app messaging campaign for Luma app
.
-
Faites défiler jusqu’à Action, puis sélectionnez Modifier le contenu.
-
Dans le Message In-App écran :
-
Sélectionner Modal comme la propriété Disposition du message.
-
Entrée
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
pour le URL du média. -
Saisissez un En-tête, par exemple
Welcome to this Luma In-App Message
et saisissez un Corps, par exempleTriggered by pushing that button in the app...
. -
Entrée Ignorer comme la propriété Texte #1 bouton (principal).
-
Notez comment l’aperçu est mis à jour.
-
Sélectionner Réviser pour activer.
-
-
Dans le Réviser pour activer (Luma - Campagne de messagerie in-app) écran, sélectionnez dans le Planification mosaïque.
-
De retour dans le Luma - In-App Messaging Campaign écran, sélectionnez Modifier les déclencheurs.
-
Dans le Déclencheur de message in-app vous pouvez configurer 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 .
-
Utilisation Ajouter une condition pour créer à plusieurs reprises la logique suivante pour Afficher le message si.
-
Cliquez sur Terminé.
Vous avez défini une action de suivi, où la variable Action est égal à
in-app
et la variable Données contextuelles avec l’action est une paire valeur-clé de"showMessage" : "true"
. -
-
De retour dans le Luma - In-App Messaging Campaign écran, sélectionnez Réviser pour activer.
-
Dans le Réviser pour activer (Luma - Campagne de messagerie in-app) écran, sélectionnez Activer.
-
Vous voyez votre Luma - In-App Messaging Campaign avec état En direct dans le Campagnes liste.
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 le
func sendTrackAction(action: String, data: [String: Any]?)
et ajoutez le code suivant, qui appelle la fonctionMobileCore.track
fonction, 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 Xcode Project Navigator (Navigateur de projets 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 au Paramètres .
-
Appuyer Message In-App. Le message in-app apparaît dans votre application.
img-md w-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 le simulateur ou l’appareil à Assurance.
- Sélectionner Messagerie in-app.
- Sélectionner Liste des événements.
- Sélectionnez une Afficher le message entrée .
- Inspect de l’événement brut, en particulier le
html
, qui contient la mise en page 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