**지원 종료 공지:** 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-journey"></a>

여정을 게시할 때 Amazon Pinpoint는 여정에서 보내는 이메일, SMS, 푸시 및 사용자 지정 메시지에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 데이터를 검색하여 볼 수 있도록 합니다. 이메일 및 SMS 메시지에 대해 Amazon Pinpoint에서 스트리밍하는 데이터에 대한 자세한 내용은 [Amazon Pinpoint에서 이메일 이벤트 데이터 스트리밍](event-streams-data-email.md) 및 [Amazon Pinpoint의 SMS 이벤트 데이터 스트림](event-streams-data-sms.md) 섹션을 참조하세요. 이벤트 스트리밍 설정 방법에 대한 자세한 내용은 [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](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\$1type |  이벤트의 유형입니다. 여정 이벤트의 경우 이 속성의 값은 항상 `_journey.send`이며, Amazon Pinpoint가 여정을 실행했음을 나타냅니다.  | 
| event\$1timestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | 
| arrival\$1timestamp | Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| event\$1version |  이벤트 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\$1context | custom 속성을 포함하는 endpoint 객체를 포함합니다. endpoint 속성에는 이벤트와 연결된 엔드포인트에 대한 엔드포인트 레코드의 콘텐츠가 포함됩니다. | 
| awsAccountId |  여정을 실행하는 데 사용된 AWS 계정의 ID입니다.  | 

### Application
<a name="event-streams-data-journey-attributes-application"></a>

이벤트가 연결된 Amazon Pinpoint 프로젝트에 대한 정보를 포함합니다.


| 속성 | 설명 | 
| --- | --- | 
| app\$1id |  이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다.  | 
| sdk |  이벤트를 보고하는 데 사용된 SDK입니다.  | 

### 클라이언트
<a name="event-streams-data-journey-attributes-client"></a>

이벤트와 연결된 엔드포인트에 대한 정보를 포함합니다.


| 속성 | 설명 | 
| --- | --- | 
| client\$1id | 엔드포인트의 ID입니다. | 

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

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


| 속성 | 설명 | 
| --- | --- | 
| journey\$1run\$1id |  이벤트를 생성한 여정 실행의 고유 ID입니다. Amazon Pinpoint는 여정을 새로 실행할 때마다 이 ID를 생성하고 자동으로 할당합니다.  | 
| journey\$1send\$1status |  이벤트와 연결된 메시지의 배달 상태를 나타냅니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-journey.html)  | 
| journey\$1id |  이벤트를 생성한 여정의 고유 ID입니다.  | 
| journey\$1activity\$1id |  이벤트를 생성한 여정 활동의 고유 ID입니다.  | 
| journey\$1activity\$1type |  이벤트의 여정 활동 유형입니다. 이는 **EMAIL**, **SMS**, **PUSH**, **CONTACT\$1CENTER** 또는 **CUSTOM**일 수 있습니다.  **VOICE**는 지원되는 여정 활동 유형이 아닙니다. `journey_send_status`가 **QUIET\$1TIME\$1WAIT\$1FINISHED**로 설정된 경우 `journey_activity_type` 필드가 존재하지 않습니다.   | 
|  `journey_send_status_message`  | 전송 이벤트의 상태에 대한 설명입니다. | 
| journey\$1send\$1status\$1code | 요청의 HTTP 상태 코드입니다. |