기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon SES 이벤트 게시를 사용하여 이메일 전송 모니터링 이메일 전송을 세부적으로 추적하기 위해 정의한 특성에 따라 Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service 또는 Amazon EventBridge에 *이메일 전송 이벤트*를 게시할 수 있도록 Amazon SES를 설정할 수 있습니다. 발신, 전송, 열기, 클릭, 반송, 수신 거부, 거부, 렌더링 실패 및 전송 지연을 포함하는 다양한 이메일 전송 이벤트 유형을 추적할 수 있습니다. 이 정보는 운영 및 분석에 유용할 수 있습니다. 예를 들어 이메일 전송 데이터를 CloudWatch에 게시하고 이메일 캠페인의 성과를 추적하는 대시보드를 만들거나 Amazon SNS를 사용해 특정 이벤트가 발생할 때 알림을 전송할 수 있습니다. ## 이벤트 게시가 구성 세트 및 메시지 태그와 작동하는 방법 이벤트 게시를 사용하려면 우선 하나 이상의 *구성 세트*를 설정해야 합니다. 구성 세트는 어떤 이벤트를 어디에 게시할지 지정합니다. 그런 다음 이메일을 보낼 때마다 구성 세트의 이름과 하나 이상의 *메시지 태그*를 이름/값 페어 형식으로 제공하여 이메일을 분류합니다. 예를 들어 책을 광고하는 경우, 메시지 태그에 *genre*라는 이름을 붙이고 *sci-fi* 또는 *western* 값을 할당할 수 있습니다. 사용 중인 이메일 전송 인터페이스에 따라 메시지 태그를 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) API 작업 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) 필드에 파라미터로 제공하거나 SES별 이메일 헤더 [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers)에 메시지 태그를 추가합니다. 구성 세트에 대한 자세한 내용은 [Amazon SES에서 구성 세트 사용](using-configuration-sets.md) 단원을 참조하세요. SES는 지정하는 메시지 태그 외에도 전송 메시지에 *자동 태그*도 추가합니다. 자동 태그를 사용하기 위해 추가로 실행해야 할 단계도 없습니다. 다음 테이블은 SES를 사용하여 전송하는 메시지에 자동으로 적용되는 자동 태그를 나열한 것입니다. **SES 자동 태그** | 자동 태그 이름 | 설명 | | --- | --- | | ses:caller-identity | 이메일을 전송한 SES 사용자의 IAM ID입니다. | | ses:configuration-set | 이메일에 연결된 구성 세트의 이름 | | ses:from-domain | "From" 주소의 도메인 | | ses:outgoing-ip | SES가 이메일 전송에 사용한 IP 주소입니다. | | ses:source-ip | 호출자가 이메일 전송에 사용한 IP 주소. | | ses:source-tls-version | 발신자가 이메일을 보내는 데 사용한 TLS 프로토콜 버전입니다. | | ses:outgoing-tls-version | SES가 이메일 전송에 사용한 TLS 프로토콜 버전입니다. | ## 이메일 캠페인에 대한 세분화된 피드백 `ses:feedback-id-<{{a}} or {{b}}>` 태그는 하이브리드 또는 반자동 태그로 생각할 수 있는 선택적 메시지 태그입니다. 이전 섹션에서 다룬 자동 태그와 비슷하지만, 차이점은 수동으로 추가하고 `ses:` 접두사 키를 사용해야 한다는 것입니다. `ses:feedback-id-a` 및 `ses:feedback-id-b`로 정의된 이러한 태그 중 최대 2개를 사용할 수 있습니다. 이러한 태그를 지정하면 SES는 피드백 루프(FBL)의 일부로 수신 거부, 스팸 비율 등의 전송 통계를 제공하는 데 사용되는 표준 `Feedback-ID` 헤더에 태그를 자동으로 추가합니다. [피드백 루프](faqs-enforcement.md#cm-feedback-loop)의 내용을 참조하세요. `Feedback-ID` 헤더는 SES에서 수신 거부 정보 수집에 사용하는 *SESInternalID* 식별자와 SES를 다음과 같은 전송 플랫폼으로 식별하는 *AmazonSES* 정적 태그로 구성됩니다. `FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))` 이러한 선택적 피드백 ID 태그는 이메일 캠페인의 일부로 보내는 메시지와 같이 세분화된 피드백을 생성하는 방법으로 제공됩니다. 다음 예제와 같이 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) 작업 요청의 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) 필드에 메시지 태그로 지정하여 `ses:feedback-id-<{{a}} or {{b}}>`를 사용할 수 있습니다. ``` { "FromEmailAddress": "noreply@example.com", "Destination": { "ToAddresses": [ "customer@example.net" ] }, "Content": { "Simple": { "Subject": { "Data": "Hello and welcome" }, "Body": { "Text": { "Data": "Lorem ipsum dolor sit amet." }, "Html": { "Data": "Lorem ipsum dolor sit amet." } } } }, "EmailTags": [ { "Name": "ses:feedback-id-a", "Value": "new-members-campaign" }, { "Name": "ses:feedback-id-b", "Value": "football-campaign" } ], "ConfigurationSetName": "football-club" } ``` 원시 형식으로 전송하는 경우 SES별 헤더 [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers)에 메시지 태그로 `ses:feedback-id-<{{a}} or {{b}}>`를 추가하면 됩니다. `ses:feedback-id-<{{a}} or {{b}}>` 메시지 태그는 다른 메시지 태그와 마찬가지로 CloudWatch 값 소스로 지정하여 Amazon CloudWatch에서 추적할 수도 있습니다. [CloudWatch 이벤트 대상 추가](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add)의 내용을 참조하세요*(추가 요금이 적용되며, [CloudWatch의 지표당 요금](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing) 참조).* ## 이벤트 게시 사용 방법 다음 섹션에는 SES 이벤트 게시를 설정하고 사용하는 데 필요한 정보가 포함되어 있습니다. + [이벤트 게시 설정](monitor-sending-using-event-publishing-setup.md) + [이벤트 데이터 작업](working-with-event-data.md) ## 이벤트 게시 용어 다음 목록은 SES 이벤트 게시에 관련된 용어를 정의한 것입니다. **이메일 전송 이벤트** SES에 제출한 이메일의 결과와 관련된 정보입니다. 전송 이벤트에는 다음이 포함됩니다. + **전송(Send)** - 전송 요청이 성공했으며 Amazon SES는 메시지를 수신자의 메일 서버로 전송합니다. (계정 수준 또는 전역 금지를 사용하는 경우 SES가 여전히 전송으로 계산하지만 배달은 금지합니다.) + **렌더링 오류** – 템플릿 렌더링 문제로 인해 이메일이 전송되지 않았습니다. 이 이벤트 유형은 템플릿 데이터가 누락되었을 때 또는 템플릿 파라미터와 데이터 사이에 불일치가 있을 때 발생할 수 있습니다. (이 이벤트 유형은 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) 또는 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html) API 작업을 사용하는 이메일을 전송할 때만 발생합니다.) + **거부(Reject)** - Amazon SES가 이메일을 수락했으나 이메일에 바이러스가 포함된 것으로 판단되어 수신자의 메일 서버로 전송하려고 시도하지 않았습니다. + **배달(Delivery)** - Amazon SES에서 이메일을 수신자의 메일 서버로 성공적으로 전송했습니다. + **바운스** – 수신자의 메일 서버가 이메일을 영구적으로 거부하는 *하드 바운스*입니다. (*소프트 바운스*는 SES가 더 이상 이메일 전송을 재시도하지 않는 경우에만 포함됩니다. 일반적으로 이러한 소프트 바운스는 전송 실패를 나타내지만, 메일이 수신자의 받은 편지함에 도착하더라도 소프트 바운스가 반환되는 경우도 있습니다. 이러한 상황은 일반적으로 수신자가 부재 중 자동 회신을 보낼 때 발생합니다. [AWS re:Post 문서](https://repost.aws/knowledge-center/ses-understand-soft-bounces)에서 소프트 바운스에 대해 자세히 알아보세요.) + **수신 거부(Complaint)** - 이메일이 수신자의 메일 서버로 성공적으로 전송되었지만 수신자가 이를 스팸으로 표시했습니다. + **배달 지연** – 일시적인 문제가 발생하여 수신자의 메일 서버에 이메일을 전송할 수 없습니다. 예를 들어 수신자의 받은 편지함이 가득 찼거나 이메일 수신 서버에 일시적인 문제가 발생했을 때 전송 지연이 발생할 수 있습니다. + **구독(Subscription)** - 이메일이 성공적으로 배달되었지만 수신자가 이메일 헤더에서 `List-Unsubscribe`를 클릭하거나, 바닥글에서 `Unsubscribe` 링크를 선택하여 구독 기본 설정을 업데이트했습니다. + **열기(Open)** – 수신자가 메시지를 수신하여 자신의 이메일 클라이언트에서 열었습니다. + **클릭(Click)** – 수신자가 이메일의 링크를 1개 이상 클릭했습니다. **구성 세트** SES에서 이메일 전송 이벤트를 게시할 대상과 게시하려는 이메일 전송 이벤트 유형을 정의하는 규칙 세트입니다. 이벤트 게시와 함께 사용하려는 이메일을 전송할 때 이메일에 연결할 구성 세트를 지정합니다. **이벤트 대상** SES 이메일 전송 이벤트를 게시하는 AWS 서비스입니다. 설정하는 각 이벤트 대상은 단 하나의 구성 세트에만 속합니다. **메시지 태그** 이벤트 게시를 목적으로 이메일을 분류하는 데 사용하는 이름/값 페어입니다. 예를 들면 *campaign/book*, *campaign/clothing*의 형식입니다. 이메일을 전송할 때 API 직접 호출에 대한 파라미터 또는 SES별 이메일 헤더로 메시지 태그를 지정합니다. **자동 태그** 이벤트 게시 보고서에 자동으로 포함되는 메시지 태그입니다. 구성 세트 이름, 'From' 주소의 도메인, 호출자의 발신 IP 주소, SES 발신 IP 주소, 호출자의 IAM ID를 표시하는 자동 태그가 있습니다.