Configuration d’Assurance
Découvrez comment configurer Adobe Experience Platform Assurance dans une application mobile.
L’assurance, officiellement appelée Projet Griffon, est conçue pour vous aider à inspecter, tester, simuler et valider la manière dont vous collectez des données ou diffusez des expériences dans votre application mobile.
Assurance vous aide à inspecter les événements SDK bruts générés par le SDK Mobile Adobe Experience Platform. Tous les événements collectés par le SDK sont disponibles pour inspection. Les événements du SDK sont chargés en mode Liste, triés par heure. Chaque événement dispose d’une vue détaillée qui fournit des détails supplémentaires. Des vues supplémentaires sur la configuration du SDK, les éléments de données, les états partagés et les versions de l’extension du SDK sont également fournies. Pour en savoir plus sur Assurance dans la documentation du produit.
Conditions préalables
- Configuration réussie de l’application avec les SDK installés et configurés.
Objectifs d'apprentissage
Dans cette leçon, vous allez :
- Vérifiez que votre entreprise a accès à (et demandez-le si vous ne le faites pas).
- Configurez votre URL de base.
- Ajoutez le code spécifique à iOS requis.
- Connectez-vous à une session.
Confirmer l’accès
Vérifiez que votre entreprise a accès à Assurance. En tant qu’utilisateur, vous devez être ajouté au profil pour Adobe Experience Platform. Pour plus d’informations, voir Accès des utilisateurs dans le guide d’assurance.
Implémenter
Outre l’ installation générale du SDK, que vous avez terminée dans la leçon précédente, iOS requiert également l’ajout suivant pour démarrer la session d’assurance pour votre application.
-
Accédez à Luma > Luma > SceneDelegate dans le navigateur de projet Xcode.
-
Ajoutez le code suivant à
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>
:code language-swift // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }
Ce code lance une session d’assurance lorsque l’application est en arrière-plan et ouverte à l’aide d’un lien profond.
Vous trouverez plus d'informations ici.
Définition de l’identifiant de lot
Vous devez fournir un identifiant de lot unique pour votre application.
-
Ouvrez le projet dans Xcode.
-
Sélectionnez Luma dans le navigateur de projet.
-
Sélectionnez la cible Luma.
-
Sélectionnez l’onglet Signing & Capabilities .
-
Définissez un identifiant de lot.
note important IMPORTANT Assurez-vous d’utiliser un identifiant de lot unique et remplacez l’identifiant de lot com.adobe.luma.tutorial.swiftui
, car chaque identifiant de lot doit être unique. En règle générale, vous utilisez un format DNS inversé pour les chaînes d’ID de lot, commecom.organization.brand.uniqueidentifier
. La version terminée de ce tutoriel, par exemple, utilisecom.adobe.luma.tutorial.swiftui
.
Configuration d’une URL de base
-
Accédez à votre projet dans Xcode.
-
Sélectionnez Luma dans le navigateur de projet.
-
Sélectionnez la cible Luma.
-
Sélectionnez l’onglet Info .
-
Pour ajouter une URL de base, faites défiler l’écran jusqu’à Types d’URL et sélectionnez le bouton + .
-
Définissez Identifiant sur l’identifiant de lot de votre choix et définissez un schéma d’URL de votre choix.
note important IMPORTANT Assurez-vous d’utiliser un identifiant de lot unique et remplacez l’identifiant de lot com.adobe.luma.tutorial.swiftui
, car chaque identifiant de lot doit être unique. En règle générale, vous utilisez un format DNS inversé pour les chaînes d’ID de lot, commecom.organization.brand.uniqueidentifier
. Vous pouvez utiliser le même identifiant de lot que celui utilisé à l’emplacement Définissez l’identifiant de lot.
De même, utilisez un modèle d’URL unique et remplacez lelumatutorialswiftui
déjà fourni par votre modèle d’URL unique.
Pour en savoir plus sur les schémas d’URL dans iOS, consultez la documentation Apple.
L’assurance fonctionne en ouvrant une URL, que ce soit par navigateur ou par code QR. Cette URL commence par l’URL de base qui ouvre l’application et contient des paramètres supplémentaires. Ces paramètres uniques sont utilisés pour connecter la session.
Connexion à une session
Dans Xcode :
-
Créez ou recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, en utilisant
note tip TIP Si vous le souhaitez, vous pouvez "nettoyer" votre version, en particulier lorsque des résultats inattendus s’affichent. Pour ce faire, sélectionnez Nettoyer le dossier de génération… dans le menu Xcode Product . -
Dans la boîte de dialogue Autoriser "Luma App" à utiliser votre emplacement, sélectionnez Autoriser lors de l’utilisation de l’application.
-
Dans la boîte de dialogue "Luma App" Vouloir vous envoyer des notifications, sélectionnez Autoriser.
-
Sélectionnez Continuer… pour permettre à l’application de suivre votre activité.
-
Dans la boîte de dialogue Autoriser "l’application Luma" à suivre votre activité sur les applications et sites web d’autres entreprises, sélectionnez Autoriser.
Dans votre navigateur :
-
Accédez à l’interface utilisateur de la collecte de données.
-
Sélectionnez Assurance dans le rail de gauche.
-
Sélectionnez Créer une session.
-
Sélectionnez Démarrer.
-
Fournissez un nom de session tel que
Luma Mobile App Session
et l’ URL de base, qui correspond aux schémas d’URL que vous avez saisis dans Xcode, suivi de://
Par exemple :lumatutorialswiftui://
-
Sélectionnez Suivant.
-
Dans la boîte de dialogue modale Créer une session :
Si vous utilisez un appareil physique :
-
Sélectionnez Analyser le code QR. Pour ouvrir l’application, utilisez l’appareil photo de votre appareil physique pour analyser le code QR et appuyez sur le lien.
Si vous utilisez un simulateur :
-
Sélectionnez Copier le lien.
-
Copiez le lien profond à l’aide de
-
-
Au chargement de l’application, une boîte de dialogue modale vous demande de saisir le code PIN affiché à l’étape 7.
Saisissez le code PIN et sélectionnez Se connecter.
-
Si la connexion a réussi, vous voyez :
-
Une icône Assurance qui flotte au-dessus de votre application.
-
Mises à jour Experience Cloud effectuées dans l’interface utilisateur d’Assurance, indiquant :
-
Événements d’expérience provenant de l’application.
-
Détails d’un événement sélectionné.
-
L’appareil et la chronologie.
-
-
Si vous rencontrez des problèmes, consultez la documentation technique et la documentation générale.
Vérifier les extensions
Pour vérifier si votre application utilise les extensions les plus récentes :
-
Sélectionnez Configurer.
-
Sélectionnez
-
Sélectionnez Enregistrer.
-
Sélectionnez
-
Pour mettre à jour vos versions d’extension (par exemple, Messaging et Optimize), sélectionnez le module (extension) dans Package Dependencies (par exemple, AEPMessaging) et dans le menu contextuel, sélectionnez Update Package. Xcode met à jour les dépendances du package.
Suivant : Implémentation du consentement