**支援結束通知：**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 的旅程事件資料
<a name="event-streams-data-journey"></a>

當您發佈旅程時，Amazon Pinpoint 可以串流您從旅程傳送的電子郵件、簡訊、推送和自訂訊息的事件資料。設定事件串流後，Amazon Pinpoint 會從您在設定期間指定的目的地擷取資料，供您檢視。如需 Amazon Pinpoint 為電子郵件和簡訊串流之資料的詳細資訊，請參閱 [從 Amazon Pinpoint 傳送電子郵件事件資料串流](event-streams-data-email.md)和 [來自 Amazon Pinpoint 的簡訊事件資料串流](event-streams-data-sms.md)。如需如何設定事件串流的資訊，請參閱 [設定 Amazon Pinpoint 透過 Amazon Kinesis 或 Amazon Data Firehose 串流應用程式事件資料](event-streams-setup.md)。

## 旅程事件範例
<a name="event-streams-data-journey-example"></a>

旅程事件的 JSON 物件包含以下範例中顯示的資料。

```
{
   "event_type":"_journey.send",
   "event_timestamp":1572989078843,
   "arrival_timestamp":1572989078843,
   "event_version":"3.1",
   "application":{
      "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "sdk":{

      }
   },
   "client":{
      "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample"
   },
   "device":{
      "platform":{

      }
   },
   "session":{

   },
   "attributes":{
      "journey_run_id":"edc9a0b577164d1daf72ebd15example",
      "journey_send_status":"SUCCESS",
      "journey_id":"546401670c5547b08811ac6a9example",
      "journey_activity_id":"0yKexample",
      "journey_activity_type": "EMAIL",
      "journey_send_status_message": "200", 
      "journey_send_status_code": "200"
   },
   "client_context":{
      "custom":{
         "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}"
      }
   },
   "awsAccountId":"123456789012"
}
```

## 旅程事件屬性
<a name="event-streams-data-journey-attributes"></a>

本節針對 Amazon Pinpoint 為旅程產生的事件串流資料所包含的屬性給予定義。


| 屬性 | 描述 | 
| --- | --- | 
| event\_type | 事件的類型。若是旅程事件，此屬性的值一律為 `_journey.send`，表示 Amazon Pinpoint 已執行旅程。 | 
| event\_timestamp | 報告事件的時間，以 Unix 時間顯示 (毫秒)。 | 
| arrival\_timestamp | Amazon Pinpoint 收到事件的時間，顯示為 Unix 時間 (以毫秒為單位)。 | 
| event\_version | 事件 JSON 結構描述的版本。 在您的事件處理應用程式中檢查此版本，讓您知道何時更新應用程式以回應結構描述更新。  | 
| application | 與事件相關聯的 Amazon Pinpoint 專案的資訊。如需詳細資訊，請參閱[應用程式](#event-streams-data-journey-attributes-application)表。 | 
| client | 與事件相關聯的端點相關資訊。如需詳細資訊，請參閱[用戶端](#event-streams-data-journey-attributes-client)表。 | 
| device | 回報事件的裝置資訊。如為旅程，此物件為空。 | 
| session | 產生事件的工作階段資訊。如為旅程，此物件為空。 | 
| attributes | 與產生事件的旅程和旅程活動相關聯的屬性。如需詳細資訊，請參閱[屬性](#event-streams-data-journey-attributes-attrs)表。 | 
| client\_context | 包含一個 custom 物件，其中包含一個 endpoint 屬性。endpoint 屬性包含與事件相關聯的端點記錄內容。 | 
| awsAccountId | 用來執行旅程 AWS 的帳戶 ID。 | 

### 應用程式
<a name="event-streams-data-journey-attributes-application"></a>

包含與事件相關聯的 Amazon Pinpoint 專案的資訊。


| 屬性 | 描述 | 
| --- | --- | 
| app\_id | 回報事件的 Amazon Pinpoint 專案的唯一 ID。 | 
| sdk | 過去用來報告事件的開發套件。 | 

### 用戶端
<a name="event-streams-data-journey-attributes-client"></a>

包含事件相關聯的端點相關資訊。


| 屬性 | 描述 | 
| --- | --- | 
| client\_id | 端點的 ID。 | 

### Attributes
<a name="event-streams-data-journey-attributes-attrs"></a>

包含產生事件的旅程相關資訊。


| 屬性 | 描述 | 
| --- | --- | 
| journey\_run\_id | 產生事件的旅程執行的唯一 ID。Amazon Pinpoint 會自動產生這個 ID，並指派給每個新的旅程執行。 | 
| journey\_send\_status | 表示與事件相關聯的訊息交付狀態。可能的值包括：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/developerguide/event-streams-data-journey.html) | 
| journey\_id | 產生事件的旅程唯一 ID。 | 
| journey\_activity\_id | 產生事件的旅程活動唯一 ID。 | 
| journey\_activity\_type | 事件的旅程活動類型。這可以是 **EMAIL**、**SMS**、**PUSH**、**CONTACT\_CENTER** 或 **CUSTOM**。 **VOICE** 不是支援的旅程活動類型。 <br />當 `journey_send_status`設定為 **QUIET\_TIME\_WAIT\_FINISHED** 時， `journey_activity_type` 欄位不存在。  | 
| `journey_send_status_message` | 傳送事件的狀態描述。 | 
| journey\_send\_status\_code | 請求的 HTTP 狀態碼。 |