生成数据集重叠报表

数据集重叠报表通过公开对可寻址受众（配置文件）贡献最大的数据集，可以显示组织Profile存储的构成。

除了提供对数据的分析之外，此报表还可以帮助您采取措施来优化许可证使用情况，例如为特定数据的有效期设置限制。

本教程概述了使用Real-time Customer Profile API生成数据集重叠报表并解释贵组织的结果所需执行的步骤。

快速入门

要使用Adobe Experience Platform API，您必须先完成身份验证教程以收集所需标头所需的值。 要了解有关Experience PlatformAPI的更多信息，请参阅Platform API快速入门文档。

本教程中所有API调用所需的标头包括：

• Authorization: Bearer {ACCESS_TOKEN}:标 Authorization 头需要前置有单词的访问令 Bearer牌。必须每24小时生成一次新的访问令牌值。
• x-api-key: {API_KEY}:也 API Key 称为， Client ID 是一个只需生成一次的值。
• x-gw-ims-org-id: {IMS_ORG}:也 IMS Org 称为，只 Organization ID 需生成一次。

完成身份验证教程并收集所需标头的值后，您便可以开始调用实时客户API。

使用命令行生成数据集重叠报表

如果您熟悉使用命令行，可以使用以下cURL请求通过对/previewsamplestatus/report/dataset/overlap执行GET请求来生成数据集重叠报表。

请求

以下请求使用date参数返回指定日期的最新报表。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

响应

成功的请求会返回HTTP状态200（确定）和数据集重叠报表。 该报表包含一个data对象，其中包含以逗号分隔的数据集列表及其各自的配置文件计数。 有关如何读取报表的详细信息，请参阅本教程后面关于解释数据集重叠报表数据的部分。

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

使用Postman生成数据集重叠报表

Postman是用于API开发的协作平台，可用于将API调用可视化。 可以从Postman网站免费下载该UI，并为执行API调用提供了易于使用的UI。 以下屏幕截图使用Postman界面。

请求

要使用Postman请求数据集重叠报表，请完成以下步骤：

• 使用下拉菜单，选择GET作为请求类型。
• 在KEY列中输入所需的标题：
  • Authorization
  • x-api-key
  • x-gw-ims-org-id
• 在VALUE列中输入您在验证期间生成的值，替换大括号({{ }})和大括号内的任何内容。
• 输入包含或不包含可选date参数的请求路径：
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
  或
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD

请求类型、标头、值和路径完成后，选择​发送​以发送API请求并生成报表。

响应

成功的请求会返回HTTP状态200（确定）和数据集重叠报表。 该报表包含一个data对象，其中包含以逗号分隔的数据集列表及其各自的配置文件计数。 有关如何读取报表的详细信息，请参阅解释数据集重叠报表数据部分。

解释数据集重叠报表数据

生成的数据集重叠报表提供了一个显示报表日期和时间的时间戳，以及一个数据对象，该数据对象包含以逗号分隔的列表形式的数据集ID的唯一组合。 以下各节提供了有关报表各组成部分的其他信息。

报表时间戳

reportTimestamp与API请求中提供的日期匹配，或者如果未提供日期，则与最新报表的时间戳匹配。

数据集ID列表

data对象包含以逗号分隔的列表形式的数据集ID的唯一组合，以及该数据集组合的相应配置文件计数。

要解释报表的结果，请考虑以下示例：

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

此报表提供以下信息：

• 共有123个用户档案，其中包含来自以下数据集的数据：5d92921872831c163452edc8、5da7292579975918a851db57、5eb2cdc6fa3f9a18a7592a98。
• 共有454,412个用户档案，包含来自以下两个数据集的数据：5d92921872831c163452edc8和5eb2cdc6fa3f9a18a7592a98。
• 有107个配置文件，它们只包含来自数据集5eeda0032af7bb19162172a7的数据。
• 组织共有454,642个用户档案。

后续步骤

完成本教程后，您现在可以使用实时客户资料API生成数据集重叠报表。 要了解有关在API和Experience PlatformUI中使用配置文件数据的更多信息，请首先阅读配置文件概述文档。