**지원 종료 공지:** 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에서 이메일 이벤트 데이터 스트리밍 Amazon Pinpoint를 사용하여 이메일을 보내는 경우 Amazon Pinpoint는 해당 이메일에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 이벤트 데이터를 검색하여 볼 수 있도록 합니다. 이벤트 스트리밍 설정 방법에 대한 자세한 내용은 [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](event-streams-setup.md) 섹션을 참조하세요. Amazon Pinpoint는 이메일 메시지에 대해 다음 유형의 이벤트에 대한 데이터를 스트리밍합니다. + 전송 + 배달 + 반송 메일 + 수신 거부 + 열기 + 클릭 + 거부 + 구독 해지 + 렌더링 오류 이러한 이벤트 유형은 [이메일 이벤트 속성](#event-streams-data-email-attributes)에 자세히 설명되어 있습니다. 이메일 메시지를 전송하는 데 사용하는 API 및 설정에 따라 추가 이벤트 유형이나 다른 데이터가 표시될 수 있습니다. 예를 들어 Amazon Simple Email Service(Amazon SES)에서 제공하는 것과 같이 이벤트 데이터를 Amazon Kinesis에 게시하는 구성 세트를 사용하여 메시지를 전송하는 경우, 데이터에는 템플릿 렌더링 실패에 대한 이벤트도 포함될 수 있습니다. 이러한 데이터에 대한 자세한 내용은 *Amazon Simple Email Service 개발자 안내서*의 [Amazon SES 이벤트 게시를 사용하여 모니터링](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) 섹션을 참조하세요. 이벤트를 보려면 먼저 이벤트 스트리밍을 설정해야 합니다. [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](event-streams-setup.md) 섹션을 참조하세요. 이벤트 스트리밍을 설정할 때 이벤트 데이터를 저장할 대상을 지정한 다음 대상을 사용하여 볼 이벤트 데이터를 검색할 수 있습니다. ## 이메일 이벤트 예제 **이메일 전송** *이메일 전송* 이벤트에 대한 JSON 객체에는 다음 예제의 데이터가 포함되어 있습니다. ``` { "event_type": "_email.send", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622025, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "received" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "send": {} } } } } ``` **이메일 배달됨** *이메일 배달됨* 이벤트에 대한 JSON 객체에는 다음 예제의 데이터가 포함되어 있습니다. ``` { "event_type": "_email.delivered", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622690, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "delivered" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "delivery": { "smtp_response": "250 ok: Message 82080542 accepted", "reporting_mta": "a8-53.smtp-out.amazonses.com", "recipients": ["recipient@example.com"], "processing_time_millis": 1310 } } } } } ``` **이메일 클릭** *이메일 클릭* 이벤트에 대한 JSON 객체에는 다음 예제의 데이터가 포함되어 있습니다. ``` { "event_type": "_email.click", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618713751, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "https://aws.amazon.com/pinpoint/" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "click": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15", "link": "https://aws.amazon.com/pinpoint/" } } } } } ``` **이메일 열기** *이메일 열기* 이벤트에 대한 JSON 객체에는 다음 예제의 데이터가 포함되어 있습니다. ``` { "event_type": "_email.open", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618712316, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "opened" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "open": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)" } } } } } ``` ## 이메일 이벤트 속성 이 섹션에서는 이메일 메시지를 보낼 때 Amazon Pinpoint에서 생성하는 이벤트 스트림 데이터의 이전 예제에 포함된 속성을 정의합니다. | 속성 | 설명 | | --- | --- | | event\$1type | 이벤트의 유형입니다. 가능한 값은 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-email.html) | | event\$1timestamp | 메시지가 전송된 시간입니다(밀리초 단위 Unix 시간). 이 값은 일반적으로 메시지에 대해 생성되는 모든 이벤트에 동일합니다. | | arrival\$1timestamp | Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간). | | event\$1version | 이벤트 JSON 스키마의 버전입니다. 스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다. | | application | 이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 *애플리케이션* 표를 참조하십시오. | | client | 이벤트를 보고한 디바이스에 설치된 앱 클라이언트에 대한 정보입니다. 자세한 내용은 *클라이언트* 표를 참조하십시오. | | device | 이벤트를 보고한 디바이스에 대한 정보입니다. 자세한 내용은 *디바이스* 표를 참조하십시오. 이메일 이벤트의 경우 이 객체가 비어 있습니다. | | session | 이메일 이벤트의 경우 이 객체가 비어 있습니다. | | attributes | 이벤트와 연결된 속성입니다. 자세한 내용은 *속성* 표를 참조하십시오. 앱 중 하나에서 보고한 이벤트의 경우 이 객체에는 앱에서 정의한 사용자 지정 속성이 포함될 수 있습니다. 캠페인이나 여정에서 메시지를 전송할 때 생성되는 이벤트의 경우, 이 객체에는 캠페인이나 여정과 연결된 속성이 포함됩니다. 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 객체에는 메시지 자체와 관련된 정보가 포함됩니다. | | client\$1context | 이메일 이벤트의 경우 이 객체에는 custom 객체(legacy\$1identifier 속성 포함)가 포함됩니다. legacy\$1identifier 속성 값은 메시지가 전송된 프로젝트의 ID입니다. | | facets | 메시지에 대한 추가 정보입니다(예: 이메일 헤더). 자세한 내용은 *패싯* 표를 참조하십시오. | | awsAccountId | 메시지를 전송하는 데 사용된 AWS 계정의 ID입니다. | ### Application 이벤트가 연결된 Amazon Pinpoint 프로젝트에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | app\$1id | 이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다. | | sdk | 이벤트를 보고하는 데 사용된 SDK입니다. Amazon Pinpoint API를 직접 호출하거나 Amazon Pinpoint 콘솔을 사용하여 트랜잭션 이메일 메시지를 전송하는 경우 이 객체는 비어 있습니다. | ### 속성 이벤트를 생성한 캠페인 또는 여정에 대한 정보를 포함합니다. #### Campaign 이벤트를 생성한 캠페인에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | feedback | `_email.click` 이벤트의 경우 이 속성의 값은 수신자가 이벤트를 생성하기 위해 메시지에서 클릭한 링크의 URL입니다. 다른 이벤트의 경우 이 값은 이벤트 유형을 나타냅니다(예:`received`, `opened` 또는 `clicked`). | | treatment\$1id | A/B 테스트 캠페인을 사용하여 메시지를 전송한 경우 이 값은 메시지의 처리 번호를 나타냅니다. 표준 캠페인 및 트랜잭션 이메일 메시지의 경우 이 값은 `0`입니다. | | campaign\$1activity\$1id | 이벤트가 발생할 때 Amazon Pinpoint에서 생성하는 고유 ID입니다. | | campaign\$1id | 메시지를 전송한 캠페인의 고유 ID입니다. | #### 여정 이벤트를 생성한 여정에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | journey\$1run\$1id | 메시지를 보낸 여정 실행의 고유 ID입니다. Amazon Pinpoint는 여정을 새로 실행할 때마다 이 ID를 생성하고 자동으로 할당합니다. | | feedback | `_email.click` 이벤트의 경우 이 속성의 값은 수신자가 이벤트를 생성하기 위해 메시지에서 클릭한 링크의 URL입니다. 다른 이벤트의 경우 이 값은 이벤트 유형을 나타냅니다(예:`received`, `delivered` 또는 `opened`). | | journey\$1id | 메시지를 보낸 여정의 고유 ID입니다. | | journey\$1activity\$1id | 메시지를 보낸 여정 활동의 고유 ID입니다. | ### 클라이언트 캠페인 또는 여정의 대상이 된 고객의 고유 식별자입니다. | 속성 | 설명 | | --- | --- | | client\$1id | 클라이언트의 ID입니다. 값은 캠페인 및 여정의 경우에는 엔드포인트 ID이고, 트랜잭션 전송의 경우에는 UUID입니다. | ### 패싯 메시지 및 이벤트 유형에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | email\$1channel | `mail_event` 객체를 포함하며, 여기에는 두 개의 객체 즉, `mail` 및 이벤트 유형에 해당하는 객체가 포함됩니다. | ### Mail 이메일 메시지의 콘텐츠에 대한 정보와 메시지에 대한 메타데이터를 포함합니다. | 속성 | 설명 | | --- | --- | | message\$1id | 메시지의 고유 ID입니다. Amazon Pinpoint는 메시지를 수락할 때 이 ID를 자동으로 생성합니다. | | message\$1send\$1timestamp | [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)에 지정된 형식으로 메시지가 전송된 날짜 및 시간입니다. | | from\$1address | 메시지를 전송한 이메일 주소입니다. | | destination | 메시지를 전송한 이메일 주소가 포함된 배열입니다. | | headers\$1truncated | 이메일 헤더가 잘렸는지 여부를 나타내는 Boolean 값입니다. | | headers | 메시지 헤더에 해당하는 여러 이름-값 쌍을 포함하는 객체입니다. 이 객체는 일반적으로 다음 헤더에 대한 정보를 포함합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-email.html) | | common\$1headers | 이메일 메시지의 몇 가지 일반적인 헤더에 대한 정보가 들어 있습니다. 이 정보는 메시지가 전송된 날짜, 메시지 받는 사람, 보낸 사람 및 제목 줄이 포함될 수 있습니다. |