**终止支持通知：** 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="event-streams-data-campaign"></a>

如果您使用 Amazon Pinpoint 通过一个渠道发送活动，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-campaign-example"></a>

活动事件的 JSON 对象包含以下示例显示的数据。

```
{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}
```

## 活动事件属性
<a name="event-streams-data-campaign-attributes"></a>

此部分定义活动事件流中包含的属性。


| 属性 | 说明 | 
| --- | --- | 
| event\_type | 事件类型。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/event-streams-data-campaign.html) | 
| event\_timestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| arrival\_timestamp | Amazon Pinpoint 收到事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| event\_version | 事件 JSON 架构的版本。 在事件处理应用程序中检查此版本，以便知道何时更新应用程序以响应架构更新。  | 
| application | 与事件关联的 Amazon Pinpoint 项目的相关信息。有关更多信息，请参阅[应用程序](#event-streams-data-campaign-attributes-application)表。 | 
| client | 与事件关联的端点的相关信息。有关更多信息，请参阅[客户端](#event-streams-data-campaign-attributes-client) 表。 | 
| device | 报告事件的设备的相关信息。对于活动和事务性消息，此对象为空。 | 
| session | 有关生成事件的会话的信息。对于活动，此对象为空。 | 
| attributes | 与事件关联的属性。对于您的应用程序之一报告的事件，此对象包含由应用程序定义的自定义属性。对于在您发送活动时创建的事件，此对象包含与活动关联的属性。对于在您发送事务性电子邮件时生成的事件，此对象包含与电子邮件本身相关的信息。<br />有关更多信息，请参阅[属性](#event-streams-data-campaign-attributes-attrs)表。 | 
| client\_context | 包含一个 custom 对象，其中包含一个 endpoint 属性。endpoint 属性包含将活动发送到的端点的端点记录内容。 | 
| awsAccountId | 用于发送消息的 AWS 账户的 ID。 | 

### 应用程序
<a name="event-streams-data-campaign-attributes-application"></a>

包括与事件关联的 Amazon Pinpoint 项目的相关信息。


| 属性 | 说明 | 
| --- | --- | 
| app\_id | 报告事件的 Amazon Pinpoint 项目的唯一 ID。 | 
| sdk | 用于报告该事件的开发工具包。 | 

### 属性
<a name="event-streams-data-campaign-attributes-attrs"></a>

包含有关生成事件的活动的信息。


| 属性 | 说明 | 
| --- | --- | 
| treatment\_id | 如果消息是使用 A/B 测试活动发送的，则此值表示消息的处理编号。对于标准活动，此值为 `0`。 | 
| campaign\_activity\_id | 发生事件时 Amazon Pinpoint 生成的唯一 ID。 | 
| delivery\_type | 活动的交付方式。不要将此属性与 `client_context` 的 `endpoint` 属性下指定的 `ChannelType` 字段混淆。该 `ChannelType` 字段通常基于消息发送到的端点。<br />对于仅支持一种端点类型的渠道，`delivery_type` 和 `ChannelType` 字段的值相同。例如，对于电子邮件渠道，`delivery_type` 和 `ChannelType` 字段的值与 EMAIL 相同。<br />但是，对于支持不同端点类型的渠道（例如自定义渠道），情况并不总是如此。您可以为不同的端点使用自定义渠道，例如 EMAIL、SMS、CUSTOM 等。在这种情况下，`delivery_type` 标识自定义投放事件 CUSTOM，`ChannelType` 指定活动发送到的端点类型，例如 EMAIL、SMS、CUSTOM 等。有关创建自定义渠道的更多信息，请参阅[使用 Webhook 或 Lambda 函数在 Amazon Pinpoint 中创建自定义渠道](channels-custom.md)。<br />可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/event-streams-data-campaign.html) | 
| campaign\_id | 发送消息的活动的唯一 ID。 | 
| campaign\_send\_status | 指示目标端点的活动的状态。可能的值包括：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

### 客户端
<a name="event-streams-data-campaign-attributes-client"></a>

包括活动所定向到的端点的相关信息。


| 属性 | 说明 | 
| --- | --- | 
| client\_id | 活动发送到的端点的 ID。 |