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.

Architecture {modal="regular"}

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.

NOTE
Cette leçon est facultative et s’applique uniquement aux utilisateurs de Journey Optimizer qui cherchent à envoyer des messages in-app.

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

TIP
Si vous avez déjà configuré votre environnement dans le cadre de la leçon Messagerie push Journey Optimizer, il se peut que vous ayez déjà effectué certaines des étapes de cette section de 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.

  1. 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.

  2. Saisissez un nom et une description (facultatif) pour la configuration. Par exemple, LumaInAppMessaging et Channel 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 -.
  3. 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)

  4. Sélectionnez le canal Messagerie in-app.

  5. 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.

  6. 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.
  7. Saisissez les ID d’application de la plateforme que vous souhaitez prendre en charge.

    Créer une configuration de canal {modal="regular"}

  8. 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.

  1. 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.

  2. Sélectionnez Plus pour Experience Platform et sélectionnez Modifier Modifier dans le menu contextuel.

  3. Dans l’écran Flux de données > Dossier > Adobe Experience Platform, assurez-vous que Adobe Journey Optimizer est sélectionné. Voir Paramètres Adobe Experience Platform pour plus d'informations.

  4. Pour enregistrer la configuration de votre flux de données, sélectionnez Enregistrer.

    configuration du train de données AEP {modal="regular"}

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.

  1. Accédez à Balises > Extensions > Catalogue.
  2. Ouvrez votre propriété, par exemple Luma Mobile App Tutorial.
  3. Sélectionnez Catalogue.
  4. Recherchez l’extension Adobe Journey Optimizer.
  5. 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.

NOTE
Si vous avez terminé la section Installation des SDK, le SDK est déjà installé et vous pouvez ignorer cette étape.
iOS
  1. Dans Xcode, assurez-vous que AEP Messaging est ajouté à la liste des packages dans Dépendances de packages. Voir Gestionnaire de packages Swift.

  2. Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

  3. Assurez-vous que AEPMessaging fait partie de votre liste d’importations.

    import AEPMessaging

  4. 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
    ]
    
Android
  1. Dans Android Studio, assurez-vous que aepsdk-messaging-android fait partie des dépendances dans build.gradle.kts dans Android ChevronDown > Scripts Gradle. Voir Gradle.

  2. Accédez à Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication dans le navigateur de projet Android Studio.

  3. Assurez-vous que com.adobe.marketing.mobile.Messaging fait partie de votre liste d’importations.

    import import com.adobe.marketing.mobile.Messaging

  4. 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

  1. Consultez la section instructions de configuration pour connecter votre simulateur ou votre appareil à Assurance.

  2. Dans l’interface utilisateur d’Assurance, sélectionnez Configurer.
    configurer le clic {modal="regular"}

  3. Sélectionnez le bouton Plus en regard de Messagerie In-App.

  4. Sélectionnez Enregistrer.
    enregistrer {modal="regular"}

  5. Sélectionnez Messagerie In-App dans le volet de navigation de gauche.

  6. Sélectionnez l’onglet Validation. Vérifiez que vous n’obtenez aucune erreur.

    Validation In-App {modal="regular"}

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 .

  1. Dans l’interface utilisateur de Journey Optimizer, sélectionnez Campagnes dans le rail de gauche.

  2. Sélectionnez Créer une campagne.

  3. Dans la boîte de dialogue Créer votre campagne, sélectionnez Horloge Planifié - Marketing et sélectionnez Confirmer.

  4. Sur l’écran Campaign - AAAA-MM-JJ HHSS UTC+XX:XX:

    1. Dans l’onglet Propriétés :

      1. Saisissez un nom pour la campagne. Par exemple, Luma Mobile In-App Campaign.
      2. Vous pouvez éventuellement ajouter une description.
    2. Sélectionnez l’onglet Action.

      1. Sous Afficher le message si, sélectionnez Ajouter Ajouter une action. Dans le menu déroulant, sélectionnez Message in-app.

      2. Dans le menu déroulant Configuration du message in-app, sélectionnez votre configuration. Par exemple, LumaInAppMessaging.

      3. Sélectionnez Modifier Modifier les déclencheurs.

      4. Dans la boîte de dialogue Déclencheur de message in-app :

        1. Sélectionnez Lancement de l’application et sélectionnez Action de suivi dans le menu déroulant.

        2. Sélectionnez AjouterCercle Ajouter une condition.

        3. Sélectionnez Action et égal dans les menus déroulants.

        4. Saisissez in-app.

        5. Sélectionnez AjouterCercle Ajouter une condition.

        6. Sélectionnez Données contextuelles dans le menu déroulant, puis saisissez showMessage.

        7. Sélectionnez égal dans le menu déroulant, puis saisissez true.

          Modifier les déclencheurs {modal="regular"}

        8. Sélectionnez Terminé.

    3. De retour dans l’écran principal de définition de la campagne, sélectionnez l’onglet Contenu.

      1. Activez Formatage avancé.

      2. Sélectionnez Modal comme Disposition des messages. Dans la boîte de dialogue Changer de disposition, sélectionnez Modifier la disposition.

      3. Dans l’onglet Contenu.

        1. Saisissez https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png pour l’URL Media.
        2. Saisissez un En-tête, par exemple Welcome to this Luma In-App Message et saisissez un Corps, par exemple Triggered by pushing that button in the app....

        Contenu du message in-app {modal="regular"}

      4. Sélectionnez l’onglet Paramètres.

        1. Sélectionnez Personnaliser la taille dans Message.
        2. Désactivez Ajuster au contenu.
        3. Définissez Hauteur sur 75 %.

        Paramètres des messages in-app {modal="regular"}

  5. Sélectionnez Vérifier pour activer. Pour modifier éventuellement l’une des configurations pour Contenu, Propriétés, Actions ou plus, sélectionnez Modifier .

  6. Dans l’écran Vérifier pour activer (nom de la campagne) sélectionnez Activer.

  7. Au bout d’un certain temps, votre nom de la campagne avec le statut Actif s’affiche dans la liste Campagnes.
    Liste des campagnes. {modal="regular"}

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.

iOS
  1. 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 fonction MobileCore.track, en fonction des paramètres action et data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. 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"])
    }
    
Android
  1. Accédez à Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK dans le navigateur d’Android Studio. Recherchez la fonction fun sendTrackAction(action: String, data: Map<String, String>?) et ajoutez le code suivant, qui appelle la fonction MobileCore.track, en fonction des paramètres action et data.

    code language-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Accédez à Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt dans le navigateur d’Android Studio. Recherchez le code du bouton du gestionnaire de 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.

iOS
  1. Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, à l’aide de Play .

  2. Accédez à l’onglet Paramètres.

  3. Appuyez Sur Message In-App. Le message in-app apparaît dans votre application.

    {width="300"}

Android
  1. Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir d’Android Studio, à l’aide de Play .

  2. Accédez à l’onglet Paramètres.

  3. Appuyez Sur Message In-App. Le message in-app apparaît dans votre application.

    {width="300"}

Validation de la mise en œuvre dans Assurance

Vous pouvez valider vos messages in-app dans l’interface utilisateur d’Assurance.

  1. Consultez la section instructions de configuration pour connecter votre simulateur ou votre appareil à Assurance.

  2. Sélectionnez Messagerie In-App.

  3. Sélectionnez Liste des événements.

  4. Sélectionnez une entrée Afficher le message.

  5. Inspectez l’événement brut, en particulier le html, qui contient la disposition et le contenu complets du message in-app.

    Message In-App Assurance {modal="regular"}

É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 .

SUCCESS
Vous avez activé l’application pour la messagerie in-app et ajouté une campagne de messagerie in-app à l’aide de Journey Optimizer et de l’extension Journey Optimizer pour Experience Platform Mobile SDK.
Merci d’avoir consacré votre temps à découvrir Adobe Experience Platform Mobile SDK. Si vous avez des questions, souhaitez partager des commentaires généraux ou des suggestions sur le contenu futur, partagez-les dans ce article de discussion de la communauté Experience League.

Suivant : Création et affichage d'offres

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b