查询事务性消息的 Amazon Pinpoint 分析数据

除了使用 Amazon Pinpoint 控制台上的分析页面外，您还可以使用 Amazon Pinpoint APIs Analytics 查询分析数据，了解一部分标准指标，这些指标可以深入了解为项目发送的交易消息的交付和参与趋势。

其中的每个指标是一个可测量的值，也称为关键绩效指标 (KPI)，它们可以帮助您监控和评估事务性消息的绩效。例如，您可以使用指标来了解您发送了多少事务性电子邮件消息或短信，或者其中有多少消息送达收件人。Amazon Pinpoint 会自动收集和汇总您为项目发送的所有事务性电子邮件消息和短信的这类数据。它将数据存储 90 天。

如果您使用 Amazon Pinpoint Analytics APIs 来查询数据，则可以选择各种选项来定义查询的范围、数据、分组和筛选条件。为此，除了应用任何基于日期的筛选器之外，您还应使用参数来指定要查询的项目和指标。

本主题提供了有关如何选择这些选项和查询项目的事务性消息数据的示例，并对这些示例进行了说明。

先决条件

在查询事务性消息的分析数据之前，收集以下信息很有用，可以用它们来定义查询：

• 项目 ID – 从中发送消息的项目的唯一标识符。在 Amazon Pinpoint API 中，此值存储在 application-id 属性中。在 Amazon Pinpoint 控制台上，此值在所有项目页面上显示为项目 ID。

• 日期范围（可选）– 设置查询数据的日期范围的起始和截止日期和时间。日期范围是包含性的，必须限制为不超过 31 个日历天。此外，起始时间必须距离当前日期不到 90 天。如果未指定日期范围，Amazon Pinpoint 将自动查询前 31 个日历日期间的数据。

• 指标 – 要查询的指标的名称，更具体地说，即指标的 kpi-name 值。有关受支持的指标及其 kpi-name 值的完整列表，请参阅项目、活动和旅程的标准指标。

它还可帮助确定是否要按相关字段对数据进行分组。如果您这样做，则可通过选择旨在自动为您对数据进行分组的指标来简化分析和报告。例如，Amazon Pinpoint 提供了多个标准指标来报告送达收件人的事务性短信的数量。其中的一个指标自动按日期对数据进行分组 (txn-sms-delivered-grouped-by-date)。另一个指标自动按国家或地区对数据进行分组 (txn-sms-delivered-grouped-by-country)。还有一个指标仅返回单个值—送达收件人的消息数 (txn-sms-delivered)。如果找不到能以您需要的方式来分组数据的标准指标，您可以开发一系列查询来返回您需要的数据。然后，您可以手动细分或者合并查询结果到您设计的自定义分组中。

最后，请务必确认您有权访问要查询的数据。有关更多信息，请参阅 有关查询 Amazon Pinpoint 分析数据的 IAM 策略。