生成数据集重叠报告

数据集重叠报表可让您查看贵组织的数据的组成 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: {ORG_ID}:组织ID只需生成一次。

完成身份验证教程并收集所需标头的值后,即可开始调用Real-time Customer API。

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

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

请求

以下请求使用 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: {ORG_ID}' \
参数
描述
date
指定要返回的报表的日期。 如果在该日期运行了多个报告,则会返回该日期的最新报告。 如果指定日期不存在报表,则会返回HTTP状态404(未找到)错误。 如果未指定日期,则返回最新的报告。 格式:YYYY-MM-DD。 示例:date=2024-12-31

响应

成功的请求会返回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网站 和为执行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

参数
描述
date
指定要返回的报表的日期。 如果在该日期运行了多个报告,则会返回该日期的最新报告。 如果指定日期不存在报表,则会返回HTTP状态404(未找到)错误。 如果未指定日期,则返回最新的报告。
格式:YYYY-MM-DD。 示例:date=2024-12-31

完成请求类型、标头、值和路径后,选择 发送 发送API请求并生成报告。

响应

成功的请求会返回HTTP状态200 (正常)和数据集重叠报表。 报告包括 data 对象,包含以逗号分隔的数据集列表及其各自的配置文件计数。 有关如何阅读报告的详细信息,请参阅 解释数据集重叠报表数据.

解释数据集重叠报表数据 interpret-the-report

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

报告时间戳

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

数据集ID列表

data 对象包括数据集ID的唯一组合,作为逗号分隔列表,以及该数据集组合的相应配置文件计数。

NOTE
与数据集重叠报表的每一行关联的所有配置文件计数的总和应等于贵组织中的配置文件总数。

要解释报表的结果,请考虑以下示例:

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

此报表提供以下信息:

  • 共有123个配置文件,包含来自以下数据集的数据: 5d92921872831c163452edc85da7292579975918a851db575eb2cdc6fa3f9a18a7592a98.
  • 共有454,412个用户档案包含来自以下两个数据集的数据: 5d92921872831c163452edc85eb2cdc6fa3f9a18a7592a98.
  • 有107个配置文件仅由数据集中的数据组成 5eeda0032af7bb19162172a7.
  • 该组织共有454,642个用户档案。

后续步骤

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

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b