

**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon Pinpoint 流式传输事件
<a name="analytics-streaming"></a>

Amazon Pinpoint 可以将交互和应用程序使用数据（称为*事件数据*）流式传输到提供更多分析和存储选项的支持 AWS 服务 人员。可以利用*事件数据*，通过查看单个事件来排查问题。有关如何查看单个客户事件，请参阅《Amazon Pinpoint 开发人员指南》中的[将 Amazon Pinpoint 事件流式传输到 Kinesis](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)。**

在您将应用程序与 Amazon Pinpoint 集成之后，它能报告事件，如用户启动的会话数等。Amazon Pinpoint 在控制台上用于该应用程序的分析图表和指标中提供这些数据。分析数据还将显示 Amazon Pinpoint 生成的活动事件，如活动将消息发送到的设备的数量。

Amazon Pinpoint 保留这些数据 90 天。要无限期保留这些数据，或者要使用自定义查询和工具分析它们，您可以配置 Amazon Pinpoint 以将事件数据发送到 Amazon Kinesis。

**Topics**
+ [关于 Amazon Kinesis](#analytics-streaming-about-kinesis)
+ [将 Amazon Pinpoint 事件流式传输到 Kinesis](#analytics-streaming-kinesis)

## 关于 Amazon Kinesis
<a name="analytics-streaming-about-kinesis"></a>

Kinesis 平台提供可用于在 AWS上加载和分析流数据的服务。您可以配置 Amazon Pinpoint，以将应用程序、活动和旅程事件发送到 Amazon Kinesis Data Streams 或 Amazon Data Firehose。通过流式传输事件，可实现更灵活的数据分析选项，如：
+ 将事件从多个应用程序聚合到一个流中，以便将这些数据作为集合进行分析。
+ 使用 AWS 查询服务分析事件。例如，您可以使用 Amazon Managed Service for Apache Flink 对流数据执行 SQL 查询。

### 关于 Amazon Kinesis Data Streams
<a name="analytics-streaming-about-kinesis-streams"></a>

Amazon Kinesis Data Streams 是一种服务，可以用于构建处理或分析流数据的自定义应用程序。例如，如果要在自定义控制面板中使用事件数据、基于事件生成提醒或动态响应事件，则将事件流式传输到 Kinesis Data Streams 会非常有用。

有关更多信息，请参阅 [Amazon Kinesis Data Streams 开发人员指南](https://docs.aws.amazon.com/streams/latest/dev/)。

### 关于 Amazon Data Firehose
<a name="analytics-streaming-about-kinesis-firehose"></a>

Amazon Data Firehose 是一项可用于将流数据传输到 AWS 数据存储的服务，包括亚马逊简单存储服务 (Amazon S3)、亚马逊 Redshift 或亚马逊服务（服务）。 OpenSearch OpenSearch 例如，如果要执行以下操作，则将事件流式传输到 Firehose 会非常有用：
+ 使用您自己的分析应用程序和工具来分析 Amazon S3、Amazon Redshift 或 OpenSearch 服务中的事件。
+ 将事件发送到 Amazon S3，以便使用 Amazon Athena 对这些数据编写 SQL 查询。
+ 备份事件数据以便在 Amazon S3 中长期存储。

有关更多信息，请参阅[《Amazon Data Firehose 开发人员指南》](https://docs.aws.amazon.com/firehose/latest/dev/)。

## 将 Amazon Pinpoint 事件流式传输到 Kinesis
<a name="analytics-streaming-kinesis"></a>

Kinesis 平台提供可用于在 AWS上加载和分析流数据的服务。您可以配置 Amazon Pinpoint，以将应用程序、活动和旅程事件发送到 Amazon Kinesis Data Streams，通过外部应用程序或第三方分析工具进行处理。您也可以将 Amazon Pinpoint 配置为使用亚马逊数据 Firehose 将此事件 AWS 数据流式传输到数据存储（例如亚马逊 Redshift）。

### 先决条件
<a name="analytics-streaming-kinesis-prerequisites"></a>

在完成本部分中的过程之前，请在您使用 Amazon Pinpoint 的同一账户中创建 Amazon Kinesis 流或 Firehose 传输流。要了解有关创建 Kinesis 流的更多信息，请参阅《Amazon Kinesis Data Streams 开发人员指南》中的**[创建和更新数据流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。有关创建 Firehose 传输流的更多信息，请参阅《Amazon Data Firehose 开发人员指南》中的**[创建 Amazon Data Firehose 传输流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。

您可以选择创建 IAM 角色，以授予向您的流发送数据的权限。如果您没有创建此角色，Amazon Pinpoint 会为您创建一个。有关手动创建此策略的更多信息，请参阅《Amazon Pinpoint 开发人员指南》中的[用于将事件流式传输到 Kinesis 的 IAM 角色](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-streams.html)**。

### 设置事件流式传输
<a name="analytics-streaming-kinesis-setup"></a>

在 Amazon Pinpoint 中完成以下步骤以设置事件流式传输。

**注意**  
[如果你尚未创建亚马逊 Kinesis 直播，请前往 /kinesis 的亚马逊 Kinesis 控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/kinesis)有关创建流的更多信息，请参阅[《Amazon Kinesis Data Streams 开发人员指南》](https://docs.aws.amazon.com/streams/latest/dev/)或[《Amazon Data Firehose 开发人员指南》](https://docs.aws.amazon.com/firehose/latest/dev/)。  
确认您有权设置流并发送到流。有关权限的更多信息，请参阅[用于将事件流式传输到 Kinesis 的 IAM 角色](/pinpoint/latest/developerguide/permissions-streams.html)。

**设置事件流式传输**

1. 登录 AWS 管理控制台 并打开亚马逊 Pinpoint 控制台，网址为。[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. 在**所有项目**页面上，选择要为其设置数据流的项目。

1. 在导航窗格中的**设置**下，选择**事件流**。

1. 在**服务**部分，选择**编辑**。

1. 选择**流式传输到 Amazon Kinesis**。

1. 在**选择流类型**下，选择以下选项之一：
   + **将事件发送到 Amazon Kinesis 数据流** – 如果要将 Amazon Pinpoint 事件数据发送到外部应用程序进行分析，则选择此选项。
   + **将事件发送到 Amazon Data Firehose 流** — 如果您想将事件数据发送到 AWS 数据存储，例如亚马逊 Redshift，请选择此选项。

1. 对于 **Amazon Kinesis 流**，请选择要用于导出数据的 Amazon Kinesis 流。
**注意**  
[如果你尚未创建亚马逊 Kinesis 直播，请前往 /kinesis 的亚马逊 Kinesis 控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/kinesis)有关创建流的更多信息，请参阅[《Amazon Kinesis Data Streams 开发人员指南》](https://docs.aws.amazon.com/streams/latest/dev/)或[《Amazon Data Firehose 开发人员指南》](https://docs.aws.amazon.com/firehose/latest/dev/)。

1. 在 **IAM 角色**下，选择下列选项之一：
   + **使用现有角色** – 选择此选项以让 Amazon Pinpoint 代入已存在于您的账户中的 IAM 角色。您选择的角色必须允许 `firehose:PutRecordBatch` 操作。有关允许此操作的策略的示例，请参阅《Amazon Pinpoint 开发人员指南》中的[权限策略](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-streams.html#permissions-streams-permissionspolicies)**。
   + **自动创建角色** – 选择此选项以自动创建具有所需权限的 IAM 角色。此角色授权 Amazon Pinpoint 将数据发送到您在步骤 7 中选择的流。

1. 选择**保存**。

当 Amazon Pinpoint 收到您的项目的事件时，它会将这些数据发送到您的 Kinesis 流。有关 Amazon Pinpoint 为事件发送的数据的信息，请参阅《Amazon Pinpoint开发人员指南》中的[将 Amazon Pinpoint 事件流式传输到 Kinesis](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)。**