지원 종료 공지: 2026년 10월 30일에 AWS는 Amazon Pinpoint에 대한 지원을 종료합니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 Amazon Pinpoint 지원 종료를 참조하세요. 참고: SMS, 음성, 모바일 푸시, OTP, 전화번호 확인과 관련된 API는 이 변경의 영향을 받지 않으며, AWS End User Messaging에서 지원됩니다.
Amazon Pinpoint의 여정 이벤트 데이터
여정을 게시할 때 Amazon Pinpoint는 여정에서 보내는 이메일, SMS, 푸시 및 사용자 지정 메시지에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 데이터를 검색하여 볼 수 있도록 합니다. 이메일 및 SMS 메시지에 대해 Amazon Pinpoint에서 스트리밍하는 데이터에 대한 자세한 내용은 Amazon Pinpoint에서 이메일 이벤트 데이터 스트리밍 및 Amazon Pinpoint의 SMS 이벤트 데이터 스트림 섹션을 참조하세요. 이벤트 스트리밍 설정 방법에 대한 자세한 내용은 Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정 섹션을 참조하세요.
여정 이벤트 예제
여정 이벤트에 대한 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" }
여정 이벤트 속성
이 섹션은 Amazon Pinpoint에서 여정에 대해 생성하는 이벤트 스트림 데이터에 포함된 속성을 정의합니다.
| 속성 | 설명 |
|---|---|
event_type |
이벤트의 유형입니다. 여정 이벤트의 경우 이 속성의 값은 항상 |
event_timestamp |
이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). |
arrival_timestamp |
Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간). |
event_version |
이벤트 JSON 스키마의 버전입니다. 작은 정보스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다. |
application |
이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 애플리케이션 표를 참조하십시오. |
client |
이벤트와 연결된 엔드포인트에 대한 정보입니다. 자세한 내용은 클라이언트 표를 참조하십시오. |
device |
이벤트를 보고한 디바이스에 대한 정보입니다. 여정의 경우, 이 객체는 비어 있습니다. |
session |
이벤트를 생성한 세션에 대한 정보입니다. 여정의 경우, 이 객체는 비어 있습니다. |
attributes |
이벤트를 생성한 여정 및 여정 활동과 연결된 속성입니다. 자세한 내용은 속성 표를 참조하십시오. |
client_context |
custom 속성을 포함하는 endpoint 객체를 포함합니다. endpoint 속성에는 이벤트와 연결된 엔드포인트에 대한 엔드포인트 레코드의 콘텐츠가 포함됩니다. |
awsAccountId |
여정을 실행하는 데 사용된 AWS 계정의 ID입니다. |
Application
이벤트가 연결된 Amazon Pinpoint 프로젝트에 대한 정보를 포함합니다.
| 속성 | 설명 |
|---|---|
app_id |
이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다. |
sdk |
이벤트를 보고하는 데 사용된 SDK입니다. |
클라이언트
이벤트와 연결된 엔드포인트에 대한 정보를 포함합니다.
| 속성 | 설명 |
|---|---|
client_id |
엔드포인트의 ID입니다. |
속성
이벤트를 생성한 여정에 대한 정보를 포함합니다.
| 속성 | 설명 |
|---|---|
journey_run_id |
이벤트를 생성한 여정 실행의 고유 ID입니다. Amazon Pinpoint는 여정을 새로 실행할 때마다 이 ID를 생성하고 자동으로 할당합니다. |
journey_send_status |
이벤트와 연결된 메시지의 배달 상태를 나타냅니다. 가능한 값은 다음과 같습니다.
|
journey_id |
이벤트를 생성한 여정의 고유 ID입니다. |
journey_activity_id |
이벤트를 생성한 여정 활동의 고유 ID입니다. |
journey_activity_type |
이벤트의 여정 활동 유형입니다. 이는 EMAIL, SMS, PUSH, CONTACT_CENTER 또는 CUSTOM일 수 있습니다. 참고VOICE는 지원되는 여정 활동 유형이 아닙니다.
|
|
|
전송 이벤트의 상태에 대한 설명입니다. |
journey_send_status_code |
요청의 HTTP 상태 코드입니다. |