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. En savoir plus sur les 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. Voir Accès utilisateur pour plus d’informations.
Implémenter
En plus du Installation du SDK, que vous avez terminé 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 de votre code.
-
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.
Plus d’informations sont disponibles here.
Définition de l’identifiant de lot
Vous devez fournir un identifiant de lot unique pour votre application.
-
Ouvrez le projet dans Xcode.
-
Sélectionner Luma dans le navigateur de projet.
-
Sélectionnez la variable Luma cible.
-
Sélectionnez la variable Signature et fonctionnalités .
-
Définition d’une Identifiant du lot.
note important IMPORTANT Assurez-vous d’utiliser une unique identifiant de lot et remplacez la variable com.adobe.luma.tutorial.swiftui
identifiant de lot, 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
.{zoomable="yes"}
Configuration d’une URL de base
-
Accédez à votre projet dans Xcode.
-
Sélectionner Luma dans le navigateur de projet.
-
Sélectionnez la variable Luma cible.
-
Sélectionnez la variable Infos .
-
Pour ajouter une URL de base, faites défiler l’écran jusqu’à Types d’URL et sélectionnez la variable + bouton .
-
Définir Identifiant à l’identifiant du lot de votre choix et définissez une Modèles d’URL de votre choix .
note important IMPORTANT Assurez-vous d’utiliser une unique identifiant de lot et remplacez la variable com.adobe.luma.tutorial.swiftui
identifiant de lot, 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é dans Définition de l’identifiant de lot.
De même, utilisez un modèle d’URL unique et remplacez lelumatutorialswiftui
avec votre modèle d’URL unique.
Pour en savoir plus sur les schémas d’URL dans iOS, consultez 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… de Xcode Produit . -
Dans le Autoriser "Luma App" à utiliser votre emplacement boîte de dialogue, sélectionnez Autoriser lors de l’utilisation de l’application.
img-md w-300 -
Dans le "Luma App" souhaite vous envoyer des notifications boîte de dialogue, sélectionnez Autoriser.
img-md w-300 -
Sélectionner Continuer… pour permettre à l’application d’effectuer le suivi de votre activité.
img-md w-300 -
Dans le Autoriser "l’application Luma" à effectuer le suivi de votre activité sur les applications et sites web d’autres entreprises boîte de dialogue, sélectionnez Autoriser.
img-md w-300
Dans votre navigateur :
-
Accédez à l’interface utilisateur de la collecte de données.
-
Sélectionner Assurance dans le rail de gauche.
-
Sélectionner Créer une session.
-
Sélectionner Début.
-
Fournissez une Nom de session par exemple
Luma Mobile App Session
et la variable URL de base, qui est un schéma d’URL que vous avez saisi dans Xcode, suivi de://
Par exemple :lumatutorialswiftui://
-
Sélectionnez Suivant.
-
Dans le Créer une session boîte de dialogue modale :
Si vous utilisez un appareil physique :
-
Sélectionner 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électionner Copier le lien.
-
Copiez le lien profond à l’aide de et utilisez le lien profond pour ouvrir l’application avec Safari dans le simulateur.
-
-
Au chargement de l’application, une boîte de dialogue modale vous demande de saisir le code PIN affiché à l’étape 7.
img-md w-300 Saisissez le code PIN et sélectionnez Connexion.
-
Si la connexion a réussi, vous voyez :
-
Une icône Assurance qui flotte au-dessus de votre application.
img-md w-300 -
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, passez en revue la variable technique and general documentation.
Vérifier les extensions
Pour vérifier si votre application utilise les extensions les plus récentes :
-
Sélectionner Configurer.
-
Sélectionner pour Versions d’extension.
-
Sélectionnez Enregistrer.
-
Sélectionner Versions d’extension pour afficher un aperçu des dernières extensions disponibles et des extensions utilisées dans votre version de l’application.
-
Pour mettre à jour vos versions d’extension (par exemple, Messagerie et Optimiser) sélectionnez le module (extension) depuis Dépendances de modules (par exemple, AEPMessaging) et, dans le menu contextuel, sélectionnez Mettre à jour le package. Xcode met à jour les dépendances du package.
Suivant : Mise en oeuvre du consentement