Collecte de données d’identité

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 leurs comportements en rapprochant des identités entre appareils et systèmes, ce qui vous permet de proposer des expériences numériques personnelles et percutantes en temps réel. Les champs d’identité et les espaces de noms sont la colle 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 les Extension Identity et la variable service d’identité dans la documentation.

Conditions préalables

  • Création et exécution de l’application 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é.
  • Mise à jour des identités.
  • Validez le graphique d’identités.
  • Obtenez l’ECID et d’autres identités.

Configuration d’un espace de noms d’identité personnalisé

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

NOTE
Le SDK Mobile génère une identité unique dans son propre espace de noms, appelé ID Experience Cloud (ECID) lorsque l’application est installée. Cet ECID est stocké en 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 lorsque l’utilisateur définit l’état de confidentialité global du SDK Mobile sur exclusion. Dans l’exemple d’application Luma, vous devez supprimer et réinstaller l’application pour créer un nouveau profil avec son propre ECID unique.

Pour créer un espace de noms d’identité, procédez comme suit :

  1. Dans l’interface Collecte de données, sélectionnez Identités à partir du rail de navigation de gauche.

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

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

  4. Sélectionner Identifiant multi-appareils.

  5. Sélectionnez Créer.

    créer un espace de noms d’identité

Mise à jour des identités

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

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

    code language-swift
    // 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 une IdentityMap .

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Configuration IdentityItem pour l’e-mail et l’identifiant CRM.

      code language-swift
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
      let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
      
    3. Ajoute ces IdentityItem aux objets IdentityMap .

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Envoie le IdentityItem dans le cadre de l’objet Identity.updateIdentities Appel API au réseau Edge.

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

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
Vous pouvez envoyer plusieurs identités en une seule updateIdentities appelez . Vous pouvez également modifier les identités envoyées précédemment.

Suppression d’une identité

Vous pouvez utiliser la variable Identity.removeIdentity API pour supprimer l’identité de la carte d’identité côté client stockée. L’extension Identity cesse d’envoyer l’identifiant au réseau Edge. L’utilisation de cette API ne supprime pas l’identifiant du graphique d’identités côté serveur. Voir Affichage des 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 au func removeIdentities(emailAddress: String, crmId: String) function:

    code language-swift
    // 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 = "112ca06ed53d3db37e4cea49cc45b71e"
    
  2. Accédez à Luma > Luma > Views > General > LoginSheet dans le navigateur de projet Xcode et recherchez le code à exécuter lors de la sélection de la variable Déconnexion bouton . Ajoutez le code suivant :

    code language-swift
    // Remove identities
    MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    

Validation avec Assurance

  1. Consultez la section instructions de configuration pour connecter le simulateur ou l’appareil à Assurance.

  2. Dans l’application Luma

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

    2. Sélectionnez la variable+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+en haut à droite.

      img-md
      w-300
    3. fournir une adresse électronique et un identifiant CRM ; ou

    4. Sélectionner+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+pour générer de manière aléatoire une Email et Identifiant CRM.

    5. Sélectionner Connexion.

      img-md
      w-300
  3. Recherchez dans l’interface web d’Assurance le Identités de mise à jour d’identité Edge de l’événement com.adobe.griffon.mobile fournisseur.

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

Validation avec le graphique d’identités

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

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

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

  3. Entrée Luma CRM ID comme la propriété Espace de noms d’identité et votre identifiant CRM (par exemple, 24e620e255734d8489820e74f357b5c8) en tant que Valeur d’identité.

  4. Vous voyez le Identités répertorié.

    validation du graphique d’identités

INFO
Il n’existe pas de code dans l’application pour réinitialiser l’ECID, ce qui signifie que vous pouvez uniquement réinitialiser l’ECID (et créer effectivement un profil avec un nouvel ECID) par le biais d’une désinstallation et d’une réinstallation de l’application. Pour mettre en oeuvre la réinitialisation des identifiants, voir la section Identity.resetIdentities et MobileCore.resetIdentities Appels API. Soyez toutefois prudent lors de l’utilisation d’un identifiant de notification push (voir Envoi de notifications push), cet identifiant devient un autre identifiant de profil "attractif" sur l’appareil.
SUCCESS
Vous avez maintenant configuré votre application pour mettre à jour les identités dans le réseau Edge et (lors de la configuration) avec Adobe Experience Platform.
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 : Collecte des données de profil

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