文档 Experience Platform Platform Identity Service 指南

Identity Service故障排除指南

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Identities

创建对象：

Admin
Developer

本文档提供了有关Adobe Experience Platform的常见问题解答 Identity Service以及常见错误的疑难解答指南。有关的问题和疑难解答 Platform API一般而言，请参阅 Adobe Experience Platform API疑难解答指南.

用于识别单个客户的数据通常分散在客户用于与您的品牌互动的各种设备和系统中。 Identity Service 将这些零散的标识聚合在一起，有助于全面了解客户行为，以便您能够实时提供有影响力的数字体验。欲了解更多信息，请参见 Identity服务概述.

常见问题解答

以下是关于以下内容的常见问题解答列表 Identity Service.

什么是身份数据？

身份数据是指可用于识别个人的任何数据。根据组织中如何使用数据的上下文，身份数据可以包括CRM系统中的用户名、电子邮件地址和ID。身份数据不仅限于网站或服务的注册用户，因为匿名用户也可以通过其设备或Cookie ID进行标识。

将数据字段标记为身份有什么好处？

通过将某些数据字段标记为记录和时间序列数据中的身份，您可以在数据的自然结构中映射身份关系，并跨渠道协调重复数据。请参阅 Identity服务概述以了解更多信息。

什么是已知身份和匿名身份？

已知身份是指可以单独使用或与其他信息一起用于识别、联系或查找个人的身份值。已知身份的示例可能包括电子邮件地址、电话号码和CRM ID。

匿名身份是指无法单独使用或与其他信息配合使用来识别、联系或查找个人（例如Cookie ID）的身份值。

什么是专用身份图？

专用身份图是缝合身份和链接身份之间关系的专用映射，仅对您的组织可见。

在从流端点摄取或发送到为启用的数据集的任何数据中包括多个身份时 Identity Service，则这些身份将在专用身份图中进行链接。 Identity Service 利用此图表获取给定消费者或实体的身份，从而允许身份拼接和配置文件合并。

如何在XDM架构中创建多个标识字段？

体验数据模型(XDM) 架构支持多个标识字段。任何类型的数据字段 string 在实施XDM Individual Profile或XDM ExperienceEvent类的架构中，可以标记为标识字段。标记后，这些字段中包含的任何数据都会添加到用户档案的标识映射中。

有关如何使用用户界面将XDM字段标记为标识字段的步骤，请参阅 “身份”部分在架构编辑器教程中。如果您使用的是API，请参阅 “身份描述符”部分在架构注册表API教程中。

是否存在某些字段不应标记为标识的上下文？

应为每个人的唯一值保留标识字段。例如，考虑一个客户忠诚度计划的数据集。 “忠诚度级别”字段（金、银、铜）不是有用的标识字段，而“忠诚度ID”（唯一值）将是。

邮政编码和IP地址等字段不应标记为个人的身份，因为这些值可以应用于多个个人。对于家庭级别的营销策略，这些类型的字段只应标记为身份。

为什么我的身份字段没有按预期方式关联？

使用 /cluster/members 端点在Identity Service API中，您可以查看一个或多个标识字段的关联标识。如果响应未返回预期的链接身份，请确保在XDM数据中提供相应的身份信息。请参阅以下部分向Identity服务提供XDM数据有关更多信息，请参阅Identity Service概述。

什么是身份命名空间？

身份命名空间为身份字段如何与客户身份关联提供了上下文。例如，“电子邮件”命名空间下的身份字段应符合标准电子邮件格式（名称）@emailprovider.com)而使用“Phone”命名空间的字段应符合标准电话号码（例如，在北美为987-555-1234）。

命名空间可以区分不同CRM系统之间的相似标识值。例如，假定某个用户档案包含与公司奖励计划关联的会员数字ID。 “忠诚度”命名空间会将此值与同样显示在同一配置文件中的电子商务系统的类似数值ID分隔开。

请参阅身份命名空间概述以了解更多信息。

如何将身份与身份命名空间关联？

身份字段在创建时必须与现有的身份命名空间关联。任何新命名空间必须使用API创建将其与标识字段关联之前。

有关在使用API创建身份描述符时定义命名空间的分步说明，请参阅创建描述符在架构注册开发人员指南中。要在UI中将架构字段标记为标识，请按照架构编辑器教程.

Experience Platform提供的标准身份命名空间是什么？ standard-namespaces

标准身份命名空间是适用于所有组织的命名空间。请参阅身份命名空间概述以获取可用标准命名空间的完整列表。

在哪里可以找到可用于我的组织的身份命名空间列表？

使用标识服务API，则可以通过向以下网站发出GET请求来列出贵组织的所有可用身份命名空间： /idnamespace/identities 端点。请参阅以下部分列出可用命名空间有关更多信息，请参阅Identity Service API概述。

如何为我的组织创建自定义命名空间？

使用标识服务API，则可以通过向以下网站发出POST请求，为您的组织创建自定义身份命名空间： /idnamespace/identities 端点。请参阅以下部分创建自定义命名空间有关更多信息，请参阅Identity Service API概述。

什么是复合身份和XID？

API调用中由其复合身份或XID引用身份。复合身份是包含ID值和命名空间的身份的表示形式。 XID是一个单值标识符，它表示与复合身份（ID和命名空间）相同的构造，当身份服务持久化时，它会自动分配给新身份。请参阅 Identity服务API概述以了解更多信息。

Identity Service如何处理个人身份信息(PII)？

Identity Service具有标准命名空间，可支持为电话号码和电子邮件摄取哈希身份值。但是，您应负责值的哈希处理。要了解有关对摄取到Platform中的数据执行哈希处理的更多信息，请参阅 Data Prep 映射函数指南.

对基于PII的标识进行哈希处理时是否有任何注意事项？

如果要将经过哈希处理的PII值发送到Identity Service，则必须在数据集中使用相同的加密方法。这可确保跨数据集的相同身份值生成相同的哈希值，并能够在身份图中进行正确匹配和链接。

为何无法访问身份图页面或API？

您的平台管理员必须为您预配 view-identity-graph 权限，以便您查看身份图数据。如果没有此权限，您将在身份图查看器页面上以及调用平台API时，收到权限被拒绝消息。请参阅访问控制概述以了解有关权限的更多信息。

故障排除

以下部分针对您在使用 Identity Service API。

Identity Service 错误消息

以下是使用时可能遇到的错误消息列表 Identity Service API。

缺少所需的查询参数

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

当请求路径中未包含所需的查询参数时，将显示此错误。此 detail 错误消息的名称提供了缺少的参数的名称。此错误消息的变体包括：

缺少所需的查询参数 — nsId
缺少所需的查询参数 — id
缺少所需的查询参数 — xid或(nsid，id)
缺少所需的查询参数 — targetNs
缺少所需的查询参数 — xids或compositeXids

在重试之前，请检查您在请求路径中是否正确包含了指示的参数。

时间戳应在最近180天内

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

Identity Service 清除超过180天的数据。当您尝试访问早于此日期的数据时，会显示此错误消息。

单个调用中存在1000个XID的限制

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

当您尝试检索的标识信息超过最大数量时，将显示此错误消息。 XID 在单个API调用中允许。将请求中的XID数量减少到显示限制以下可解决此问题。

单个调用中存在1000个compositeXid的限制

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

当您尝试检索的标识信息超过最大数量时，将显示此错误消息。复合身份在单个API调用中允许。将请求中的复合身份数减少到显示限制以下可解决此问题。

指定的图形类型无效

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

此错误消息在以下情况下显示 graph-type 在请求路径中，为查询参数指定了无效值。请参阅以下部分身份图在 Identity Service 概述，以了解支持的图形类型。

服务令牌没有有效的范围

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

如果您的组织尚未为配置适当的权限，则会显示此错误消息。 Identity Service. 请与系统管理员联系以解决此问题。

网关服务令牌无效

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

如果出现此错误，您的访问令牌无效。访问令牌每24小时过期一次，必须重新生成才能继续使用 Platform API。请参阅身份验证教程以获取有关生成新访问令牌的说明。

授权服务令牌无效

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

用户令牌没有有效的产品上下文

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

当您的访问令牌不是从 Experience Platform 集成。请参阅身份验证教程有关为生成新的访问令牌的说明 Experience Platform 集成。

从标识和命名空间代码获取本机XID时出现内部错误

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

时间 Identity Service 保留一个身份，该身份的ID和关联的命名空间ID将分配一个称为XID的唯一标识符。在查找给定ID值和命名空间的XID的过程中发生错误时，将显示此消息。

未为配置IMS组织 Identity Service 使用情况

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

如果您的组织尚未为配置适当的权限，则会显示此错误消息。 Identity Service. 请与系统管理员联系以解决此问题。

内部服务器错误

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

当执行时出现意外异常时，将显示此错误 Platform 维修电话。最佳实践是在收到此错误时，对自动调用进行编程，以按一定的时间间隔重试其请求。如果问题仍然存在，请与系统管理员联系。

批量摄取错误代码

Identity Service 从记录中摄取身份数据和上传到的时间序列数据 Platform 使用批量摄取。由于批次摄取是异步过程，因此您必须查看批次的详细信息才能查看错误。错误将随着批的进行而累积，直到批完成。

以下是与相关的错误消息列表 Identity Service 在使用时，您可能会遇到批量摄取API.

未知XDM架构

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

Identity Service 仅使用符合“ ”的记录或时间序列数据的身份 Profile 或 ExperienceEvent 类别进行归类。尝试摄取以下内容的数据 Identity Service 不遵守任一类都将触发此错误。

已处理批次的前100行中有0个有效标识

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

当批次的前100行不显示身份时，显示此错误。但是，此错误并不表明在后续记录中找不到身份。

跳过了记录，因为每个XDM记录只有1个身份

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

Identity Service 仅当单个记录存在两个或多个标识值时才会链接标识。此错误消息针对每个摄取的批次出现一次，并显示仅能找到一个身份并导致身份图未发生更改的记录数。

未为此IMS组织注册命名空间代码

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

当摄取的记录呈现的标识关联命名空间不存在或您的组织无法访问时，将显示此错误。

正在跳过批量摄取，因为没有为专用身份图形配置IMS组织

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

摄取批处理数据时，如果您的组织尚未为配置适当的权限，则会显示此错误消息。 Identity Service. 请与系统管理员联系以解决此问题。

内部错误

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

在批处理摄取期间发生意外异常时，将显示此错误。最佳实践是在收到此错误时，对自动调用进行编程，以按一定的时间间隔重试其请求。如果问题仍然存在，请与系统管理员联系。

recommendation-more-help

64963e2a-9d60-4eec-9930-af5aa025f5ea