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.

Architecture

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.

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

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

TIP
Si vous avez déjà configuré votre environnement dans le cadre de la Messagerie push Journey Optimizer leçon : vous avez peut-être déjà effectué certaines des étapes de cette section de configuration.

Ajout d’une surface d’application dans la collecte de données

  1. Dans la Interface de collecte de données, sélectionnez Surfaces de l’application dans le panneau de gauche.

  2. Pour créer une configuration, sélectionnez Créer une surface d’application.
    page d’accueil de l’application

  3. Saisissez un Nom pour la configuration, par exemple Luma App Tutorial .

  4. De Configuration des applications mobiles, sélectionnez Apple iOS.

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

  6. Sélectionnez Enregistrer.

    configuration de la surface de l’application

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.

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

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

  3. Dans le Datastreams > Dossier > Adobe Experience Platform écran, vérifiez Adobe Journey Optimizer est sélectionnée. Voir Paramètres Adobe Experience Platform pour plus d’informations.

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

    Configuration des flux de données AEP

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.

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

NOTE
Si vous avez terminé la Installation des SDK , le SDK est déjà installé et vous pouvez ignorer cette étape.
  1. Dans Xcode, assurez-vous que Messagerie AEP est ajouté à la liste des modules dans les dépendances de modules. Voir Swift Package Manager.

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

  1. Consultez la section instructions de configuration pour connecter le simulateur ou l’appareil à Assurance.

  2. Dans l’interface utilisateur d’assurance, sélectionnez Configurer.
    configurer le clic

  3. Sélectionnez la variable Plus bouton en regard de Messagerie in-app.

  4. Sélectionnez Enregistrer.
    save

  5. Sélectionner Messagerie in-app dans le volet de navigation de gauche.

  6. Sélectionnez la variable Validation . Confirmez que vous n’obtenez aucune erreur.

    Validation In-App

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.

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

  2. Sélectionner Créer une campagne.

  3. Dans le Créer une campagne écran :

    1. Sélectionner Message in-app et sélectionnez une surface d’application dans la Surface de l’application liste, par exemple Luma Mobile App.

    2. Sélectionner Créer

      Propriétés de campagne

  4. 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 exemple In-app messaging campaign for Luma app.
    Nom de la campagne

  5. Faites défiler jusqu’à Action, puis sélectionnez Modifier le contenu.

  6. Dans le Message In-App écran :

    1. Sélectionner Modal comme la propriété Disposition du message.

    2. Entrée https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png pour le URL du média.

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

    4. Entrée Ignorer comme la propriété Texte #1 bouton (principal).

    5. Notez comment l’aperçu est mis à jour.

    6. Sélectionner Réviser pour activer.

      Editeur in-app

  7. Dans le Réviser pour activer (Luma - Campagne de messagerie in-app) écran, sélectionnez Modifier dans le Planification mosaïque.
    Planification de la révision : sélectionnez Planification

  8. De retour dans le Luma - In-App Messaging Campaign écran, sélectionnez Modifier Modifier les déclencheurs.

  9. 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 :

    1. Pour supprimer Événement de lancement d’application, sélectionnez Fermer .

    2. Utilisation Ajouter Ajouter une condition pour créer à plusieurs reprises la logique suivante pour Afficher le message si.

    3. Cliquez sur Terminé.

      Logique de déclenchement

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

  10. De retour dans le Luma - In-App Messaging Campaign écran, sélectionnez Réviser pour activer.

  11. Dans le Réviser pour activer (Luma - Campagne de messagerie in-app) écran, sélectionnez Activer.

  12. Vous voyez votre Luma - In-App Messaging Campaign avec état En direct dans le Campagnes liste.
    Liste des 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.

  1. 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 fonction MobileCore.track fonction, 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 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

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

  2. Accédez au Paramètres .

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

  1. Consultez la section instructions de configuration pour connecter le simulateur ou l’appareil à Assurance.
  2. Sélectionner Messagerie in-app.
  3. Sélectionner Liste des événements.
  4. Sélectionnez une Afficher le message entrée .
  5. Inspect de l’événement brut, en particulier le html, qui contient la mise en page et le contenu complets du message in-app.
    Assurance : 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.

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 le SDK mobile Experience Platform.
Merci d’investir votre temps à apprendre sur le SDK Adobe Experience Platform Mobile. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League.

Suivant : Créer et afficher des offres

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