**支援結束通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 透過 Amazon Pinpoint 串流事件
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 產生的行銷活動，例如行銷活動訊息目的地的裝置數。
Amazon Pinpoint 會保留資料 90 天。若要無限期保留此資料，或是使用自訂查詢和工具分析此資料，您可以設定 Amazon Pinpoint 將事件資料傳送到 Amazon Kinesis。
**Topics**
+ [關於 Amazon Kinesis](#analytics-streaming-about-kinesis)
+ [串流 Amazon Pinpoint 事件到 Kinesis](#analytics-streaming-kinesis)
## 關於 Amazon Kinesis
Kinesis 平台的服務，可讓您在 AWS上載入並分析串流資料。您可以設定 Amazon Pinpoint 將應用程式、行銷活動和旅程事件傳送至 Amazon Kinesis Data Streams 或 Amazon Data Firehose。透過串流您的事件，您可以為資料分析啟用更靈活的選項，例如：
+ 將來自多個應用程式的事件轉換為一個串流，使得您可以以集合形式分析此資料。
+ 使用 AWS 查詢服務分析事件。例如您可以使用 Amazon Managed Service for Apache Flink 對串流資料執行 SQL 查詢。
### 關於 Amazon Kinesis Data Streams
Amazon Kinesis Data Streams 這項服務可讓您建置自訂應用程式，以處理或分析您的串流資料。假設您要在自訂儀表板中使用事件資料、根據事件產生警示或動態回應事件，將事件串流傳輸到 Kinesis Data Streams 將很有用。
如需詳細資訊，請參閱《[Amazon Kinesis Data Streams 開發人員指南](https://docs.aws.amazon.com/streams/latest/dev/)》。
### 關於 Amazon Data Firehose
Amazon Data Firehose 是一項服務，可用來將串流資料交付至 AWS 資料存放區，包括 Amazon Simple Storage Service (Amazon S3)、Amazon Redshift 或 Amazon OpenSearch Service (OpenSearch Service)。例如，如果您想要：
+ 使用自己的分析應用程式和工具，分析 Amazon S3、Amazon Redshift 或 OpenSearch Service 中的事件。
+ 將您的事件傳送至 Amazon S3，就能使用 Amazon Athena 對此資料編寫 SQL 查詢。
+ 在 Amazon S3 中備份您的事件資料供長期儲存。
如需詳細資訊，請參閱 [Amazon Data Firehose 開發人員指南](https://docs.aws.amazon.com/firehose/latest/dev/)。
## 串流 Amazon Pinpoint 事件到 Kinesis
Kinesis 平台的服務，可讓您在 AWS上載入並分析串流資料。您可以設定 Amazon Pinpoint 將應用程式、行銷活動和旅程事件傳送到 Amazon Kinesis Data Streams，讓外部應用程式或第三方分析工具處理。您也可以設定 Amazon Pinpoint，使用 Amazon Data Firehose 將此事件資料串流至 AWS 資料存放區 （例如 Amazon Redshift)。
### 先決條件
在完成本節中的程序之前，請在您使用 Amazon Pinpoint 的相同帳戶中建立 Amazon Kinesis 串流或 Firehose 交付串流。 Amazon Pinpoint 若要進一步了解如何建立 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)。
### 設定事件串流
在 Amazon Pinpoint 中完成以下步驟，設定事件串流。
**注意**
如果您尚未建立 Amazon Kinesis 串流，請前往 Amazon Kinesis 主控台：[https://console.aws.amazon.com/kinesis](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 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 的 Amazon Pinpoint 主控台。
1. 在**所有專案**頁面上，選擇要設定資料串流的專案。
1. 在導覽面板的**設定**下，選擇**事件串流**。
1. 在**服務**部分中，選擇**編輯**。
1. 選擇**串流到 Amazon Kinesis**。
1. 在**選擇串流類型**下，選擇以下其中一個選項：
+ **傳送事件到 Amazon Kinesis Data Stream** – 如果您要將 Amazon Pinpoint 事件資料傳送到外部應用程式分析，請選擇此選項。
+ **將事件傳送至 Amazon Data Firehose 串流** – 如果您想要將事件資料傳送至 AWS 資料存放區，例如 Amazon Redshift，請選擇此選項。
1. 在 **Amazon Kinesis 串流**中，選擇要用來匯出資料的 Amazon Kinesis 串流。
**注意**
如果您尚未建立 Amazon Kinesis 串流，請前往 Amazon Kinesis 主控台：[https://console.aws.amazon.com/kinesis](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)。