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.

  1. Accédez à Luma > Luma > SceneDelegate dans le navigateur de projet de votre code.

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

  1. Ouvrez le projet dans Xcode.

  2. Sélectionner Luma dans le navigateur de projet.

  3. Sélectionnez la variable Luma cible.

  4. Sélectionnez la variable Signature et fonctionnalités .

  5. 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, comme com.organization.brand.uniqueidentifier. La version Terminée de ce tutoriel, par exemple, utilise com.adobe.luma.tutorial.swiftui.

    Fonctionnalités de signature Xcode {zoomable="yes"}

Configuration d’une URL de base

  1. Accédez à votre projet dans Xcode.

  2. Sélectionner Luma dans le navigateur de projet.

  3. Sélectionnez la variable Luma cible.

  4. Sélectionnez la variable Infos .

  5. Pour ajouter une URL de base, faites défiler l’écran jusqu’à Types d’URL et sélectionnez la variable + bouton .

  6. Définir Identifiant à l’identifiant du lot de votre choix et définissez une Modèles d’URL de votre choix .

    url dassurance

    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, comme com.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 le lumatutorialswiftui 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 :

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

    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 .
  2. 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
  3. Dans le "Luma App" souhaite vous envoyer des notifications boîte de dialogue, sélectionnez Autoriser.

    img-md
    w-300
  4. Sélectionner Continuer… pour permettre à l’application d’effectuer le suivi de votre activité.

    img-md
    w-300
  5. 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 :

  1. Accédez à l’interface utilisateur de la collecte de données.

  2. Sélectionner Assurance dans le rail de gauche.

  3. Sélectionner Créer une session.

  4. Sélectionner Début.

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

  6. Sélectionnez Suivant.
    création d’une session d’assurance

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

      code qa d’assurance

    Si vous utilisez un simulateur :

    1. Sélectionner Copier le lien.

    2. Copiez le lien profond à l’aide de Copier et utilisez le lien profond pour ouvrir l’application avec Safari dans le simulateur.

      Lien de copie d’assurance

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

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

      1. Événements d’expérience provenant de l’application.

      2. Détails d’un événement sélectionné.

      3. L’appareil et la chronologie.

        événements d’assurance

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 :

  1. Sélectionner Configurer.

  2. Sélectionner Ajouter pour 123 Versions d’extension.

  3. Sélectionnez Enregistrer.

    Configuration des versions d’extension

  4. Sélectionner 123 Versions d’extension pour afficher un aperçu des dernières extensions disponibles et des extensions utilisées dans votre version de l’application.

    Versions d’extension

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

NOTE
Une fois que vous avez mis à jour vos extensions (modules) dans Xcode, fermez et supprimez votre session actuelle, puis répétez toutes les étapes de Connexion à une session et Vérifier les extensions pour vous assurer qu’Assurance signale correctement les extensions correctes dans une nouvelle session d’assurance.
SUCCESS
Vous avez maintenant configuré votre application pour utiliser Assurance pour le reste du tutoriel.
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 : Mise en oeuvre du consentement

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