Identity Service疑难解答指南

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

识别单个客户的数据通常会在他们用于与您的品牌互动的各种设备和系统中分散。 Identity Service 将这些分散的身份收集在一起，以促进对客户行为的完整了解，从而实时提供有影响的数字体验。有关更多信息，请参阅 Identity Service概述.

常见问题解答

以下是有关 Identity Service.

什么是身份数据？

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

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

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

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

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

匿名身份是指身份值，不能单独使用或与其他信息一起使用来识别、联系或查找个人（如Cookie ID）。

什么是专用身份图？

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

当从流端点摄取的任何数据中包含多个标识，或将多个标识发送到为 Identity Service，则这些身份会在专用身份图表中关联。 Identity Service 利用此图表来收集给定消费者或实体的身份，从而允许身份拼合和配置文件合并。

如何在XDM架构中创建多个身份字段？

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

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

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

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

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

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

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

什么是身份命名空间？

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

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

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

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

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

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

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

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

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

使用 Identity Service API，则可以通过向发出GET请求来列出组织的所有可用身份命名空间 /idnamespace/identities 端点。请参阅列出可用命名空间（在Identity Service API概述中）以了解更多信息。

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

使用 Identity Service API，则可以通过向 /idnamespace/identities 端点。请参阅创建自定义命名空间（在Identity Service API概述中）以了解更多信息。

什么是复合身份和XID?

身份在API调用中通过其复合身份或XID引用。组合标识是包含ID值和命名空间的身份的表示形式。 XID是单值标识符，它表示与复合身份（ID和命名空间）相同的结构，并在Identity服务保留时自动将其分配给新身份。请参阅 Identity Service API概述以了解更多信息。

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

Identity Service具有标准命名空间，可支持为电话号码和电子邮件摄取经过哈希处理的身份值。但是，您需要对值的哈希处理负责。要了解有关对摄取到平台中的数据进行哈希处理的更多信息，请参阅 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
缺少必需的查询参数 — xid或compositeXid

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

时间戳应在最近180天内

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

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

单次调用中的XID限制为1000个

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

当您尝试检索的身份信息超过 XID 允许在单个API调用中使用。将请求中的XID数量减少到显示的限制以下，以解决此问题。

单次调用中的复合Xid数量有1000个限制

{
    "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"
}

当您的IMS组织没有为 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"
}

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

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

{
    "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"
}

When Identity Service 标识会持续存在，标识的ID和关联的命名空间ID会被分配一个称为XID的唯一标识符。当在查找给定ID值和命名空间的XID过程中出错时，将显示此消息。

未为 Identity Service 使用情况

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

当您的IMS组织没有为 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组织无法访问，则会显示此错误。

由于未为专用身份图配置IMS组织，因此正在跳过批量摄取

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

在摄取批量数据时，当您的IMS组织没有为配置适当的权限时，会显示此错误消息 Identity Service. 请联系您的系统管理员以解决此问题。

内部错误

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

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

Business.Adobe.com 资源

Automated Onboarding Document Generation Email Deliverability Dynamic Content First Party Data Video Analytics