DocumentaciónExperience PlatformTutorial de aplicación móvil

Recopilación de datos de identidad

Última actualización: 5 de junio de 2025
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Obtenga información sobre cómo recopilar datos de identidad en una aplicación móvil.

El servicio de identidad de Adobe Experience Platform le ayuda a obtener una mejor vista de sus clientes y sus comportamientos al unir identidades entre dispositivos y sistemas, lo que le permite ofrecer experiencias digitales personales impactantes en tiempo real. Los campos de identidad y las áreas de nombres son el pegamento que une diferentes fuentes de datos para crear un perfil de cliente en tiempo real de 360 grados.

Obtenga más información acerca de la extensión de identidad y el servicio de identidad en la documentación.

Requisitos previos

  • La aplicación se ha creado y ejecutado correctamente con los SDK instalados y configurados.

Objetivos de aprendizaje

En esta lección, deberá hacer lo siguiente:

  • Configure un área de nombres de identidad personalizada.
  • Actualizar identidades.
  • Valide el gráfico de identidad.
  • Obtenga ECID y otras identidades.

Configurar un área de nombres de identidad personalizada

Las áreas de nombres de identidad son componentes de Identity Service que sirven como indicadores del contexto al que se relaciona una identidad. Por ejemplo, distinguen un valor de name@email.com como dirección de correo electrónico o 443522 como ID numérico de CRM.

NOTE
Mobile SDK genera una identidad única en su propia área de nombres, denominada Experience Cloud ID (ECID) cuando se instala la aplicación. Este ECID se almacena en la memoria persistente del dispositivo móvil y se envía con cada visita. El ECID se elimina cuando el usuario desinstala la aplicación o cuando establece el estado de privacidad global de Mobile SDK como de exclusión. En la aplicación de Luma de ejemplo, debe eliminar y reinstalar la aplicación para crear un nuevo perfil con su propio ECID único.

Para crear un área de nombres de identidad nueva:

  1. En la interfaz de recopilación de datos, seleccione Identidades en el carril izquierdo.

  2. Seleccione Crear espacio de nombres de identidad.

  3. Proporcione un nombre para mostrar de Luma CRM ID y un valor de símbolo de identidad de lumaCRMId.

  4. Seleccione ID entre dispositivos.

  5. Seleccione Crear.

    crear área de nombres de identidad

Actualización de identidades

Desea actualizar la identidad estándar (correo electrónico) y la identidad personalizada (ID de Luma CRM) cuando el usuario inicia sesión en la aplicación.

  1. Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode y busque la implementación de la función func updateIdentities(emailAddress: String, crmId: String). Agregue el siguiente código a la función.

    // 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)

    Este código:

    1. Crea un objeto IdentityMap vacío.

      let identityMap: IdentityMap = IdentityMap()

    2. Configura IdentityItem objetos para el correo electrónico y el ID de CRM.

      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)

    3. Agrega estos IdentityItem objetos al objeto IdentityMap.

      identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

    4. Envía el objeto IdentityItem como parte de la llamada de API Identity.updateIdentities a Edge Network.

      Identity.updateIdentities(with: identityMap)

  2. Vaya a Luma > Luma > Views > General > LoginSheet en el navegador del proyecto Xcode y busque el código que se ejecutará al seleccionar el botón Login. Añada el siguiente código:

    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
NOTE
Puede enviar varias identidades en una sola llamada a updateIdentities. También puede modificar las identidades enviadas anteriormente.

Eliminación de una identidad

Puede usar la API Identity.removeIdentity para quitar la identidad del mapa de identidad del lado del cliente almacenado. La extensión de identidad deja de enviar el identificador a Edge Network. El uso de esta API no elimina el identificador del gráfico de identidades del lado del servidor. Consulte Ver gráficos de identidad para obtener más información sobre los gráficos de identidad.

  1. Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode y agregue el siguiente código a la función 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. Vaya a Luma > Luma > Views > General > LoginSheet en el navegador del proyecto Xcode y busque el código que se ejecutará al seleccionar el botón Cerrar sesión. Añada el siguiente código:

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

Validar con Assurance

  1. Revise la sección instrucciones de configuración para conectar el simulador o dispositivo a Assurance.

  2. En la aplicación de Luma.

    1. Seleccione la ficha Página de inicio y mueva el icono Assurance a la izquierda.

    2. Seleccione el Icono de la parte superior derecha.

    3. Proporcione una dirección de correo electrónico y un ID de CRM, o

    4. Seleccionar para generar aleatoriamente un correo electrónico y ID de CRM.

    5. Seleccione Iniciar sesión.

  3. Busque en la interfaz web de Assurance el evento Edge Identity Update Identities del proveedor com.adobe.griffon.mobile.

  4. Seleccione el evento y revise los datos en el objeto ACPExtensionEventData. Debería ver las identidades que ha actualizado.
    validar actualización de identidades

Validar con gráfico de identidad

Una vez que complete los pasos de la lección de Experience Platform, podrá confirmar la captura de identidad en el visualizador de gráficos de identidades de Platform:

  1. Seleccione Identidades en la IU de recopilación de datos.

  2. Seleccione Gráfico de identidad en la barra superior.

  3. Escriba Luma CRM ID como área de nombres de identidad y su ID de CRM (por ejemplo 24e620e255734d8489820e74f357b5c8) como valor de identidad.

  4. Verá las Identidades en la lista.

    validar gráfico de identidad

INFO
No hay código en la aplicación para restablecer el ECID, lo que significa que solo puede restablecer el ECID (y crear de forma eficaz un nuevo perfil con un nuevo ECID) mediante una desinstalación y una reinstalación de la aplicación. Para implementar el restablecimiento de identificadores, consulte las llamadas a la API Identity.resetIdentities y MobileCore.resetIdentities. Sin embargo, tenga en cuenta que, al usar un identificador de notificación push (consulte Envío de notificaciones push), ese identificador se convierte en otro identificador de perfil "adhesivo" en el dispositivo.
SUCCESS
Ahora ha configurado la aplicación para actualizar identidades en Edge Network y (cuando está configurada) con Adobe Experience Platform.
Gracias por dedicar su tiempo a conocer Adobe Experience Platform Mobile SDK. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en esta publicación de debate de la comunidad de Experience League

Siguiente: Recopilar datos de perfil

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