DocumentaciónExperience PlatformTutorial de aplicación móvil

Recopilación de datos de identidad

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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
El SDK de Mobile genera una identidad única en su propia área de nombres, denominada ID de Experience Cloud (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 del SDK móvil 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 área 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.

    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)

    Este código:

    1. Crea un objeto IdentityMap vacío.

      code language-swift 
      let identityMap: IdentityMap = IdentityMap()

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

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

    3. Agrega estos IdentityItem objetos al objeto IdentityMap.

      code language-swift 
      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 al Edge Network.

      code language-swift 
      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:

    code language-swift 
    // 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 al 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):

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

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

Validar con Assurance

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

  2. En la aplicación de Luma.

    1. Seleccione la ficha Inicio y mueva el icono de Assurance a la izquierda.

    2. Seleccione el Icono {width="15"} de la parte superior derecha.

      {width="300"}

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

    4. Seleccionar {width="15"} para generar aleatoriamente un correo electrónico y ID de CRM.

    5. Seleccione Iniciar sesión.

      {width="300"}

  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 para Experience Platform, podrá confirmar la captura de identidades 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 el Edge Network y (cuando está configurada) con Adobe Experience Platform.
Gracias por dedicar su tiempo a conocer el SDK móvil de Adobe Experience Platform. 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