Créer et envoyer des messages in-app
Découvrez comment créer des messages in-app pour les applications mobiles avec Experience Platform Mobile SDK et Journey Optimizer.
Journey Optimizer vous permet de créer des campagnes pour envoyer des messages in-app à des audiences ciblées. Les campagnes dans Journey Optimizer sont utilisées pour diffuser du contenu unique à 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 la messagerie in-app dans Journey Optimizer, consultez documentation.
Conditions préalables
- Application créée et exécutée avec succès avec les SDK installés et configurés.
- Configurez l’application pour Adobe Experience Platform.
- Accès à Journey Optimizer et autorisations suffisantes pour les notifications push. Vous devez également disposer des autorisations suffisantes pour accéder aux fonctionnalités de Journey Optimizer ci-après.
- Gérer des campagnes.
- Périphérique ou simulateur iOS physique à des fins de test.
Objectifs d’apprentissage
Dans cette leçon, vous allez :
- Créez une configuration de canal dans Journey Optimizer.
- 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 expérience de campagne et de message in-app dans Journey Optimizer.
- Envoyez votre propre message in-app depuis l’application.
Configuration
Créer une configuration des canaux
Pour commencer, vous devez créer une configuration de canal afin de pouvoir envoyer des notifications de messages d’application depuis Journey Optimizer.
-
Dans l’interface de Journey Optimizer, ouvrez le menu Canaux > Paramètres généraux > Configurations de canal puis sélectionnez Créer une configuration de canal.
-
Saisissez un nom et une description (facultatif) pour la configuration. Par exemple,
LumaInAppMessaging
etChannel for in-app messaging
.note note NOTE Les noms doivent commencer par une lettre (A-Z). Ils ne peuvent contenir que des caractères alphanumériques. Vous pouvez également utiliser le trait de soulignement _
, le point.
et le trait d'union-
. -
Pour attribuer des libellés d’utilisation des données personnalisés ou de base à la configuration, vous pouvez sélectionner Gérer l’accès. En savoir plus sur le contrôle d’accès au niveau de l’objet (OLAC)
-
Sélectionnez le canal Messagerie in-app.
-
Sélectionnez Action(s) marketing pour associer des politiques de consentement aux messages à l’aide de cette configuration. Toutes les politiques de consentement associées à l’action marketing sont utilisées pour respecter les préférences de vos clients. En savoir plus sur les actions marketing. Par exemple : ciblage push.
-
Sélectionnez la Plateforme pour laquelle vous souhaitez définir les paramètres. Ce paramètre vous permet de spécifier l’application cible pour chaque plateforme et d’assurer la cohérence de la diffusion du contenu sur plusieurs plateformes.
note note NOTE Pour les plateformes iOS et Android, la diffusion se base uniquement sur l’ID d’application. Si les deux applications partagent le même ID d’application, le contenu est diffusé aux deux, quelle que soit la plateforme sélectionnée dans la configuration du canal. -
Saisissez les ID d’application de la plateforme que vous souhaitez prendre en charge.
-
Sélectionnez Envoyer pour enregistrer vos modifications.
Mettre à jour la configuration du flux de données
Pour vous assurer que les données envoyées de votre application mobile à Edge Network sont transférées vers Journey Optimizer, mettez à jour votre configuration Experience Edge.
-
Dans l’interface utilisateur de collecte de données, sélectionnez Flux de données, puis sélectionnez votre flux de données, par exemple Luma Mobile App.
-
Sélectionnez
-
Dans l’écran Flux de données >
-
Pour enregistrer la configuration de votre 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 votre propriété de balise.
- Accédez à Balises > Extensions > Catalogue.
- Ouvrez votre propriété, par exemple Luma Mobile App Tutorial.
- Sélectionnez Catalogue.
- Recherchez l’extension Adobe Journey Optimizer.
- Installez l’extension .
Lorsque vous uniquement utilisez des messages in-app dans votre application, dans Installer l’extension ou Configurer l’extension, vous n’avez rien à configurer. Si vous avez déjà suivi la leçon Notifications push dans le tutoriel, vous constatez que pour l’environnement Développement, le jeu de données Jeu de données d’événement d’expérience de suivi push AJO est sélectionné dans la liste Jeu de données d’événement.
Implémentation de Journey Optimizer dans l’application
Comme nous l’avons vu 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 Installation des SDK.
-
Dans Xcode, assurez-vous que AEP Messaging est ajouté à la liste des packages dans Dépendances de packages. Voir Gestionnaire de packages Swift.
-
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 d’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 ]
-
Dans Android Studio, assurez-vous que aepsdk-messaging-android fait partie des dépendances dans build.gradle.kts dans Android
-
Accédez à Android
-
Assurez-vous que
com.adobe.marketing.mobile.Messaging
fait partie de votre liste d’importations.import import com.adobe.marketing.mobile.Messaging
-
Assurez-vous que
Messaging.EXTENSION
fait partie du tableau d’extensions que vous enregistrez.code language-kotlin val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )
Validation de la configuration avec Assurance
-
Consultez la section instructions de configuration pour connecter votre simulateur ou votre appareil à Assurance.
-
Dans l’interface utilisateur d’Assurance, sélectionnez Configurer.
-
Sélectionnez le bouton
-
Sélectionnez Enregistrer.
-
Sélectionnez Messagerie In-App dans le volet de navigation de gauche.
-
Sélectionnez l’onglet Validation. Vérifiez 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 une campagne dans Journey Optimizer qui déclenche un message in-app en fonction des événements qui se produisent. Ces événements peuvent être les suivants :
- les 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 PII, par le biais des API génériques Mobile Core,
- événements du cycle de vie de l’application, tels que lancement, installation, mise à niveau, fermeture ou blocage
- les événements de géolocalisation, tels que 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 PII. Les événements générés par ces API sont publiés sur le hub d’événements SDK et peuvent être utilisés par les extensions. Le hub d’événements SDK fournit la structure de données de base liée à toutes les extensions de Mobile Platform SDK. Le hub d’événements conserve une liste des extensions enregistrées et des modules internes, une liste des é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 provenant d’extensions enregistrées afin de simplifier les intégrations aux solutions Adobe et tierces. Par exemple, lorsque l’extension Optimize est installée, le hub d’événements gère toutes les requêtes et interactions avec le moteur d’offres Journey Optimizer - Gestion des décisions .
-
Dans l’interface utilisateur de Journey Optimizer, sélectionnez Campagnes dans le rail de gauche.
-
Sélectionnez Créer une campagne.
-
Dans la boîte de dialogue Créer votre campagne, sélectionnez
-
Sur l’écran Campaign - AAAA-MM-JJ HHSS UTC+XX:XX:
-
Dans l’onglet Propriétés :
- Saisissez un nom pour la campagne. Par exemple,
Luma Mobile In-App Campaign
. - Vous pouvez éventuellement ajouter une description.
- Saisissez un nom pour la campagne. Par exemple,
-
Sélectionnez l’onglet Action.
-
Sous Afficher le message si, sélectionnez
-
Dans le menu déroulant Configuration du message in-app, sélectionnez votre configuration. Par exemple, LumaInAppMessaging.
-
Sélectionnez
-
Dans la boîte de dialogue Déclencheur de message in-app :
-
Sélectionnez Lancement de l’application et sélectionnez Action de suivi dans le menu déroulant.
-
Sélectionnez
-
Sélectionnez Action et égal dans les menus déroulants.
-
Saisissez
in-app
. -
Sélectionnez
-
Sélectionnez Données contextuelles dans le menu déroulant, puis saisissez
showMessage
. -
Sélectionnez égal dans le menu déroulant, puis saisissez
true
. -
Sélectionnez Terminé.
-
-
-
De retour dans l’écran principal de définition de la campagne, sélectionnez l’onglet Contenu.
-
Activez Formatage avancé.
-
Sélectionnez Modal comme Disposition des messages. Dans la boîte de dialogue Changer de disposition, sélectionnez Modifier la disposition.
-
Dans l’onglet Contenu.
- Saisissez
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
pour l’URL Media. - 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...
.
- Saisissez
-
Sélectionnez l’onglet Paramètres.
- Sélectionnez Personnaliser la taille dans Message.
- Désactivez Ajuster au contenu.
- Définissez Hauteur sur 75 %.
-
-
-
Sélectionnez Vérifier pour activer. Pour modifier éventuellement l’une des configurations pour Contenu, Propriétés, Actions ou plus, sélectionnez
-
Dans l’écran Vérifier pour activer (nom de la campagne) sélectionnez Activer.
-
Au bout d’un certain temps, votre nom de la campagne avec le statut Actif s’affiche dans la liste Campagnes.
Déclencher le message in-app
Tous les ingrédients sont en place pour envoyer un message in-app. Il 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"]) }
-
Accédez à Android
fun sendTrackAction(action: String, data: Map<String, String>?)
et ajoutez le code suivant, qui appelle la fonctionMobileCore.track
, en fonction des paramètresaction
etdata
.code language-kotlin // Send trackAction event MobileCore.track(action, data)
-
Accédez à Android
onInAppMessageClick
et ajoutez le code suivant :code language-kotlin // Setting parameters and calling function to send in-app message MobileSDK.shared.sendTrackAction( "in-app", mapOf("showMessage" to "true") )
Validation à l’aide de l’application
Vous pouvez valider les messages in-app depuis l’application elle-même.
-
Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, à l’aide de
-
Accédez à l’onglet Paramètres.
-
Appuyez Sur Message In-App. Le message in-app apparaît dans votre application.
-
Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir d’Android Studio, à l’aide de
-
Accédez à l’onglet Paramètres.
-
Appuyez Sur Message In-App. Le message in-app apparaît dans votre application.
Validation de la mise en œuvre 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 votre appareil à Assurance.
-
Sélectionnez Messagerie In-App.
-
Sélectionnez Liste des événements.
-
Sélectionnez une entrée Afficher le message.
-
Inspectez l’événement brut, en particulier le
html
, qui contient la disposition et le contenu complets du message in-app.
Étapes suivantes
Vous devriez maintenant disposer de tous les outils nécessaires pour commencer à ajouter des messages in-app, le cas échéant. Par exemple, la promotion de produits en fonction d’interactions spécifiques que vous suivez dans votre application .
Suivant : Création et affichage d'offres