**지원 종료 공지:** 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\_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 | endpoint 속성을 포함하는 custom 객체를 포함합니다. endpoint 속성에는 이벤트와 연결된 엔드포인트에 대한 엔드포인트 레코드의 콘텐츠가 포함됩니다. | 
| awsAccountId | 여정을 실행하는 데 사용된 AWS 계정의 ID입니다. | 

### 애플리케이션
<a name="event-streams-data-journey-attributes-application"></a>

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


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

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

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


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

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

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


| 속성 | 설명 | 
| --- | --- | 
| journey\_run\_id | 이벤트를 생성한 여정 실행의 고유 ID입니다. Amazon Pinpoint는 여정을 새로 실행할 때마다 이 ID를 생성하고 자동으로 할당합니다. | 
| journey\_send\_status | 이벤트와 연결된 메시지의 배달 상태를 나타냅니다. 가능한 값은 다음과 같습니다.+  **SUCCESS** – 메시지가 엔드포인트로 전송되었습니다. <br />+  **FAILURE** – 오류가 발생하여 엔드포인트에 메시지가 전송되지 않았습니다. <br />+  **CUSTOM\_DELIVERY\_FAILURE** – 사용자 지정 배달이 실패했습니다. <br />+  **FAILURE\_PERMANENT** – 엔드포인트로 전송하는 동안 영구적인 오류가 발생했습니다.  **FAILURE\_PERMANENT** 상태의 이벤트를 필터링하고 `journey_send_status_code`를 403으로 설정하여 액세스 정책 및 역할 위반이 있는지 확인할 수 있습니다. 음성을 사용하는 아웃바운드 캠페인의 경우 이러한 예외는 Amazon Pinpoint 여정을 Connect Customer 캠페인으로 바인딩하는 연결 캠페인 실행 역할이 진행 중인 여정 실행을 위해 실수로 삭제되는 인스턴스에 일반적으로 적용됩니다.  <br />+  **THROTTLED** – 전송이 조절되었습니다. <br />+  **UNSUPPORTED\_CHANNEL** – 채널이 지원되지 않습니다. <br />+  **DAILY\_CAP** – 메시지를 보내면 24시간 동안 여정 또는 프로젝트가 단일 엔드포인트로 보낼 수 있는 최대 메시지 수를 초과하기 때문에 엔드포인트로 메시지가 전송되지 않았습니다. <br />+  **QUIET\_TIME** – 여정 또는 프로젝트의 대기 시간 제한으로 인해 메시지가 전송되지 않았습니다. <br />+  **QUIET\_TIME\_MISSING\_TIMEZONE** – 추정으로 엔드포인트의 시간대를 추정할 수 없고 전송 중단 시간이 활성화되어 있기 때문에 메시지가 전송되지 않았습니다.  | 
| 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 상태 코드입니다. |