Show Menu
主题×

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) 模式支持多个标识字段。 实现XDM单个 string 用户档案或XDM ExperienceEvent类的模式中任何类型的数据字段都可以标记为标识字段。 标记后,这些字段中包含的任何数据都将添加到用户档案的标识图中。
有关如何使用用户界面将XDM字段标记为标识字段的步骤,请参阅模式编辑器教 程中的 “标识”部分。 如果您使用的是API,请参阅模式注册 表API教程中的 “标识描述符”部分。

是否存在某些字段不应标记为身份的上下文?

标识字段应保留为每个人的唯一值。 例如,考虑客户忠诚度项目的数据集。 “忠诚度级别”字段(金牌、银牌、铜牌)将不是有用的身份字段,而忠诚度ID(唯一值)将是。
ZIP代码和IP地址等字段不应标记为个人身份,因为这些值可适用于多个个人。 这些类型的字段只应被标记为家庭级营销策略的标识。

为什么我的身份字段没有按我所期望的方式链接?

使用 /cluster/members API中的端点,您可以为一个或多个标识字段视图关联的标识。 如果响应不返回您期望的链接身份,请确保您在XDM数据中提供适当的身份信息。 有关详细信息,请 参阅Identity Service概述中有关向Identity Service提供XDM数据的部分

什么是身份命名空间?

标识命名空间提供了标识字段如何与客户标识相关的上下文。 例如,“电子邮件”命名空间下的标识字段应符合标准电子邮件格式(名称 @emailprovider.com),而使用“电话”命名空间的字段应符合标准电话号码(如北美的987-555-1234)。
命名空间区分不同CRM系统之间的相似标识值。 例如,考虑一个用户档案,其中包含与您的公司奖励项目关联的数字忠诚度ID。 “忠诚度”命名空间会将此值与同一用户档案中显示的电子商务系统的类似数字ID分开。

如何将标识与标识命名空间关联?

创建标识字段时,必须将其与现有标识命名空间关联。 在将任何新命名空间与标 识字段关联之前 ,必须使用API创建它们。
有关在使用API创建标识描述符时定义命名空间的分步说明,请参阅《模式注册表开发人员指南》中有关 创建描述符的一节 。 要在UI中将模式字段标记为标识,请执行模式编辑器教程中 的步骤

Experience Platform提供的标准标识命名空间有哪些?

以下标准命名空间供Experience Platform内的所有组织使用:
显示名称
ID
代码
描述
CORE
0
CORE
旧名称:“Adobe AudienceManager”
ECID
4
ECID
别名:“Adobe Marketing Cloud ID”、“Adobe Experience Cloud ID”、“Adobe Experience Platform ID”
电子邮件
6
电子邮件
电子邮件(SHA256,小写)
11
电子邮件
用于预哈希电子邮件的标准命名空间。 此命名空间中提供的值在使用SHA-256进行哈希处理之前会转换为小写。
Phone
7
Phone
Windows AID
8
WAID
AdCloud
411
AdCloud
别名:Ad Cloud
Adobe Target
9
TNTID
目标ID
Google广告ID
20914
GAID
GAID
Apple IDFA
20915
IDFA
广告商的ID

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

使用 Identity Service API ,您可以通过向端点发出GET请求,为组织列表所有可用的标识 /idnamespace/identities 命名空间。 有关详细信息,请 参阅Identity Service API概述 中列出可用命名空间部分。

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

使用 Identity Service API ,您可以通过向端点发出POST请求为组织创建自定义标识 /idnamespace/identities 命名空间。 有关详细信息, 请参阅Identity Service API概述中有关创建自定义命名空间的部分

什么是综合身份和XID?

标识在API调用中由其组合标识或XID引用。 组 合标识 是包含ID值和命名空间的标识的表示。 XID是 单值标识符 ,它表示与组合标识(ID和命名空间)相同的构造,并在由标识服务保留时自动分配给新标识。 有关详细 信息,请参阅Identity Service API概述

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

Identity Service在持久值之前为PII创建强的单向加密哈希。 “电话”和“电子邮件”命名空间中的标识数据使用SHA-256自动进行哈希处理,“电子邮件”值在哈希处理之前自动转换为小写。

我是否应在发送到平台之前加密所有PII?

在将PII数据引入平台之前,您无需手动加密它。 通过将数据使 I1 用标签应用于所有适用的数据字段,平台在引入时会自动将这些字段转换为哈希ID值。
有关如何应用和管理数据使用标签的步骤,请参阅数 据使用标签教程

在散列基于PII的身份时,是否有考虑事项?

如果要将哈希PII值发送到Identity Service,则必须在数据集中使用相同的加密方法。 这可确保数据集上的相同标识值生成相同的哈希值,并能够在标识图中正确匹配和链接。

故障诊断

以下部分针对您在使用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天以上的数据。 当您尝试访问早于此时间的数据时,将显示此错误消息。

单次呼叫中的XID限制为1000个

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

当您尝试检索超过单个API调用中允许的最大XID数的身份信息时 #what-are-composite-identities-and-xids ,会显示此错误消息。 将请求中的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"
}

当您的IMS组织尚未为Identity Service提供正确的权限时,将显示此错误消息。 请联系您的系统管理员以解决此问题。

网关服务令牌无效

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

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

授权服务令牌无效

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

如果出现此错误,则您的访问令牌无效。 访问令牌每24小时过期一次,必须重新生成才能继续使用平台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"
}

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

当您的IMS组织尚未为Identity Service提供正确的权限时,将显示此错误消息。 请联系您的系统管理员以解决此问题。

内部服务器错误

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

当平台服务调用执行中发生意外异常时,将显示此错误。 最佳实践是项目自动调用,在收到此错误时以定时间隔重试其请求几次。 如果问题仍然存在,请与系统管理员联系。

批量摄取错误代码

Identity Service从记录和使用批处理摄取上传到平台的时间序列数据中摄取标识数据。 由于批处理是异步过程,因此您必须将批处理的详细信息视图为视图错误。 错误将随着批处理的进行而累积,直到批处理完成。
以下是一列表与Identity Service相关的错误消息,您在使用Data Ingestion API时可能会 遇到这些错误消息

未知的XDM模式

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

Identity Service仅使用分别符合用户档案类或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"
}

只有在单个记录显示两个或两个以上标识值时,标识服务才会链接标识。 对于每个摄取的批次,此错误消息发生一次,并显示只能找到一个身份并导致对身份图没有更改的记录数。

命名空间代码未注册到此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"
}

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