Guía de solución de problemas del servicio de identidad

Este documento proporciona respuestas a las preguntas más frecuentes acerca de Adobe Experience Platform Identity Service, así como una guía de solución de problemas para errores comunes. Si tiene alguna pregunta o solución de problemas relacionados con las API de Platform en general, consulte la Guía de solución de problemas de la API de Adobe Experience Platform.

Los datos que identifican a un único cliente suelen estar fragmentados entre los distintos dispositivos y sistemas que utilizan para interactuar con su marca. Identity Service recopila estas identidades fragmentadas, lo que facilita una comprensión completa del comportamiento de los clientes para que pueda ofrecer experiencias digitales impactantes en tiempo real. Para obtener más información, consulte Introducción al servicio de identidad.

Preguntas frecuentes

A continuación se muestra una lista de respuestas a las preguntas más frecuentes acerca de Identity Service.

¿Qué son los datos de identidad?

Los datos de identidad son cualquier dato que pueda utilizarse para identificar a una persona individual. Según el contexto de uso de los datos en su organización, los datos de identidad pueden incluir nombres de usuario, direcciones de correo electrónico e ID de sistemas CRM. Los datos de identidad no se limitan a los usuarios registrados de su sitio web o servicio, ya que los usuarios anónimos también pueden identificarse por su ID de dispositivo o cookie.

¿Cuál es la ventaja de etiquetar campos de datos como identidades?

El etiquetado de determinados campos de datos como identidades en los datos de registros y series temporales le permite asignar relaciones de identidad dentro de la estructura natural de los datos y reconciliar los datos duplicados entre canales. Consulte la descripción general del servicio de identidad para obtener más información.

¿Qué son las identidades conocidas y anónimas?

Una identidad conocida hace referencia a un valor de identidad que puede utilizarse, tanto por sí solo como con otra información, para identificar, contactar o localizar a una persona individual. Algunos ejemplos de identidades conocidas son direcciones de correo electrónico, números de teléfono e ID de CRM.

Una identidad anónima hace referencia a un valor de identidad que no se puede utilizar, ni por sí solo ni con otra información, para identificar, contactar o localizar a una persona individual (como un ID de cookie).

¿Qué es un gráfico de identidad privada?

Un gráfico de identidad privada es un mapa privado de relaciones entre identidades vinculadas y vinculadas, visible solo para su organización.

Cuando se incluye más de una identidad en cualquier dato ingerido desde un extremo de flujo continuo o enviado a un conjunto de datos habilitado para Identity Service, esas identidades se vinculan en el gráfico de identidad privada. Identity Service aprovecha este gráfico para recopilar identidades de un consumidor o entidad determinados, lo que permite la unión de identidades y la combinación de perfiles.

¿Cómo se crean varios campos de identidad dentro de un esquema XDM?

Los esquemas Experience Data Model (XDM) admiten varios campos de identidad. Cualquier campo de datos de tipo string dentro de un esquema que implementa la clase XDM Individual Profile o XDM ExperienceEvent puede etiquetarse como un campo de identidad. Una vez etiquetados, los datos contenidos en estos campos se añaden al mapa de identidad del perfil.

Para ver los pasos sobre cómo etiquetar un campo XDM como campo de identidad mediante la interfaz de usuario, consulte la sección de identidad en el tutorial del Editor de esquemas. Si está usando la API, consulte la sección del descriptor de identidad en el tutorial de la API del Registro de esquemas.

¿Hay contextos en los que algunos campos no deben etiquetarse como identidades?

Los campos de identidad deben reservarse para valores que sean únicos para cada individuo. Por ejemplo, considere un conjunto de datos para un programa de lealtad de clientes. El campo "nivel de lealtad" (oro, plata, bronce) no sería un campo de identidad útil, mientras que el ID de lealtad (un valor único) sí lo sería.

Los campos como códigos postales y direcciones IP no deben etiquetarse como identidades de personas, ya que estos valores pueden aplicarse a más de una persona individual. Estos tipos de campos solo deben etiquetarse como identidades para las estrategias de marketing del hogar.

¿Por qué mis campos de identidad no se vinculan de la forma esperada?

Al usar el extremo /cluster/members en la API del servicio de identidad, puede ver las identidades asociadas de uno o más campos de identidad. Si la respuesta no devuelve las identidades vinculadas esperadas, asegúrese de proporcionar la información de identidad adecuada en los datos XDM. Consulte la sección sobre proporcionar datos XDM al servicio de identidad en la descripción general del servicio de identidad para obtener más información.

¿Qué es un área de nombres de identidad?

Un área de nombres de identidad proporciona contexto para la relación entre los campos de identidad y la identidad de un cliente. Por ejemplo, los campos de identidad del área de nombres "Correo electrónico" deben ajustarse a un formato de correo electrónico estándar (nombre@emailprovider.com), mientras que los campos que utilizan el área de nombres "Teléfono" deben ajustarse a un número de teléfono estándar (como 987-555-1234 en Norteamérica).

Las áreas de nombres distinguen valores de identidad similares entre sistemas CRM diferentes. Por ejemplo, piense en un perfil que contenga un ID de fidelidad numérico asociado al programa de recompensas de su empresa. Un área de nombres de "Fidelidad" separaría este valor de un ID numérico similar para su sistema de comercio electrónico que también aparece en el mismo perfil.

Consulte la descripción general del área de nombres de identidad para obtener más información.

¿Cómo asocio una identidad con un área de nombres de identidad?

Los campos de identidad deben asociarse con un área de nombres de identidad existente cuando se crean. Las áreas de nombres nuevas deben crearse con la API antes de asociarlas con campos de identidad.

Para obtener instrucciones paso a paso para definir un área de nombres al crear un descriptor de identidad mediante la API, consulte la sección sobre creación de un descriptor en la guía para desarrolladores de Schema Registry. Para marcar un campo de esquema como identidad en la interfaz de usuario, siga los pasos del tutorial del editor de esquemas.

¿Cuáles son las áreas de nombres de identidad estándar proporcionadas por Experience Platform? standard-namespaces

Las áreas de nombres de identidad estándar son áreas de nombres disponibles para todas las organizaciones. Vea la descripción general de áreas de nombres de identidad para obtener una lista completa de las áreas de nombres estándar disponibles.

¿Dónde puedo encontrar la lista de áreas de nombres de identidad disponibles para mi organización?

Con la API del servicio de identidad Identity, puede enumerar todas las áreas de nombres de identidad disponibles para su organización realizando una solicitud de GET al extremo /idnamespace/identities. Consulte la sección sobre listar áreas de nombres disponibles en la descripción general de la API del servicio de identidad para obtener más información.

¿Cómo se crea un área de nombres personalizada para la organización?

Con la API del servicio de identidad, puede crear un área de nombres de identidad personalizada para su organización realizando una solicitud de POST al extremo /idnamespace/identities. Consulte la sección sobre creación de un área de nombres personalizada en la descripción general de la API del servicio de identidad para obtener más información.

¿Qué son las identidades compuestas y los XID?

En las llamadas a API se hace referencia a las identidades por su identidad compuesta o XID. Una identidad compuesta es una representación de una identidad que contiene un valor de ID y un área de nombres. Un XID es un identificador de un solo valor que representa la misma construcción que una identidad compuesta (un ID y un área de nombres) y se asigna automáticamente a nuevas identidades cuando el servicio de identidad las mantiene. Consulte la descripción general de la API del servicio de identidad para obtener más información.

¿Cómo gestiona el servicio de identidad la información de identificación personal (PII)?

El servicio de identidad tiene áreas de nombres estándar para admitir la ingesta de valores de identidad con hash para números de teléfono y correos electrónicos. Sin embargo, usted es responsable del hash de los valores. Para obtener más información sobre los datos hash que se incorporan en Platform, consulte la Data Prep guía de funciones de asignación.

¿Hay alguna consideración al hash de las identidades basadas en PII?

Si está enviando valores PII con hash al servicio de identidad, debe utilizar el mismo método de cifrado en todos los conjuntos de datos. Esto garantiza que el mismo valor de identidad en todos los conjuntos de datos genere los mismos valores hash y que puedan coincidir y vincularse correctamente en el gráfico de identidad.

¿Por qué no puedo acceder a la página o las API del gráfico de identidad?

El administrador de Platform debe proporcionarle el permiso view-identity-graph para que pueda ver los datos del gráfico de identidad. Sin este permiso, recibirá un mensaje de permiso denegado en la página del visor de gráficos de identidades y al llamar a las API de Platform. Consulte la descripción general del control de acceso para obtener más información sobre los permisos.

Resolución de problemas

En la siguiente sección se proporcionan sugerencias para la resolución de problemas de códigos de error específicos y comportamiento inesperado que puede encontrar al trabajar con la API Identity Service.

Identity Service mensajes de error

A continuación se muestra una lista de mensajes de error que pueden aparecer al usar la API Identity Service.

Falta un parámetro de consulta obligatorio

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

Este error se muestra cuando un parámetro de consulta requerido no se incluyó en la ruta de solicitud. El detail del mensaje de error proporciona el nombre del parámetro que falta. Las variaciones de este mensaje de error incluyen:

Compruebe que está incluyendo correctamente el parámetro indicado en la ruta de solicitud antes de intentarlo de nuevo.

La marca de tiempo debe estar entre los últimos 180 días

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Timestamp should be within last 180 days"
}

Identity Service purga los datos anteriores a 180 días. Este mensaje de error se muestra cuando intenta acceder a datos anteriores a este.

Hay un límite de 1000 XID en una sola llamada

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit of 1000 XIDs in a single call"
}

Este mensaje de error se muestra cuando intenta recuperar información de identidad de más del número máximo de XIDs permitidos en una sola llamada de API. Reduzca el número de XID de la solicitud por debajo del límite mostrado para resolver este problema.

Hay un límite de 1000 compositesXids en una sola llamada

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit for 1000 compositeXids in a single call"
}

Este mensaje de error se muestra cuando intenta recuperar información de identidad para un número superior al máximo de identidades compuestas permitidas en una sola llamada de API. Reduzca la cantidad de identidades compuestas en la solicitud por debajo del límite mostrado para resolver este problema.

El tipo de gráfico especificado no es válido

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "The graph-type abc specified is invalid. Please provide a valid graph-type"
}

Este mensaje de error se muestra cuando un parámetro de consulta graph-type recibe un valor no válido en la ruta de solicitud. Consulte la sección sobre gráficos de identidad en la descripción general de Identity Service para saber qué tipos de gráficos son compatibles.

El token de servicio no tiene un ámbito válido

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Service token does not have valid scope. Either acp.core.identity or acp.foundation is required"
}

Este mensaje de error se muestra cuando su organización no se ha aprovisionado con los permisos adecuados para Identity Service. Póngase en contacto con el administrador del sistema para resolver este problema.

El token del servicio de puerta de enlace no es válido

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Gateway service token is not valid"
}

En el caso de este error, el token de acceso no es válido. Los tokens de acceso caducan cada 24 horas y deben regenerarse para seguir usando las API Platform. Consulte el tutorial de autenticación para obtener instrucciones sobre cómo generar nuevos tokens de acceso.

El token del servicio de autorización no es válido

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Authorization service token is not valid"
}

En el caso de este error, el token de acceso no es válido. Los tokens de acceso caducan cada 24 horas y deben regenerarse para seguir usando las API Platform. Consulte el tutorial de autenticación para obtener instrucciones sobre cómo generar nuevos tokens de acceso.

El token de usuario no tiene un contexto de producto válido

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "User token does not have valid product context"
}

Este mensaje de error se muestra cuando el token de acceso no se ha generado a partir de una integración de Experience Platform. Consulte el tutorial de autenticación para obtener instrucciones sobre cómo generar nuevos tokens de acceso para una integración de Experience Platform.

Error interno al obtener XID nativo desde el código de identidad y área de nombres

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Invalid IMS Token/IMS Org | Internal error - when tried to get native XID from identity and namespace code"
}

Cuando Identity Service conserva una identidad, el ID de la identidad y el ID del área de nombres asociado se asignan a un identificador único denominado XID. Este mensaje se muestra cuando se produce un error durante el proceso de búsqueda del XID para un valor de ID y un área de nombres determinados.

La organización de IMS no está aprovisionada para el uso de Identity Service

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "The IMS Org. {IMS_ORG_NAME} is not provisioned for Identity Service usage"
}

Este mensaje de error se muestra cuando su organización no se ha aprovisionado con los permisos adecuados para Identity Service. Póngase en contacto con el administrador del sistema para resolver este problema.

Error interno del servidor

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Server Error. There was a problem processing your request"
}

Este error se muestra cuando se produce una excepción inesperada en la ejecución de una llamada de servicio Platform. La práctica recomendada es programar las llamadas automatizadas para que reintenten sus solicitudes unas cuantas veces a intervalos cronometrados cuando reciban este error. Si el problema persiste, póngase en contacto con el administrador del sistema.

Códigos de error de ingesta por lotes

Identity Service ingiere datos de identidad a partir de datos de registros y series temporales que se han cargado a Platform mediante la ingesta por lotes. Como la ingesta por lotes es un proceso asincrónico, debe ver los detalles de un lote para ver los errores. Los errores se acumulan a medida que el lote progresa hasta que se complete.

A continuación se muestra una lista de mensajes de error relacionados con Identity Service que podría encontrar al usar la API de ingesta por lotes.

Esquema XDM desconocido

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Unknown XDM schema"
}

Identity Service solo consume identidades para datos de registros o series temporales que se ajusten a las clases Profile o ExperienceEvent, respectivamente. Si se intenta la ingesta de datos para Identity Service que no se adhiere a ninguna de las clases, se almacenará en déclencheur este error.

Había 0 identidades válidas en las primeras 100 filas del lote procesado

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There were 0 valid identities in the first 100 rows of the processed batch"
}

Este error se muestra cuando las primeras 100 filas de un lote no presentan identidades. Sin embargo, este error no indica de forma concluyente que no se encontraran identidades en registros posteriores.

Registros omitidos, ya que solo tenían 1 identidad por registro XDM

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Skipped {NUMBER_OF_RECORDS} records as they had only 1 identity per XDM record"
}

Identity Service solo vincula identidades cuando los registros únicos presentan dos o más valores de identidad. Este mensaje de error se produce una vez por cada lote ingerido y muestra el número de registros en los que solo se pudo encontrar una identidad, sin que se haya producido ningún cambio en el gráfico de identidades.

El código de área de nombres no está registrado para esta organización de IMS

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Namespace Code {ERRONEOUS_CODE} is not registered for this IMS Org"
}

Este error se muestra cuando un registro ingerido presenta una identidad cuyo área de nombres asociada no existe o su organización no puede acceder a ella.

Omitiendo la ingesta por lotes, ya que la organización de IMS no está aprovisionada para el gráfico de identidad privada

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "Skipping batch ingestion as IMS Org is not provisioned for Private Identity Graph"
}

Al ingerir datos por lotes, este mensaje de error se muestra cuando su organización no se ha aprovisionado con los permisos adecuados para Identity Service. Póngase en contacto con el administrador del sistema para resolver este problema.

Error interno

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Error. There was a problem during the ingestion"
}

Este error se muestra cuando se produce una excepción inesperada durante una ingesta por lotes. La práctica recomendada es programar las llamadas automatizadas para que reintenten sus solicitudes unas cuantas veces a intervalos cronometrados cuando reciban este error. Si el problema persiste, póngase en contacto con el administrador del sistema.