Fermer

avril 21, 2025

Partie 1 – Marketing Cloud Personnalisation et applications mobiles: Fonctionnalité 101 / Blogs / Perficient

Partie 1 – Marketing Cloud Personnalisation et applications mobiles: Fonctionnalité 101 / Blogs / Perficient


Au cours des trois dernières années, en travaillant avec la personnalisation du cloud marketing (anciennement Interaction Studio), j’ai toujours été intrigué par l’icône mobile et ses capacités. Il y a quelques mois, j’ai décidé d’adopter une approche pratique en développant ma propre application pour explorer cette fonctionnalité de première main, testant sa mise en œuvre et la compréhension de son impact réel. Et que C’est ce que ce blog concerne.

Les étapes globales de l’intégration mobile de personnalisation du cloud marketing se déroule comme suit:

  1. Avoir une application 📲 (euphémisme)
  2. Avoir accès au projet APP et au code 💻.
  3. Intégrez la bibliothèque Evergage SDK à l’application ☁️.
  4. Créer une application mobile dans l’interface utilisateur de personnalisation 🧑🏽‍💻
  5. Créez une connexion entre l’application et l’ensemble de données de personnalisation 💻📲
  6. Suivez les vues et les actions de l’utilisateur dans l’application (implémentation du code) 📱➡️ 💻.
  7. Publier et suivre les actions de campagne et push notifications 💻➡️📱.

C’est tout… facile non ?. Dans ce blog, nous allons passer en revue la façon de faire la connexion entre MCP et l’application mobile et comment créer une première interaction (étapes 1 et partie de l’étape 6).

Pour cette démo, j’ai développé une application iOS en utilisant le langage de programmation Swift. Bien que je ne sois pas encore un expert, j’apprends régulièrement à naviguer sur Xcode et à implémenter les fonctionnalités en utilisant Swift. Ce projet a été une excellente occasion d’élargir mes compétences en développement iOS et de mieux comprendre les outils et les cadres disponibles dans l’écosystème d’Apple.

L’application iOS que je crée est très simple (pour l’instant), c’est juste une étiquette, un bouton et un champ de saisie. L’utilisateur tape quelque chose dans le champ de saisie, puis clique sur le bouton et les données sont envoyées à l’étiquette à afficher.

Vue de simulateur d'application iPhone 16

Nous devons donc ajouter le SDK Evergage dans le projet d’application. Téléchargez le SDK iOS Evergage (V1.4.1), décompressez-le et ouvrez le statique dossier. Là, le Evergage.xcframework est celui que nous allons utiliser. Lorsque vous avez le dossier prêt, vous devez copier le dossier dans votre application. Vous devriez avoir quelque chose comme ceci:

Dossier framework EvergageStructure du dossier MobileApp

Après avoir ajouté votre dossier, vous devez à nouveau créer votre application avec Commande + B.

Maintenant, nous devons valider le cadre est là, alors allez à Target -> Général -> Frameworks, bibliothèques et contenu intégré. Vous devriez voir quelque chose comme ça, et puisque j’utilise le dossier statique, le Ne pas intégrer est ok.

Informations générales dans Xcode

Valider le Chemin de recherche de cadre Contient un chemin où le cadre a été copié / installé. Cette étape serait probablement fait manuellement car parfois le chemin n’apparaît pas. Créez à nouveau l’application pour valider si aucune erreur n’apparaît.

Chemins de recherche de cadre

Pour valider cela fonctionne, accédez à la Appdelegate.swift et tapez Importage Evergagesi aucune erreur n’apparaît, vous êtes prêt à partir 🙂

Vue d'importation d'Evergage

Ensuite, nous devons créer le Application native À l’intérieur de l’ensemble de données de personnalisation de votre choix.

Hoover sur mobile et cliquez sur Ajouter une application native

Vue mobile MPC

Remplissez les informations du nom de l’application et de l’identification du bundle. Pour l’identifiant du bundle, allez à Target> Général> Identité

Ajouter l'application native

Vous allez avec quelque chose comme ceci:

Vue de MPC DemoApp

Dans appdelegate.swift, nous ferons l’équivalent pour ajouter la balise JavaScript sur la page.

  1. Tout d’abord, nous devons importer le Evergage Référence de classe. Cela permet le début du SDK iOS de personnalisation du cloud marketing. Nos interactions de suivi devraient maintenant être effectuées à l’intérieur d’un UIViewController classes héritées.
  2. Changer le didFinishLaunchingWithOptions à willFinishLaounchingWithOptions
  3. À l’intérieur application fonction Nous effectuons ce qui suit:
    1. Créez une instance singleton d’Evergage. UN Singleton est un modèle de conception de création qui vous permet de vous assurer qu’une classe n’a qu’une seule instance, tout en fournissant un point d’accès global à cette instance. Donc, avec cela, il fournit un point d’accès global à l’instance, qui peut être utilisé pour coordonner les actions sur notre application.
    2. Définissez l’ID utilisateur. Pour cela, nous avons réglé le evergage.userId en utilisant le evergage.anonymousId mais si nous avons déjà l’e-mail ou un identifiant pour l’utilisateur, nous devons passer immédiatement.
    3. Démarrez la configuration Evergage. Ici, nous passons l’ID de compte de la personnalisation et l’ID de jeu de données. Les autres valeurs définies sont les usePushNotifications et le useDesignMode . Le dernier nous aide à connecter la console Web de personnalisation pour l’écran de mappage d’action.
//Other imports
Import Evergage

@main
class AppDelegate: UIResponder, UIApplicationDelegate {



    func application(_ application: UIApplication, willFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool{
        
        //Create an singleton instance of Evergage
        let evergage = Evergage.sharedInstance()
        
        //Set User ID as anonymous
        evergage.userId = evergage.anonymousId
        
        //Start the Evergage Configuration with our Dataset information
        evergage.start { (clientConfigurationBuilder)   in
            clientConfigurationBuilder.account = "ACCOUNT_ID"
            clientConfigurationBuilder.dataset = "DATASET_ID"
            // if we want to user push notification campaings
            clientConfigurationBuilder.usePushNotifications = true
            //Allow user-initiated gesture to connect to the Personalization web console for action mapping screens.
            clientConfigurationBuilder.useDesignMode = true
        }
        
        
        
        // Override point for customization after application launch.
        return true
    }
}

Si nous lançons l’application en ce moment même, nous obtiendrons les suivants dans la personnalisation du cloud marketing suivant

Rapport d'événements Description de l'action d'interaction

C’est très bon et avec cela, nous sommes certains de travailler et d’envoyer les informations à la personnalisation du cloud marketing.

Actions de suivi

Ainsi, afin de suivre un écran, nous pouvons utiliser le evergageScreen . Nous utilisons cette propriété dans le cadre du EVGScreen et EVGContext Cours de suivi et de personnalisation. Cela est possible lorsque l’application utilise UIViewController pour chacun des écrans ou des pages que nous avons.

class ViewController: UIViewController {

        override func viewDidLoad() {
            super.viewDidLoad()
            // Do any additional setup after loading the view.
            trackScreen()
        }
        
        func trackScreen(){
            
            evergageScreen?.trackAction("Main Screen")
            
        }
}

Action d'interaction Forbutton

Si nous voulions suivre l’action de cliquer sur un bouton, nous pouvons faire quelque chose de similaire, par exemple ceci:

@IBAction func handleClick(_ sender: UIButton) {
        
        labelText.text = inputField.text
        evergageScreen?.trackAction("Button clicked")
        
    }

Dans ce code, chaque fois que l’utilisateur clique sur un bouton, le faire un clic La fonction déclenchera l’action. le inputfield.Text sera attribué au Étiqueter le texte. et le trackaction La fonction sera déclenchée et l’action sera envoyée à notre ensemble de données.

Cela conclut la première partie de ce tutoriel! Nous avons couvert la base de la façon d’ajouter le SDK de personnalisation dans une application iOS mobile, comment créer une application mobile dans la personnalisation et faire un suivi d’action très basique dans une vue. Dans Partie 2nous allons plonger dans le suivi des actions plus complexes comme les éléments de vue et la visualisation des détails de l’élément qui font partie des actions d’objet catalogue pour le suivi des éléments.






Source link