查询 Amazon Pinpoint 分析数据 - Amazon Pinpoint
在 Amazon Pinpoint 中查询指标

终止支持通知：AWS 将于 2026 年 10 月 30 日终止对 Amazon Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、客户细分、营销活动、旅程和分析）。有关更多信息，请参阅 Amazon Pinpoint 终止支持。注意：与短信、语音、移动推送、OTP 和电话号码验证相关的 API 不受此变更的影响，AWS End User Messaging 支持这些功能。

查询 Amazon Pinpoint 分析数据

除了使用 Amazon Pinpoint 控制台上的分析页面之外，您还可以使用 Amazon Pinpoint Analytics API 查询一部分标准指标的分析数据，从而了解与用户参与度、活动推广等相关的趋势。这些指标也称为关键绩效指标 (KPI)，它们是一些可测量的值，能帮助您监控和评估项目、活动和旅程的绩效。

如果您使用 API 查询分析数据，则可以使用所选的报告工具来分析数据，而无需登录 Amazon Pinpoint 控制台，或者分析来自诸如 Amazon Kinesis Streams 等源的原始事件数据。例如，您可以构建一个自定义控制面板，来显示每周活动成果或提供活动送达率的深度分析数据。

您可以使用 Amazon Pinpoint REST API、AWS Command Line Interface (AWS CLI) 或 AWS SDK 查询数据。要查询数据，请向 Amazon Pinpoint API 发送请求，并使用支持的参数指定您所需的数据以及要应用的任何筛选器。提交查询后，Amazon Pinpoint 在 JSON 响应中返回查询结果。然后，您可以将这些结果传递到其他服务或应用程序，以便进行更深入的分析、存储或报告。

Amazon Pinpoint 自动为所有项目、活动和旅程收集和聚合所有受支持指标的数据。此外，由于这些数据不断更新，导致数据延迟，但延迟时间限于约两小时内。但要注意，某些指标可能具有更长时间的数据延迟。这是因为，某些指标的数据基于我们从收件人的电子邮件提供商那里收到的信息。一些提供商会立即向我们发送此类信息，而另一些提供商可能不会这么快地向我们发送信息。

Amazon Pinpoint 将这些数据存储 90 天。要想将数据存储 90 天以上或实时访问原始分析数据，您可以配置 Amazon Pinpoint 项目以将事件数据流式流传输到 Amazon Kinesis Data Streams 或 Amazon Data Firehose。有关配置事件流的信息，请参阅使用 Amazon Pinpoint 通过 Kinesis 和 Firehose 流式传输应用程序事件数据。

在 Amazon Pinpoint 中查询指标的组件和参数

要查询指标的数据，您可以将 get 请求发送到 Amazon Pinpoint API 的相应指标资源。在您的请求中，您可以使用以下查询组件的受支持参数来定义查询：

  • 项目 – 通过提供项目 ID 作为 application-id 参数的值来指定项目。此参数是所有指标的必需参数。

  • 活动 – 通过提供活动 ID 作为 campaign-id 参数的值来指定活动。此参数仅是活动指标的必需参数。

  • 旅程 – 通过提供旅程 ID 作为 journey-id 参数的值来指定旅程。仅旅程参与和执行指标以及旅程活动执行指标需要使用该参数。

  • 旅程活动 – 通过提供旅程活动 ID 作为 journey-activity-id 参数的值来指定旅程活动。仅旅程活动执行指标需要使用该参数。

  • 日期范围（可选）– 要按日期范围筛选数据，请使用支持的开始和结束时间参数来提供日期范围的起始和截止日期和时间。这些值应采用扩展的 ISO 8601 格式，并使用协调世界时 (UTC)，例如，2019-07-19T20:00:00Z 表示协调世界时 2019 年 7 月 19 日晚上 8 点。

    日期范围是包含性的，必须限制为不超过 31 个日历天。此外，起始日期和时间必须距离当前日期不到 90 天。如果未指定日期范围，则 Amazon Pinpoint 返回前 31 个日历日期间的数据。除了旅程执行指标和旅程活动执行指标以外，所有其他指标均支持日期范围参数。

  • 指标 – 通过提供指标名称作为 kpi-name 参数的值来指定指标。此值描述了关联的指标并包含两个或两个以上的术语，这些术语由小写字母数字字符组成并由连字符分隔。示例包括 email-open-rate 和 successful-delivery-rate。除了旅程执行指标和旅程活动执行指标以外，所有其他指标均需要使用该参数。有关受支持的指标及其所用的 kpi-name 值的完整列表，请参阅。项目、活动和旅程的标准指标

发送查询后，Amazon Pinpoint 在 JSON 响应中返回查询结果。在响应中，结果的结构因您查询的指标而异。

某些指标仅提供一个值，例如，某个活动送达的消息数。某些指标则提供多个值，并且这些值通常按相关字段进行分组，例如，对于某个活动的每次运行，按活动运行来分组送达的消息数量。如果指标提供多个值并进行分组，则 JSON 响应包括一个字段，以指示使用哪个字段对数据进行分组。要了解有关查询结果结构的更多信息，请参阅使用 JSON 查询结果。