**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 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-app"></a>

애플리케이션(앱)을 Amazon Pinpoint와 통합하고 이벤트 스트리밍을 설정하면 Amazon Pinpoint는 설정 중에 지정한 대상에서 앱의 사용자 활동, 사용자 지정 이벤트 및 메시지 전송 데이터를 검색하여 볼 수 있도록 합니다. 이벤트 데이터를 볼 수 있도록 이벤트 스트리밍을 설정하는 방법에 대한 자세한 내용은 [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](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/ko_kr/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로 사용자 지정 지표를 보내도록 앱을 구성할 수 있습니다. | 

### Application
<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 |  이벤트를 보고하는 데 사용된 SDK에 대한 정보입니다. 자세한 내용은 [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>

이벤트를 보고하는 데 사용된 SDK에 대한 정보를 포함합니다.


| 속성 | 설명 | 
| --- | --- | 
| name | 이벤트를 보고하는 데 사용된 SDK의 이름입니다. | 
| version | SDK의 버전입니다. | 

### 클라이언트
<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 | 디바이스의 운영 체제 버전입니다. | 

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

이벤트를 생성한 세션에 대한 정보를 포함합니다.


| 속성 | 설명 | 
| --- | --- | 
| session\$1id | 세션을 식별하는 고유 ID입니다. | 
| start\$1timestamp | 세션이 시작된 날짜 및 시간입니다(밀리초 단위 Unix 시간). | 
| stop\$1timestamp | 세션이 종료된 날짜 및 시간입니다(밀리초 단위 Unix 시간). |