**终止支持通知：** 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-app"></a>

将应用程序与 Amazon Pinpoint 集成并设置事件流式传输后，Amazon Pinpoint 会从您在设置期间指定的目的地中检索应用程序的用户活动、自定义事件和消息送达数据供您查看。有关如何设置事件流式传输以便查看事件数据的信息，请参阅[设置 Amazon Pinpoint 以通过 Amazon Kinesis 或 Amazon Data Firehose 流式传输应用程序事件数据](event-streams-setup.md)。

## 应用程序事件示例
<a name="event-streams-data-app-example"></a>

应用程序事件的 JSON 对象包含以下示例中显示的数据。

```
{
  "event_type": "_session.stop",
  "event_timestamp": 1487973802507,
  "arrival_timestamp": 1487973803515,
  "event_version": "3.0",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "package_name": "main.page",
    "sdk": {
      "name": "aws-sdk-mobile-analytics-js",
      "version": "0.9.1:2.4.8"
    },
    "title": "title",
    "version_name": "1.0",
    "version_code": "1"
  },
  "client": {
    "client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
    "cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
  },
  "device": {
    "locale": {
      "code": "en_US",
      "country": "US",
      "language": "en"
    },
    "make": "generic web browser",
    "model": "Unknown",
    "platform": {
      "name": "android",
      "version": "10.10"
    }
  },
  "session": {
    "session_id": "f549dea9-1090-945d-c3d1-e4967example",
    "start_timestamp": 1487973202531,
    "stop_timestamp": 1487973802507
  },
  "attributes": {},
  "metrics": {}
}
```

## 应用程序事件属性
<a name="event-streams-data-app-attributes"></a>

本节定义了应用程序事件流的上一个示例中包含的属性。


| 属性 | 描述 | 
| --- | --- | 
| event\$1type |  事件类型。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/event-streams-data-app.html)  | 
| event\$1timestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| arrival\$1timestamp | Amazon Pinpoint 收到事件的时间，显示为以毫秒为单位的 Unix 时间。 | 
| event\$1version |  事件 JSON 架构的版本。  在事件处理应用程序中检查此版本，以便知道何时更新应用程序以响应架构更新。   | 
| application | 与事件关联的 Amazon Pinpoint 项目的相关信息。有关更多信息，请参阅[应用程序](#event-streams-data-app-attributes-application)表。 | 
| client | 报告事件的端点的相关信息。有关更多信息，请参阅[客户端](#event-streams-data-app-attributes-client)表。 | 
| device | 报告事件的设备的相关信息。有关更多信息，请参阅[设备](#event-streams-data-app-attributes-device)表。 | 
| session | 有关生成事件的会话的信息。有关更多信息，请参阅[会话](#event-streams-data-app-attributes-session)表。 | 
| attributes |  与事件关联的属性。对于您的应用程序报告的事件，此对象包含您定义的自定义属性。  | 
| metrics | 与事件相关的指标。您可以选择配置应用程序将自定义指标发送到 Amazon Pinpoint。 | 

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

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


| 属性 | 描述 | 
| --- | --- | 
| app\$1id |  报告事件的 Amazon Pinpoint 项目的唯一 ID。  | 
| cognito\$1identity\$1pool\$1id |  与端点关联的 Amazon Cognito 身份池的 ID。  | 
| package\$1name |  应用程序包的名称，例如 `com.example.my_app`。  | 
| sdk |  用于报告事件的开发工具包的相关信息。有关更多信息，请参阅[开发工具包](#event-streams-data-app-attributes-application-sdk)表。  | 
| title |  应用程序的名称。  | 
| version\$1name |  应用程序的版本名称，例如 `V2.5`。  | 
| version\$1code |  应用程序的版本号，例如 `3`。  | 

#### SDK
<a name="event-streams-data-app-attributes-application-sdk"></a>

包括用于报告事件的开发工具包的相关信息。


| 属性 | 描述 | 
| --- | --- | 
| name | 用于报告事件的开发工具包的名称。 | 
| version | 开发工具包的版本。 | 

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

包括有关生成事件的端点的信息。


| 属性 | 描述 | 
| --- | --- | 
| client\$1id | 端点的 ID。 | 
| cognito\$1id | 与端点关联的 Amazon Cognito ID 令牌。 | 

### 设备
<a name="event-streams-data-app-attributes-device"></a>

包括有关生成事件的端点设备的信息。


| 属性 | 描述 | 
| --- | --- | 
| locale |  包含有关端点设备的语言和区域设置的信息。有关更多信息，请参阅[区域设置](#event-streams-data-app-attributes-device-locale)表。  | 
| make | 端点设备的制造商。 | 
| model | 端点设备的型号标识符。 | 
| platform |  有关端点设备上操作系统的信息。有关更多信息，请参阅[平台](#event-streams-data-app-attributes-device-platform)表。  | 

#### Locale
<a name="event-streams-data-app-attributes-device-locale"></a>

包含有关端点设备的语言和区域设置的信息。


| 属性 | 描述 | 
| --- | --- | 
| code | 与设备关联的区域设置标识符。 | 
| country | 与设备区域设置关联的国家或地区。 | 
| language | 与设备区域设置关联的语言。 | 

#### 平台
<a name="event-streams-data-app-attributes-device-platform"></a>

包含有关端点设备上操作系统的信息。


| 属性 | 描述 | 
| --- | --- | 
| name | 设备上操作系统的名称。 | 
| version | 设备上操作系统的版本。 | 

### Session
<a name="event-streams-data-app-attributes-session"></a>

包括有关生成事件的会话的信息。


| 属性 | 描述 | 
| --- | --- | 
| session\$1id | 标识会话的唯一 ID。 | 
| start\$1timestamp | 会话开始的日期和时间，显示为以毫秒为单位的 Unix 时间。 | 
| stop\$1timestamp | 会话结束的日期和时间，显示为以毫秒为单位的 Unix 时间。 |