DocumentationExperience PlatformTutoriel sur les applications mobiles

Collecter des données d’identité

Dernière mise à jour : 5 juin 2025
  • Rubriques :

Créé pour :

  • Débutant
  • Intermédiaire
  • Développeur

Découvrez comment collecter des données d’identité dans une application mobile.

Adobe Experience Platform Identity Service vous permet de mieux connaître vos clients et clientes ainsi que leurs comportements, en établissant un lien entre les identités des différents appareils et systèmes, ce qui vous permet de proposer des expériences digitales personnelles et percutantes en temps réel. Les champs d’identité et les espaces de noms sont le ciment qui relie différentes sources de données pour créer le profil client en temps réel à 360 degrés.

En savoir plus sur l’extension d’identité et le service d’identités dans la documentation.

Conditions préalables

  • Application créée et exécutée avec succès avec les SDK installés et configurés.

Objectifs d’apprentissage

Dans cette leçon, vous allez :

  • Configurez un espace de noms d’identité personnalisé.
  • Mettre à jour les identités.
  • Validez le graphique d’identité.
  • Obtenez l’ECID et d’autres identités.

Configurer un espace de noms d’identité personnalisé

Les espaces de noms d’identité sont des composants du Service d’identités qui servent d’indicateurs du contexte auquel une identité se rapporte. Par exemple, ils distinguent une valeur name@email.com comme adresse e-mail ou 443522 comme identifiant CRM numérique.

NOTE
Mobile SDK génère une identité unique dans son propre espace de noms, appelée Experience Cloud ID (ECID) lors de l’installation de l’application. Cet ECID est stocké dans la mémoire persistante sur l’appareil mobile et est envoyé avec chaque accès. L’ECID est supprimé lorsque l’utilisateur désinstalle l’application ou définit le statut de confidentialité global de Mobile SDK sur Désinscription. Dans l’exemple d’application Luma, vous devez supprimer et réinstaller l’application pour créer un profil avec son propre ECID unique.

Pour créer un espace de noms d’identité :

  1. Dans l’interface de collecte de données, sélectionnez Identités dans le volet de navigation du rail de gauche.

  2. Sélectionnez Créer un espace de noms d’identité.

  3. Fournissez une valeur Nom d’affichage de Luma CRM ID et une valeur Symbole d’identité de lumaCRMId.

  4. Sélectionnez Identifiant sur l’ensemble des appareils.

  5. Sélectionnez Créer.

    créer un espace de noms d’identité

Mise à jour d’identités

Vous souhaitez mettre à jour l’identité standard (e-mail) et l’identité personnalisée (identifiant CRM de Luma) lorsque l’utilisateur se connecte à l’application.

  1. Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode et recherchez l’implémentation de la fonction func updateIdentities(emailAddress: String, crmId: String). Ajoutez le code suivant à la fonction .

    // Set up identity map, add identities to map and update identities
    let identityMap: IdentityMap = IdentityMap()
    
    let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
    let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
    identityMap.add(item:emailIdentity, withNamespace: "Email")
    identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
    
    Identity.updateIdentities(with: identityMap)
    

    Ce code :

    1. Crée un objet IdentityMap vide.

      let identityMap: IdentityMap = IdentityMap()
      
    2. Configure les objets IdentityItem pour l’e-mail et l’identifiant CRM.

      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
      let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
      
    3. Ajoute ces objets IdentityItem à l’objet IdentityMap.

      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Envoie l’objet IdentityItem dans le cadre de l’appel API Identity.updateIdentities à Edge Network.

      Identity.updateIdentities(with: identityMap)
      
  2. Accédez à Luma > Luma > Views > General > Feuille de connexion dans le navigateur du projet Xcode et recherchez le code à exécuter lors de la sélection du bouton Connexion. Ajoutez le code suivant :

    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
Vous pouvez envoyer plusieurs identités dans un seul appel updateIdentities. Vous pouvez également modifier les identités précédemment envoyées.

Supprimer une identité

Vous pouvez utiliser l’API Identity.removeIdentity pour supprimer l’identité du mappage d’identités côté client stocké. L’extension d’identité cesse d’envoyer l’identifiant à Edge Network. L’utilisation de cette API ne supprime pas l’identifiant du graphique d’identités côté serveur. Voir Afficher les graphiques d’identités pour plus d’informations sur les graphiques d’identités.

  1. Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode et ajoutez le code suivant à la fonction func removeIdentities(emailAddress: String, crmId: String) :

    // Remove identities and reset email and CRM Id to their defaults
    Identity.removeIdentity(item: IdentityItem(id: emailAddress), withNamespace: "Email")
    Identity.removeIdentity(item: IdentityItem(id: crmId), withNamespace: "lumaCRMId")
    currentEmailId = "testUser@gmail.com"
    currentCRMId = "b642b4217b34b1e8d3bd915fc65c4452"
    
  2. Accédez à Luma > Luma > Views > General > Feuille de connexion dans le navigateur du projet Xcode et recherchez le code à exécuter lors de la sélection du bouton Déconnexion. Ajoutez le code suivant :

    // Remove identities
    MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    

Valider avec Assurance

  1. Consultez la section instructions de configuration pour connecter votre simulateur ou votre appareil à Assurance.

  2. Dans l’application Luma

    1. Sélectionnez l’onglet Accueil et déplacez l’icône Assurance vers la gauche.

    2. Sélectionner le en haut à droite.

    3. Indiquez une adresse e-mail et un identifiant CRM, ou

    4. Sélectionner de générer de manière aléatoire un e-mail et un identifiant CRM.

    5. Sélectionnez Connexion.

  3. Recherchez dans l’interface web d’Assurance l’événement Identités de mise à jour d’identité Edge du fournisseur com.adobe.griffon.mobile.

  4. Sélectionnez l’événement et passez en revue les données de l’objet ACPExtensionEventData. Vous devriez voir les identités que vous avez mises à jour.
    validation de la mise à jour des identités

Validation avec un graphique d’identités

Une fois que vous avez suivi les étapes de la leçon Experience Platform, vous pouvez confirmer la capture d’identité dans la visionneuse de graphiques d’identités Platform :

  1. Sélectionnez Identités dans l’interface utilisateur de la collecte de données.

  2. Sélectionnez Graphique d’identités dans la barre supérieure.

  3. Saisissez Luma CRM ID comme Espace de noms d’identité et votre ID CRM (par exemple 24e620e255734d8489820e74f357b5c8) comme Valeur d’identité.

  4. Les identités sont répertoriées.

    valider le graphique d’identité

INFO
Il n’existe aucun code dans l’application pour réinitialiser l’ECID, ce qui signifie que vous ne pouvez réinitialiser l’ECID (et créer efficacement un profil avec un nouvel ECID) que par le biais d’une désinstallation et d’une réinstallation de l’application. Pour implémenter la réinitialisation des identifiants, voir les appels API Identity.resetIdentities et MobileCore.resetIdentities. Gardez cependant à l'esprit que, lors de l'utilisation d'un identifiant de notification push (voir Envoi de notifications push), cet identifiant devient un autre identifiant de profil « pense-bête » sur l'appareil.
SUCCESS
Vous avez maintenant configuré votre application pour mettre à jour les identités dans Edge Network et (lorsqu’elle est configurée) avec Adobe Experience Platform.
Merci d’avoir consacré votre temps à découvrir Adobe Experience Platform Mobile SDK. Si vous avez des questions, souhaitez partager des commentaires généraux ou des suggestions sur le contenu futur, partagez-les dans ce article de discussion de la communauté Experience League

Suivant : Collecter des données de profil

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