Configuration d’Assurance

Outre l’installation générale de SDK, iOS requiert également le code supplémentaire suivant pour démarrer la session Assurance de votre application.

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

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 démarre une session d’assurance lorsque l’application est en arrière-plan et ouverte à l’aide d’un lien profond.

Outre l’installation générale de SDK, Android requiert également le code supplémentaire suivant pour démarrer la session Assurance de votre application.

1. Dans Android Studio, dans la vue Android, accédez à app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication.

2. Ajoutez le code suivant à fun handleDeeplink(deeplink: String?) :

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   Ce code démarre une session d’assurance lorsque l’application est en arrière-plan et ouverte à l’aide d’un lien profond.

1. Ouvrez le projet dans Xcode.
2. Sélectionnez Luma dans l’explorateur de projets.
3. Sélectionnez la cible Luma.
4. Sélectionnez l’onglet Signature et fonctionnalités.
5. Définissez un Identifiant de lot.

Veillez à utiliser un identifiant de lot unique et à remplacer 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 de DNS inversé pour les chaînes d’ID de lot, telles que com.organization.brand.uniqueidentifier. La version terminée de ce tutoriel, par exemple, utilise com.adobe.luma.tutorial.swiftui.

{modal="regular"}

1. Ouvrez le projet dans Android Studio.
2. Sélectionnez build.gradle.kts (module :app) dans le navigateur.
3. Veillez à utiliser un identifiant de lot unique et à remplacer la valeur com.adobe.luma.tutorial.android pour namespace dans android
4. Veillez à utiliser le même identifiant de lot unique et à remplacer le com.adobe.luma.tutorial.android pour applicationId dans defaultConfig dans android

En règle générale, vous utilisez un format de DNS inversé pour les chaînes d’ID de lot, telles que com.organization.brand.uniqueidentifier. La version terminée de ce tutoriel, par exemple, utilise com.adobe.luma.tutorial.android.

{modal="regular"}

1. Accédez à votre projet dans Xcode.

2. Sélectionnez Luma dans l’explorateur de projets.

3. Sélectionnez la cible Luma.

4. Sélectionnez l’onglet Infos.

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

6. Définissez Identifiant sur l’identifiant de lot de votre choix et définissez un Schémas d’URL de votre choix .

   {modal="regular"}

Veillez à utiliser un identifiant de lot unique et à remplacer 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 de DNS inversé pour les chaînes d’ID de lot, telles que com.organization.brand.uniqueidentifier. Vous pouvez utiliser le même identifiant de lot que celui utilisé dans Définir l’identifiant du lot.
De même, utilisez un modèle d’URL unique et remplacez le lumatutorialswiftui 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 d’Apple.

Assurance fonctionne en ouvrant une URL, soit par le biais d’un navigateur, soit par le biais d’un 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. Dans l’exemple d’application, le lien profond est lumatutorialswiftui://.

1. Accédez à la vue Android de votre projet dans Android Studio.

2. Sélectionnez app > manifests > AndroidManifest.xml dans le navigateur.

3. Assurez-vous que l’élément XML manifest > application > activity ressemble à ce qui suit :

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Veillez à spécifier un android:scheme (par exemple, . lumatutorialandroid) et android:host (par exemple, default) pour définir l’URL de base.

Pour en savoir plus sur les liens profonds dans Android, voir Création de liens profonds vers le contenu de l’application.

Assurance fonctionne en ouvrant une URL, soit par le biais d’un navigateur, soit par le biais d’un 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. Dans l’exemple d’application, le lien profond est lumatutorialandroid://default.

Dans Xcode :

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

   Vous pouvez éventuellement nettoyer votre version, en particulier lorsque vous voyez des résultats inattendus. Sélectionnez Nettoyer le dossier de build… dans le menu Xcode Produit.

2. Dans la boîte de dialogue Autoriser l’application Luma à utiliser votre emplacement sélectionnez Autoriser lors de l’utilisation de l’application.

   {width="300"}

3. Dans la boîte de dialogue l’application Luma Souhaite vous envoyer des notifications sélectionnez Autoriser.

   {width="300"}

4. Sélectionnez Continuer… pour permettre à l’application de suivre votre activité.

   {width="300"}

5. Dans la boîte de dialogue Autoriser l’« application Luma » à suivre votre activité sur les applications et sites web d’autres sociétés sélectionnez Autoriser.

   {width="300"}

6. Sélectionnez Continuer.

Dans votre navigateur :

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

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

3. Sélectionnez Créer une session, puis l’option Connexion de lien profond.

4. Sélectionnez Démarrer.

5. Indiquez 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, suivis de :// Par exemple : lumatutorialswiftui://

6. Sélectionnez Suivant.
   {modal="regular"}

7. Dans la boîte de dialogue modale Créer une session :

   Si vous utilisez un appareil physique :

   • Sélectionnez Scanner le code QR. Pour ouvrir l’application, utilisez la caméra de votre appareil physique pour scanner le code QR et appuyez sur le lien.

     {modal="regular"}

   Si vous utilisez un simulateur :

   1. Sélectionnez Copier le lien.

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

      {modal="regular"}

8. Au chargement de l’application, une boîte de dialogue modale s’affiche, vous demandant de saisir le code confidentiel illustré à l’étape 7.

   {width="300"}

   Saisissez le code confidentiel et sélectionnez Connexion.

9. Si la connexion a réussi, vous voyez :

   • Une icône Assurance flottante au-dessus de votre application.

     {width="300"}

   • Mises à jour d’Experience Cloud arrivant dans l’interface utilisateur d’Assurance, affichant :

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

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

     3. Appareil et chronologie.

        {modal="regular"}

10. Sélectionnez Continuer pour accéder à l’écran d’accueil.

Dans Android Studio :

1. Créez ou recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir d’Android Studio, à l’aide de .

   Vous pouvez éventuellement nettoyer votre version, en particulier lorsque vous voyez des résultats inattendus. Sélectionnez Nettoyer le projet dans le menu Android Studio Créer.

2. Dans la boîte de dialogue Autoriser Luma Android à vous envoyer des notifications, sélectionnez Autoriser.

   {width="300"}

3. Sélectionnez Afficher la boîte de dialogue des autorisations.

   {width="300"}

4. Dans l’Autoriser Luma Android à accéder à l’emplacement de cet appareil ?…

   {width="300"}

   • Sélectionnez Précis.
   • Sélectionnez Lors de l’utilisation de l’application.

5. De retour dans l’écran d’introduction de l’application, sélectionnez Ouvrir les paramètres de l’appareil.

6. Dans l’écran Autorisation de l’emplacement, sélectionnez Autoriser tout le temps. Sélectionnez ensuite ← pour revenir à l’écran de l’application d’introduction.

   {width="300"}

7. Sélectionnez Continuer pour accéder à l’écran d’accueil.

Dans votre navigateur :

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

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

3. Sélectionnez Créer une session, puis l’option Connexion de lien profond.

4. Sélectionnez Démarrer.

5. Fournissez un Nom de session tel que Luma Mobile App Session et l’URL de base, qui correspond aux android:scheme et android:host que vous avez définis dans AndroidManifest.xml dans Android Studio, séparés par :// Par exemple : lumatutorialandroid://default.

6. Sélectionnez Suivant.
   {modal="regular"}

7. Dans la boîte de dialogue modale Créer une session :

   Si vous utilisez un appareil physique :

   • Sélectionnez Scanner le code QR. Pour ouvrir l’application, utilisez la caméra de votre appareil physique pour scanner le code QR et appuyez sur le lien.

     {modal="regular"}

   Si vous utilisez un simulateur :

   1. Sélectionnez Copier le lien.
   2. Copiez le lien profond à l’aide de et utilisez le lien profond pour ouvrir l’application avec Chrome dans le simulateur.

   {modal="regular"}

   Lorsque vous êtes invité dans Chrome à Continuer vers Luma Android, sélectionnez Continuer.

8. Au chargement de l’application, une boîte de dialogue modale s’affiche, vous demandant de saisir le code confidentiel illustré à l’étape 7.

   {width="300"}

   Saisissez le code confidentiel et sélectionnez Connexion.

9. Si la connexion a réussi, vous voyez :

   • Une icône Assurance flottante au-dessus de votre application.

     {width="300"}

   • Mises à jour d’Experience Cloud arrivant dans l’interface utilisateur d’Assurance, affichant :

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

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

     3. Appareil et chronologie.

        {modal="regular"}

{modal="regular"}

Pour mettre à jour les versions de vos extensions (par exemple, Messagerie et Optimiser), sélectionnez le package (extension) dans Dépendances de package (par exemple, AEPMessaging) et, dans le menu contextuel, sélectionnez Mettre à jour le package. Xcode met à jour les dépendances des packages.

{modal="regular"}

Si des extensions obsolètes s’affichent, consultez la documentation d’Android Studio sur la mise à jour des modules de dépendance de votre projet.