Installation du SDK Mobile Adobe Experience Platform

Dans cette leçon, vous allez mettre en oeuvre le SDK Mobile avec les extensions et paramètres correspondant à l’environnement de développement de votre propriété de balise.

REMARQUE

Adobe Experience Platform Launch est intégré à Adobe Experience Platform comme une suite de technologies destinées à la collecte de données. Plusieurs modifications terminologiques ont été apportées à l’interface que vous devez connaître lors de l’utilisation de ce contenu :

  • Le platform launch (côté client) est désormais tags
  • platform launch côté serveur est désormais event forwarding
  • Les configurations Edge sont désormais datastreams

Objectifs d’apprentissage

À la fin de cette leçon, vous saurez comment :

  • Obtenez les instructions d’installation de la propriété de balise mobile.
  • différencier environnement de développement, d’évaluation et de production ;
  • créer et modifier le fichier de capsule ;
  • importer le SDK Mobile dans votre fichier AppDelegate ;
  • vérifier que le SDK a bien été mis en œuvre.

Obtention des instructions d’installation

Les instructions d’installation des propriétés de balise mobile sont une collection de fragments de code que vous exécutez dans votre terminal ou que vous ajoutez à des emplacements spécifiques dans votre application mobile.

Cliquez sur l’onglet Environments dans la barre de navigation supérieure pour accéder à la page des environnements. Notez que les environnements de développement, d’évaluation et de production ont déjà été créés pour vous. Ils correspondent aux environnements typiques du processus de développement et de mise à jour du code. Le code est d’abord écrit par un développeur dans un environnement de développement. Lorsqu’ils ont terminé leur travail, les développeurs envoient le code à un environnement d’évaluation où il est révisé par des équipes d’assurance qualité et d’autres équipes. Une fois que les équipes d’assurance qualité et les autres équipes sont satisfaites, le code est publié dans l’environnement de production, qui est l’environnement que voient les visiteurs lorsqu’ils téléchargent votre application.

Les balises permettent d’autres environnements de développement, ce qui s’avère utile pour les grandes entreprises où plusieurs développeurs travaillent simultanément sur différents projets.

Les environnements de développement, d’évaluation et de production sont les seuls environnements nécessaires pour compléter le tutoriel.

Clic sur Environnements dans la barre de navigation supérieure

Sur la ligne Développement, cliquez sur l’icône Installer icône Installer pour ouvrir le modal de code intégré.

Clic sur l’icône pour ouvrir le modal de code intégré

Passons en revue les instructions étape par étape.

Création du fichier de capsule et installation des capsules

Si vous avez déjà utilisé les propriétés de balise sur les sites web, l’une des premières choses que vous remarquerez est qu’il y a beaucoup plus d’informations dans ce modal que pour les propriétés web.

Le SDK Mobile Adobe pour iOS utilise les CocoaPods pour gérer les dépendances entre ses différents composants. Si vous n’avez pas encore installé CocoaPods dans votre environnement de développement, suivez les instructions d’installation de leur site web. En outre, si vous n’avez pas encore téléchargé l’application Bus Booking, enregistrez-la sur votre ordinateur en local et extrayez l’archive zip sur votre bureau.

Création du fichier de capsule

  1. Ouvrez l’application Terminal sur votre Mac®.

  2. Accédez au dossier du projet dans lequel vous avez enregistré l’application Bus Booking Swift (par ex. cd Desktop/busbooking-mobileapps-master/Swift/)

    Accès au répertoire du projet

  3. Dans l’interface de collecte de données, remplacez le système d’exploitation par iOS

  4. Copiez la première instruction iOS pod init, en cliquant sur l’icône Copier.

    Copie de la capsule init dans le presse-papiers dans l’interface de collecte de données

  5. Dans votre application Terminal, exécutez la commande pod init et attendez qu’elle soit terminée.

    Exécution de la capsule init

  6. Dans votre application Terminal, ouvrez le fichier de capsule à l’aide de la commande open podfile.

    Exécution d’un fichier de capsule ouvert

  7. Votre ordinateur peut ouvrir une boîte de dialogue vous demandant avec quelle application vous souhaitez ouvrir le fichier de capsule. Choisissez n’importe quel éditeur de texte, par exemple TextEdit.

  8. Dans l’interface Collecte de données, copiez la liste des dépendances en cliquant sur l’icône Copier . Vous observerez qu’il y a une ligne pour chacune des extensions que vous avez ajoutées dans la leçon précédente. Chaque extension possède son propre jeu de code qui repose sur l’extension Mobile Core et ne peut être ajouté ou supprimé qu’avec une mise à jour de l’application :

    Copie des dépendances dans le presse-papiers dans l’interface Collecte de données

  9. Dans l’éditeur de texte, collez les dépendances depuis le presse-papiers juste après la ligne # Pods for BusBookingSwift.

  10. Enregistrez les mises à jour dans le fichier de capsule dans votre éditeur de texte.

    Ajout de dépendances et enregistrement

  11. Vous pouvez désormais fermer votre éditeur de texte.

  12. Dans l’interface de collecte de données, copiez l’instruction iOS suivante pod repo update en cliquant sur l’icône Copier

    Copie de la mise à jour du référentiel de capsule

  13. Dans votre application Terminal, exécutez la commande pod repo update et attendez qu’elle soit terminée (cette opération peut durer plusieurs minutes).

    Exécution de la mise à jour du référentiel de capsule

  14. Dans l’interface de collecte de données, copiez l’instruction iOS suivante pod install en cliquant sur l’icône Copier

    Copie de l’installation de la capsule dans le presse-papiers dans l’interface de collecte de données

  15. Dans votre application Terminal, exécutez la commande pod install et attendez qu’elle soit terminée.

    Exécution de l’installation de la capsule

  16. Vous pouvez désormais fermer la fenêtre Terminal.

  17. Ouvrez une fenêtre Finder, accédez au dossier dans lequel vous avez enregistré l’application Bus Booking, puis vérifiez que le fichier BusBookingSwift.xcworkspace, le fichier Podfile.lock et le dossier Pods ont été créés.

    Confirmation des capsules dans l’outil de recherche

Mise à jour d’AppDelegate

Il est maintenant temps de mettre à jour l’application pour importer le SDK.

  1. Ouvrir le fichier BusBookingSwift.xcworkspace dans Xcode.

  2. Ouvrez le fichier AppDelegate.swift.

    Ouverture du fichier AppDelegate

  3. Dans l’interface Collecte de données, faites défiler l’écran jusqu’à la section Ajouter le code d’initialisation et sélectionnez Swift comme langage iOS que vous utilisez.

  4. Copiez les instructions d’importation en cliquant sur la première icône Copier de la section Ajouter un code d’initialisation :

    Copier les instructions d’importation Swift dans le presse-papiers

  5. Dans Xcode, collez ces instructions d’importation dans le fichier AppDelegate.swift après l’importation pour le UIKit.

    Coller les instructions d’importation Swift dans votre fichier AppDelegate

  6. Dans l’interface Collecte de données, copiez les deux lignes liées à l’extension Core en cliquant sur la seconde icône Copier dans la section Ajouter le code d’initialisation . La première ligne active les instructions de journalisation de la console (les options disponibles sont « debug », « verbose », « warning » et « error »). La deuxième ligne pointe vers l’identifiant unique de l’environnement de balises. Il est maintenant temps de mettre à jour l’application pour importer le SDK.

    Copie des instructions Core dans le presse-papiers

  7. Dans Xcode, collez les instructions Core suivantes dans le fichier AppDelegate au-dessus de la méthode application(_:didFinishLaunchingWithOptions:) :

    Collage des instructions Core dans le fichier AppDelegate

  8. Dans l’interface de collecte de données, copiez les instructions d’extension en cliquant sur la troisième icône Copier de la section Ajouter le code d’initialisation :

    Copie des instructions d’extension dans le presse-papiers

  9. Dans Xcode, collez ces instructions d’extension dans le fichier AppDelegate juste avant la ligne return true de la méthode application(_:didFinishLaunchingWithOptions:) :

    Collage des instructions d’extension dans le fichier AppDelegate

REMARQUE

Les instructions d’installation mobile fournies dans l’interface de collecte de données incluent les instructions d’importation et d’enregistrement pour les extensions d’identité, de cycle de vie et de signal, ainsi que l’initialisation des mesures de cycle de vie. Ces extensions sont considérées comme partie intégrante de l’extension Mobile Core. Si vous ne souhaitez pas utiliser ces extensions dans votre application, il est inutile d’importer, d’enregistrer ou de mettre en œuvre un autre code associé à ces extensions.

D’autres options de mise en œuvre doivent aussi être prises en compte lors de l’utilisation de ces extensions (par exemple, vous pouvez mettre en pause/redémarrer la collection du cycle de vie lorsque l’utilisateur met l’application en arrière-plan/au premier plan). Pour en savoir plus, consultez la documentation de l’extension Mobile Core.

Vérification de la mise en œuvre

  1. Enregistrez votre projet Xcode.

  2. Exécutez l’application et lancez-la dans le simulateur. Si aucun simulateur n’est configuré, configurez-en un maintenant, en veillant à configurer un appareil fonctionnant sous iOS 10+. Le simulateur de l’iPhone 8 fonctionne parfaitement, car il est facile de cliquer sur le bouton Home avec la souris.

    Exécution de l’application et son lancement dans l’émulateur

  3. Attendez que le simulateur se lance et ouvre complètement l’application sur l’écran de réservation (cette opération peut prendre quelques minutes).

    Attente de l’ouverture complète de l’application

  4. Confirmez que des appels sont envoyés aux serveurs Adobe dans la console Xcode.

    Recherche des appels dans la console

Voici quelques exemples d’appels spécifiques que vous pouvez rechercher :

  1. Appels pour récupérer la configuration des balises (filtrez votre console sur adobedtm.com). Notez les configurations d’extension que vous avez saisies dans la leçon précédente. Bien que l’ajout de l’extension nécessite une mise à jour de l’application, ces paramètres peuvent être gérés en externe dans des balises et modifiés à tout moment :

    2019-01-15 12:11:44.518220-0500 BusDemoSwift[52399:5056293] [AMSDK DEBUG <RulesDownloader>]: Successfully downloaded Rules from 'https://assets.adobedtm.com/launch-EN360aefc739b04410816f751a95861744-development-rules.zip'
    
    {"target.propertyToken":"","target.timeout":5,"global.privacy":"optedin","analytics.backdatePreviousSessionInfo":true,"analytics.offlineEnabled":true,"build.environment":"dev","rules.url":"https://assets.adobedtm.com/launch-EN360aefc739b04410816f751a95861744-development-rules.zip","target.clientCode":"techmarketingdemos","experienceCloud.org":"7ABB3E6A5A7491460A495D61@AdobeOrg","target.autoFetch":true,"target.fetchBackground":true,"lifecycle.sessionTimeout":300,"target.environmentId":"busbookingapp","analytics.server":"tmd.sc.omtrdc.net","analytics.rsids":"tmd-mobile-dev1","analytics.batchLimit":0,"property.id":"PRb4881271498b4f2cbaf67d38a8f3891a","global.ssl":true,"analytics.aamForwardingEnabled":true}
    
  2. Requête à Identity Service (filtrez votre console sur demdex.net) Dans cet exemple, l’ID (d_mid) a déjà été défini et est simplement de nouveau signalé.

    2019-01-15 12:11:45.164590-0500 BusDemoSwift[52399:5056322] [AMSDK DEBUG <com.adobe.module.identity>]:
    
    Sending request (https://dpm.demdex.net/id?d_rtbd=json&d_ver=2&d_orgid=7ABB3E6A5A7491460A495D61@AdobeOrg&d_mid=17179986463578698626041670574784107777&d_blob=j8Odv6LonN4r3an7LhD3WZrU1bUpAkFkkiY1ncBR96t2PTI&dcs_region=9)
    
  3. Réponse d’Identity Service (filtrez votre console sur ID Service). Notez comment la valeur mid correspond à la valeur d_mid dans la requête ci-dessus :

    2019-01-15 12:11:45.681821-0500 BusDemoSwift[52399:5056322] [AMSDK DEBUG <com.adobe.module.identity>]:
    
    ID Service - Got ID Response (mid: 17179986463578698626041670574784107777, blob: j8Odv6LonN4r3an7LhD3WZrU1bUpAkFkkiY1ncBR96t2PTI, hint: 9, ttl: "604800000 ms")
    
  4. Requête Analytics (filtrer votre console sur Analytics request)

    2019-01-15 12:11:45.828465-0500 BusDemoSwift[52399:5056336] [AMSDK DEBUG <AnalyticsHitDatabase>]: Analytics request was sent with body
    
    (ndh=1&c.&a.&AppID=BusDemoSwift%201%20%281.0%29&CarrierName=%28null%29&DayOfWeek=3&DaysSinceFirstUse=0&DaysSinceLastUse=0&DeviceName=x86_64&HourOfDay=12&LaunchEvent=LaunchEvent&Launches=3&OSVersion=iOS%2012.1&Resolution=828x1792&RunMode=Application&TimeSinceLaunch=0&ignoredSessionLength=-1547572244&internalaction=Lifecycle&locale=en-US&.a&.c&aamb=j8Odv6LonN4r3an7LhD3WZrU1bUpAkFkkiY1ncBR96t2PTI&aamlh=9&ce=UTF-8&cp=foreground&mid=17179986463578698626041670574784107777&pageName=BusDemoSwift%201%20%281.0%29&pe=lnk_o&pev2=ADBINTERNAL%3ALifecycle&t=00%2F00%2F0000%2000%3A00%3A00%200%20300&ts=1547572305)
    

Félicitations, vous avez ajouté le SDK à une application mobile !

Suite : « Ajout d’Adobe Experience Platform Identity Service » >

Sur cette page