Show Menu
主题×

实时客户用户档案API开发人员指南

实时客户用户档案使您能够在Adobe Experience Platform中全面了解每位客户。 用户档案允许您将来自多个渠道(如在线、离线、CRM和第三方数据)的不同客户数据合并到一个统一的视图中,为每次客户交互提供具有可操作性且时间戳记的帐户。

入门指南

使用实时客户用户档案API,您可以针对用户档案资源执行基本的CRUD操作,如配置计算属性、访问实体、导出用户档案数据以及删除不需要的数据集或批量。
使用此开发人员指南需要了解处理用户档案数据时涉及的各种Adobe Experience Platform服务。 在开始使用实时客户用户档案API之前,请查阅以下服务的文档:
以下各节提供了成功调用用户档案API端点所需了解的其他信息。

读取示例API调用

实时客户用户档案API文档提供示例API调用,以演示如何正确设置请求格式。 这些包括路径、必需的标题和格式正确的请求负载。 还提供API响应中返回的示例JSON。 有关示例API调用文档中使用的惯例的信息,请参阅Experience Platform疑难解答指南 中有关如何阅读示例API调用的部分

必需的标题

API文档还要求您完成身份验证教 ,以成功调用平台端点。 完成身份验证教程后,Experience Platform API调用中每个所需标头的值将显示如下:
  • 授权:承载人 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
Experience Platform中的所有资源都与特定虚拟沙箱隔离。 对平台API的请求需要一个标头,它指定操作将在以下位置进行的沙箱的名称:
  • x-sandbox-name: {SANDBOX_NAME}
有关平台中沙箱的详细信息,请参阅沙 箱概述文档
请求主体中具有有效负荷的所有请求(如POST、PUT和PATCH调用)都必须包含标 Content-Type 头。 在呼叫参数中提供特定于每个呼叫的已接受值。

(Alpha)计算属性

计算的属性功能位于alpha中,并且并非所有用户都可用。 文档和功能可能会发生更改。
通过计算属性,您可以根据其他值、计算和表达式自动计算字段的值。 计算的属性在用户档案级别上操作,这意味着您可以跨所有记录和事件聚合值。
每个计算的属性都包含一个表达式,即“规则”,它计算传入的数据并将所得值存储在用户档案属性或事件中。 这些计算可以帮助您轻松回答与终身购买价值、购买间隔时间或应用程序打开次数等相关的问题,无需在每次需要信息时手动执行复杂计算。
您可以使用端点创建、视图、编辑和删除计算的属 config/computedAttributes 性。 要了解如何使用这些端点,请访问计 算的属性子指南

边缘投影

Adobe Experience Platform通过使数据易于在战略位置称为“边缘”的服务器上访问,实现客户体验的实时个性化。 实时客户用户档案API为通过称为“预测”的组件处理边缘提供了端点。 这包括确定应将哪些数据投影到每个边缘的投影配置,以及确定将投影路由到何处的投影目标。
有关使用边缘预测的详细信息,请访 问边缘预测子指南

实体

通过Adobe Experience Platform,您可以使用RESTful API或用户界面访问实时客户用户档案数据。 要了解如何使用API访问实体(通常称为“用户档案”),请遵循实体子指南中 所述的步骤

合并策略

在Experience Platform中将多个来源的数据整合在一起时,合并策略是平台用来确定数据的优先级以及将哪些数据合并以创建单个客户用户档案的规则。
使用实时客户用户档案API,您可以创建新的合并策略、管理现有策略并为组织设置默认的合并策略。 要进一步了解如何使用API使用合并策略,请访 问合并策略子指南
有关使用平台UI处理合并策略的指南,请参阅合 并策略用户指南

用户档案搜索

用户档案搜索用于搜索包含在各种数据源中的可配置字段并为其编制索引,并近乎实时地返回这些字段。 要开始使用用户档案搜索,请参阅 搜索子指南

用户档案系统作业

引入平台的数据存储在数据湖和实时客户用户档案数据存储中。 有时可能需要从用户档案存储中删除数据集或批量,以删除您不再需要或错误添加的数据。 这需要使用API创建称为“删除请求”的用户档案系统作业,如果需要,该作业也可以被修改、监视或删除。
要了解如何使用实时客户用户档案API中的 /system/jobs 端点处理删除请求,请遵循 用户档案系统作业子指南中所述的步骤

后续步骤

要开始使用实时客户用户档案API进行调用,请选择其中一个子指南,以了解如何使用特定的用户档案相关端点。 要进一步了解如何使用平台UI处理用户档案数据,请参阅 实时客户用户档案用户指南