Recopilación de datos de identidad

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 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 Servicio de identidad 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 desde el carril izquierdo.

  2. Seleccione Crear área de nombres de identidad.

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

  4. Seleccionar 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 variable func updateIdentities(emailAddress: String, crmId: String) implementación de funciones. 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 vacío IdentityMap objeto.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Configuración de IdentityItem objetos para correo electrónico e ID de CRM.

      code language-swift
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
      let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
      
    3. Añade estos IdentityItem objetos a la IdentityMap objeto.

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Envía el IdentityItem objeto como parte de Identity.updateIdentities Llamada de API a la red perimetral.

      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 Iniciar sesión botón. 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 updateIdentities llamada. También puede modificar las identidades enviadas anteriormente.

Eliminación de una identidad

Puede usar el complemento Identity.removeIdentity API para eliminar la identidad del mapa de identidad del lado del cliente almacenado. La extensión de identidad deja de enviar el identificador a la red perimetral. El uso de esta API no elimina el identificador del gráfico de identidades del lado del servidor. Consulte Visualización de 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 añada el siguiente código a func removeIdentities(emailAddress: String, crmId: String) función:

    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 Cerrar sesión botó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 instrucciones de configuración para conectar el simulador o dispositivo a Assurance.

  2. En la aplicación de Luma.

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

    2. Seleccione el {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 de forma aleatoria una Correo electrónico y ID de CRM.

    5. Seleccionar Iniciar sesión.

      {width="300"}

  3. Busque en la interfaz web de Assurance la variable Identidades de actualización de identidad de Edge evento de la com.adobe.griffon.mobile proveedor.

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

Validar con gráfico de identidad

Una vez completados los pasos en la lección de Experience Platform, puede confirmar la captura de identidad en el visualizador de gráficos de identidad de Platform:

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

  2. Seleccionar Gráfico de identidad desde la barra superior.

  3. Entrar Luma CRM ID como el Área de nombres de identidad y su ID de CRM (por ejemplo, 24e620e255734d8489820e74f357b5c8) como Valor de identidad.

  4. Verá el Identidades enumerados.

    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 la Identity.resetIdentities y MobileCore.resetIdentities Llamadas de API. Sin embargo, tenga en cuenta que cuando utilice un identificador de notificaciones 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 la red perimetral 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 este Entrada de discusión de la comunidad Experience League

Siguiente: Recopilación de datos de perfil

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