实时客户资料故障排除指南

本文档提供有关实时客户个人资料的常见问题解答,以及常见错误的疑难解答指南。 有关Adobe Experience Platform中其他服务的问题和疑难解答,请参阅Experience Platform疑难解答指南

使用Real-Time Customer Profile,您可以通过组合来自多个渠道的数据(包括在线、离线、CRM和第三方)来查看每个客户的整体视图。 这使营销人员能够跨多个渠道为客户推动协调、一致且相关的体验。

常见问题解答

以下是有关Real-time Customer Profile的常见问题解答列表。

Real-time Customer Profile可接受哪些类型的数据?

配置文件同时接受​ 记录 ​和​ 时间系列 ​数据,但前提是相关数据至少包含一个标识值,用于将数据与个人唯一性关联。

与所有Platform服务一样,用户档案要求其数据在语义上采用体验数据模型(XDM)架构进行结构化。 反过来,此架构必须定义一个​ 主标识,并且启用它才能在配置文件中使用。

如果您不熟悉XDM,请从XDM概述开始了解更多信息。 接下来,请参阅XDM用户指南,以了解如何设置标识字段为配置文件启用架构的步骤。

配置文件数据存储在何处?

Real-time Customer Profile维护其自己的数据存储(称为“配置文件存储”),独立于包含其他摄取的Platform数据的数据湖。

如果我已经将数据摄取到Platform,是否可以在配置文件存储区中提供该数据?

如果数据被摄取到非配置文件数据集,您必须将该数据重新摄取到启用配置文件的数据集,才能使其在配置文件存储中可用。 可以为配置文件启用现有数据集,但是在该配置之前摄取的任何数据仍将不会显示在配置文件存储中。

如果要将以前摄取的数据添加到配置文件存储,请按照数据集配置教程创建新数据集或将现有数据集转换为配置文件启用的数据集,然后将所需的数据重新摄取到该数据集。

如何查看我摄取的配置文件数据?

查看配置文件数据的方法多种多样,具体取决于您使用的是API还是UI。

使用 API

如果您知道要访问的配置文件实体的ID,则可以使用配置文件API中的/entities(配置文件访问)端点查找这些实体。 有关详细信息,请参阅开发人员指南中有关实体的部分。

您还可以使用Adobe Experience Platform分段服务API来访问符合受众成员资格的客户的个人配置文件。 有关详细信息,请参阅分段服务概述

使用UI

在Experience PlatformUI中,配置文件 ​工作区中的​ 浏览 ​选项卡允许您查看配置文件总数并按其标识值搜索各个配置文件。 有关详细信息,请参阅配置文件用户指南

您还可以在​ 受众 ​工作区的​ 浏览 ​选项卡下查看受众列表。 选择受众后,将显示符合该受众条件的配置文件示例。 然后,您可以选择列出的任意配置文件以查看其详细信息。 有关详细信息,请参阅分段UI概述

错误代码

以下是使用Real-time Customer Profile API时可能遇到的错误消息列表。 如果此处未列出您遇到的错误,您可以在一般的平台故障排除指南中找到该错误。

无法为提供的路径查找计算属性的架构

{
  "code": "400",
  "message": "Could not lookup schema of the computed attribute for the provided path"
}

创建新的计算属性时,如果系统找不到请求有效负载中提供的架构,则会出现此错误。 请确保您在有效负载的path属性中提供了正确的租户ID,并且schema.name的值是有效的架构名称。

如果您不知道租户ID,可以按照架构注册开发人员指南中的步骤检索它。

指定的架构或definedOn已存在同名函数

{
  "code": "400",
  "message": "Function with the same name already exists for the specified schema or definedOn"
}

创建新的计算属性时,如果提供的name属性已用于schema.name下指示的架构,则会出现此错误。 在重试之前,请将该值替换为唯一名称。

表达式的返回架构与XDM架构中计算属性的架构不同

{
  "code": "400",
  "message": "Return schema of the expression is not same as the schema of the computed attribute in the XDM schema"
}

创建新的计算属性时,如果提供的name属性已用于schema.name下指示的架构,则会出现此错误。 在重试之前,请将该值替换为唯一名称。

删除请求无效(配置文件系统作业)

{
  "code": "400",
  "message": "Invalid delete request (Profile System Job)"
}

为删除系统作业提供了无效有效负载时,会发生此错误。 请确保在有效负载的dataSetIDbatchID属性下分别提供有效的数据集或批次ID。 有关详细信息,请参阅配置文件开发人员指南中有关创建删除请求的部分。

未找到配置文件数据集的批次

{
  "requestId":"LlTmQkhgHKFGHGHnIkmUxcIL4YTFSpQw",
  "errors":{
    "400":[
      {
        "code":"400",
        "message":"Batch not found for profile dataset '5da688d2c4e60518ad25b7b1'"
      }
    ]
  }
}

当尝试为配置文件数据创建删除请求时找不到有效的批次时,会发生此错误。 在重试之前,请检查您为启用配置文件的数据集输入了正确的ID。

不支持的媒体类型

{
  "status": 415,
  "title": "HTTP 415 Unsupported Media Type",
  "type": "http://ns.adobe.com/adobecloud/problem/unsupported-media-type"
}

发送具有无效Content-Type标头的POST或PUT请求时,会发生此错误。 双击是否为您使用的端点提供有效的Content-Type值。

大多数配置文件端点都接受将“application/json”作为其Content-Type标头,但以下情况除外:

终结点
Content-Type
/config/projections
application/vnd.adobe.platform.projectionConfig+json; version=1
/config/destinations
application/vnd.adobe.platform.projectionDestination+json; version=1
recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b