Amazon이 Firehose에 SES 게시하는 이벤트 데이터의 콘텐츠 - Amazon Simple Email Service
최상위 JSON 객체mail 객체Bounce 객체Complaint 객체전송 객체Send 객체Reject 객체Open 객체Click 객체Rendering Failure 객체DeliveryDelay 객체구독 객체

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon이 Firehose에 SES 게시하는 이벤트 데이터의 콘텐츠

Amazon은 이메일 전송 이벤트 레코드를 Amazon Data Firehose에 JSON 형식으로 SES 게시합니다. Firehose에 이벤트를 게시할 때 Amazon은 각 JSON 레코드를 새 줄 문자로 SES 따릅니다.

이러한 모든 알림 유형에 대한 레코드 예는 Amazon이 Firehose에 SES 게시하는 이벤트 데이터의 예에서 찾을 수 있습니다.

최상위 JSON 객체

이메일 전송 이벤트 레코드의 최상위 JSON 객체에는 다음 필드가 포함됩니다.

필드 이름 설명

eventType

이벤트 유형을 설명하는 문자열입니다. 가능한 값: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay 또는 Subscription

이벤트 게시를 설정하지 않은 경우 이 필드의 이름은 notificationType입니다.

mail

이벤트를 생성한 이메일에 대한 정보가 포함된 JSON 객체입니다.

bounce

이 필드는 eventType이 Bounce인 경우에만 존재합니다. 이 파일에는 반송 관련 정보가 포함되어 있습니다.

complaint

이 필드는 eventType이 Complaint인 경우에만 존재합니다. 이 파일에는 수신 거부 관련 정보가 포함되어 있습니다.

delivery

이 필드는 eventType이 Delivery인 경우에만 존재합니다. 이 파일에는 전송 관련 정보가 포함되어 있습니다.

send

이 필드는 eventType이 Send인 경우에만 존재합니다.

reject

이 필드는 eventType이 Reject인 경우에만 존재합니다. 이 파일에는 거부 관련 정보가 포함되어 있습니다.

open

이 필드는 eventType이 Open인 경우에만 존재합니다. 이 파일에는 열기 이벤트 관련 정보가 포함되어 있습니다.

click

이 필드는 eventType이 Click인 경우에만 존재합니다. 이 파일에는 클릭 이벤트 관련 정보가 포함되어 있습니다.

failure

이 필드는 eventType이 Rendering Failure인 경우에만 존재합니다. 이 파일에는 렌더링 오류 이벤트 관련 정보가 포함되어 있습니다.

deliveryDelay

이 필드는 eventType이 DeliveryDelay인 경우에만 존재합니다. 이메일 전송 지연에 대한 정보가 포함되어 있습니다.

subscription

이 필드는 eventType이 Subscription인 경우에만 존재합니다. 여기에는 구독 기본 설정에 대한 정보가 포함되어 있습니다.

Mail 객체

각 이메일 전송 이벤트 레코드는 mail 객체에 원래 메일에 대한 정보를 포함하고 있습니다. JSON 객체에 대한 정보가 포함된 mail 객체에는 다음 필드가 있습니다.

필드 이름 설명

timestamp

메시지가 전송된 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)의 날짜 및 시간입니다.

messageId

Amazon이 메시지에 SES 할당한 고유 ID입니다. Amazon은 메시지를 보낼 때 이 값을 SES 반환했습니다.

참고

이 메시지 ID는 Amazon 에서 할당했습니다SES. mail 객체의 headers 및 commonHeaders 필드에서 원래 메시지의 메시지 ID를 찾을 수 있습니다.

source

메시지가 전송된 이메일 주소(엔벨로프 MAIL FROM 주소).

sourceArn

이메일을 보내는 데 사용된 자격 증명의 Amazon 리소스 이름(ARN)입니다. 권한 부여를 전송하는 경우 sourceArn는 자격 증명 소유자가 위임 발신자가 이메일을 보내는 데 사용할 수 있도록 권한을 부여한 자격 증명ARN의 입니다. 권한 부여 전송에 대한 자세한 내용은 이메일 인증 방법 단원을 참조하세요.

sendingAccountId

이메일을 보내는 데 사용된 AWS 계정의 계정 ID입니다. 권한 부여 전송의 경우 sendingAccountId는 위임 발신자의 계정 ID입니다.

destination

원래 메일의 수신자인 이메일 주소의 목록.

headersTruncated

알림에서 헤더가 잘렸는지 여부를 나타내는 문자열입니다. 헤더의 용량이 10KB를 초과할 경우 헤더가 잘립니다. 가능한 값은 true 및 false입니다.

headers

이메일의 원래 헤더 목록입니다. 목록의 각 헤더에는 name 필드와 value 필드가 존재합니다.

참고

headers 필드 내의 모든 메시지 ID는 Amazon 에 전달한 원본 메시지에서 가져온 것입니다SES. 이후 Amazon이 메시지에 SES 할당한 메시지 ID는 mail 객체의 messageId 필드에 있습니다.

commonHeaders

자주 사용되는 원래 이메일 헤더의 매핑입니다.

참고

commonHeaders 필드 내의 메시지 ID는 Amazon이 SES 이후 mail 객체의 messageId 필드에 있는 메시지에 할당한 메시지 ID입니다.

tags

이메일과 연결된 태그 목록입니다.

Bounce 객체

Bounce 이벤트에 대한 정보가 포함된 JSON 객체에는 항상 다음 필드가 있습니다.

필드 이름 설명

bounceType

Amazon 에서 결정하는 바운스 유형입니다SES.

bounceSubType

Amazon 에서 결정하는 바운스의 하위 유형입니다SES.

bouncedRecipients

반송된 원래 메일의 수신자 정보를 포함하는 목록.

timestamp

가 반송 알림을 ISP 보낸 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)의 날짜 및 시간입니다.

feedbackId

반송 메일의 고유 ID.

reportingMTA

의 Reporting-MTA 필드 값입니다DSN. 에 설명된 전송, 릴레이 또는 게이트웨이 작업을 수행하려고 시도한 메시지 전송 권한(MTA)의 값입니다DSN.

참고

이 필드는 전송 상태 알림(DSN)이 반송에 연결된 경우에만 나타납니다.

반송 수신자

반송 이벤트는 단일 수신자 또는 여러 수신자와 관련이 있을 수 있습니다. bouncedRecipients 필드는 객체(반송 메일 이벤트가 관련된 수신자당 객체 1개)의 목록을 포함하고 있으며 항상 다음 필드로 구성됩니다.

필드 이름 설명

emailAddress

수신자의 이메일 주소. 를 사용할 수 DSN 있는 경우 의 Final-Recipient 필드 값입니다DSN.

선택적으로 DSN가 반송에 연결된 경우 다음 필드도 존재할 수 있습니다.

필드 이름 설명

action

의 Action 필드 값입니다DSN. 이는 이 수신자에게 메시지를 전달하려는 시도의 결과로 보고MTA에서 수행한 작업을 나타냅니다.

status

의 Status 필드 값입니다DSN. 메시지의 전송 상태를 나타내는 수신자별 전송 독립적 상태 코드입니다.

diagnosticCode

보고 에서 발행한 상태 코드입니다MTA. 의 Diagnostic-Code 필드 값입니다DSN. 이 필드는 에 없을 수 있습니다DSN(따라서 에도 없을 수 있습니다JSON).

반송 메일 유형

각 반송 메일 이벤트는 다음 표에 나와 있는 유형 중 하나가 됩니다.

이벤트 게시 시스템은 Amazon 에서 더 이상 재시도하지 않는 하드 바운스와 소프트 바운스만 게시합니다SES. 로 표시된 반송 메일을 받으면 해당 이메일 주소를 메일링 목록에서 제거Permanent해야 합니다. 앞으로는 해당 이메일 주소를 보낼 수 없습니다. 메시지가 소프트 Transient 반송 메일을 여러 번 받고 AmazonSES이 다시 전송하려고 시도하지 않으면 반송 메일이 전송됩니다. 처음에 Transient 반송 메일이 발생한 주소로 이후 전송 재시도가 성공할 수도 있습니다.

bounceType bounceSubType 설명

Undetermined

Undetermined

AmazonSES에서 특정 반송파 이유를 확인할 수 없습니다.

Permanent

General

Amazon은 일반적인 하드 바운스를 SES 받았습니다. 이 유형의 반송 메일을 받은 경우, 이 수신자의 이메일 주소를 메일 발송 목록에서 삭제해야 합니다.

Permanent

NoEmail

대상 이메일 주소가 존재하지 않아 Amazon에서 영구 하드 바운스를 SES 수신했습니다. 이 유형의 반송 메일을 받은 경우, 이 수신자의 이메일 주소를 메일 발송 목록에서 삭제해야 합니다.

Permanent

Suppressed

AmazonSES은 최근 잘못된 주소로 바운스한 기록이 있기 때문에 이 주소로의 전송을 금지했습니다. 전역 금지 목록을 재정의하려면 Amazon SES 계정 수준 금지 목록 사용 섹션을 참조하세요.
Permanent OnAccountSuppressionList AmazonSES은 계정 수준 금지 목록 에 있기 때문에 이 주소로의 전송을 금지했습니다. 이는 반송 비율 지표에 반영되지 않습니다.

Transient

General

Amazon은 일반 반송장을 SES 받았습니다. 이후에 이 수신자에게 전송이 성공할 수도 있습니다.

Transient

MailboxFull

Amazon은 사서함 전체 반송 메일을 SES 수신했습니다. 이후에 이 수신자에게 전송이 성공할 수도 있습니다.

Transient

MessageTooLarge

Amazon에서 너무 큰 반송 메일 메시지를 SES 수신했습니다. 메시지 크기를 줄일 경우 이 수신자에게 전송이 성공할 수도 있습니다.

Transient

CustomTimeoutExceeeded

AmazonSES이 이메일 발신자가 지정한 시간 내에 이메일을 성공적으로 전송하지 못했습니다. (바운스 메시지는 정의된 내에서 가능한 전달 시도 실패의 이유를 지정합니다TTL.)

Transient

ContentRejected

Amazon이 거부된 콘텐츠 반송을 SES 수신했습니다. 메시지 내용을 변경할 경우 이 수신자에게 전송이 성공할 수도 있습니다.

Transient

AttachmentRejected

Amazon이 거부된 첨부 파일 반송을 SES 수신했습니다. 첨부 파일을 제거하거나 변경할 경우 이 수신자에게 전송이 성공할 수도 있습니다.

Complaint 객체

Complaint 이벤트에 대한 정보가 포함된 JSON 객체에는 다음 필드가 있습니다.

필드 이름 설명

complainedRecipients

수신 거부를 제출했을 수 있는 수신자에 대한 정보를 포함하는 목록.

timestamp

가 불만 사항 알림을 ISP 보낸 날짜 및 시간을 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)으로 입력합니다.

feedbackId

수신 거부의 고유 ID.

complaintSubType

Amazon 에서 결정한 불만 사항의 하위 유형입니다SES.

또한, 수신 거부에 피드백 보고서가 첨부된 경우 다음 필드가 포함될 수 있습니다.

필드 이름 설명

userAgent

피드백 보고서의 User-Agent 필드의 값입니다. 보고서를 생성한 시스템의 이름 및 버전을 나타냅니다.

complaintFeedbackType

에서 수신한 피드백 보고서의 Feedback-Type 필드 값입니다ISP. 이 값은 피드백의 유형을 포함합니다.

arrivalDate

피드백 보고서에서 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)의 Arrival-Date 또는 Received-Date 필드 값입니다. 이 필드는 보고서에 없을 수 있습니다(따라서 에도 없을 수 있습니다JSON).

수신 거부한 수신자

complainedRecipients 필드는 수신 거부를 제출했을 수 있는 수신자의 목록을 포함합니다.

중요

불만 알림에서 불만을 제출한 수신자의 이메일 주소를 대부분 ISPs 수정하기 때문에 이 목록에는 원본 메시지의 수신자와 불만을 받은 ISP 에 따라 불만을 보낸 수신자에 대한 정보가 포함되어 있습니다. Amazon은 원본 메시지에 대해 조회를 SES 수행하여 이 수신자 목록을 확인합니다.

JSON 이 목록의 객체에는 다음 필드가 포함됩니다.

필드 이름 설명

emailAddress

수신자의 이메일 주소.

수신 거부 유형

Internet Assigned Numbers Authority 웹 사이트 에 ISP따라 보고 에서 할당한 대로 complaintFeedbackType 필드에 다음과 같은 불만 유형이 표시될 수 있습니다.

필드 이름 설명

abuse

원치 않는 이메일 또는 기타 유형의 이메일 침해를 나타냅니다.

auth-failure

이메일 인증 실패 보고서.

fraud

일종의 사기 또는 피싱 활동을 나타냅니다.

not-spam

보고서를 제공하는 엔터티가 메시지를 스팸으로 간주하지 않음을 나타냅니다. 이는 스팸으로 잘못 태그 지정 또는 분류된 메시지를 교정하기 위해 사용될 수 있습니다.

other

다른 등록된 유형에 들어맞지 않는 기타 피드백을 나타냅니다.

virus

발원 메시지에서 바이러스가 발견되었다는 보고서.

전송 객체

Delivery 이벤트에 대한 정보가 포함된 JSON 객체에는 항상 다음 필드가 있습니다.

필드 이름 설명

timestamp

Amazon이 수신자의 메일 서버에 이메일을 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)으로 SES 전송한 날짜 및 시간입니다.

processingTimeMillis

Amazon이 발신자의 요청을 SES 수락한 시점과 Amazon이 메시지를 수신자의 메일 서버에 SES 전달한 시점 사이의 밀리초 단위 시간입니다.

recipients

전송 이벤트가 적용되는 의도한 수신자의 목록.

smtpResponse

Amazon 에서 이메일을 수락ISP한 원격 의 SMTP 응답 메시지입니다SES. 이 메시지는 이메일, 메일 서버 수신 및 수신에 따라 달라집니다ISP.

reportingMTA

SES 메일을 보낸 Amazon 메일 서버의 호스트 이름입니다.

Send 객체

send 이벤트에 대한 정보가 포함된 JSON 객체는 항상 비어 있습니다.

Reject 객체

Reject 이벤트에 대한 정보가 포함된 JSON 객체에는 항상 다음 필드가 있습니다.

필드 이름 설명

reason

이메일이 거부된 이유입니다. 가능한 유일한 값은 이며Bad content, 이는 Amazon이 이메일에 바이러스가 포함되어 있음을 SES 감지했음을 의미합니다. 메시지가 거부되면 Amazon은 해당 메시지 처리를 SES 중지하고 수신자의 메일 서버로 전송하려고 시도하지 않습니다.

Open 객체

Open 이벤트에 대한 정보가 포함된 JSON 객체에는 항상 다음 필드가 포함됩니다.

필드 이름 설명

ipAddress

수신자의 IP 주소입니다.

timestamp

열린 이벤트가 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)으로 발생한 날짜 및 시간입니다.

userAgent

수신자가 이메일을 여는 데 사용한 이메일 클라이언트 또는 디바이스의 사용자 에이전트입니다.

Click 객체

Click 이벤트에 대한 정보가 포함된 JSON 객체에는 항상 다음 필드가 포함됩니다.

필드 이름 설명

ipAddress

수신자의 IP 주소입니다.

timestamp

클릭 이벤트가 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)으로 발생한 날짜 및 시간입니다.

userAgent

수신자가 이메일의 링크를 클릭하는 데 사용한 클라이언트의 사용자 에이전트입니다.

link

수신자가 클릭한 링크URL의 입니다.

linkTags

ses:tags 속성을 사용하여 링크에 추가된 태그 목록입니다. 이메일의 링크에 태그를 추가하는 방법은 Q5. 링크에 고유 식별자로 태그를 지정할 수 있습니까?의 Amazon SES 이메일 전송 지표 FAQ 단원을 참조하세요.

Rendering Failure 객체

Rendering Failure 이벤트에 대한 정보가 포함된 JSON 객체에는 다음 필드가 있습니다.

필드 이름 설명

templateName

이메일을 전송하는 데 사용하는 템플릿의 이름입니다.

errorMessage

렌더링 오류에 관한 자세한 정보를 제공하는 메시지입니다.

DeliveryDelay 객체

DeliveryDelay 이벤트에 대한 정보가 포함된 JSON 객체에는 다음 필드가 있습니다.

필드 이름 설명

delayType

지연 유형입니다. 가능한 값은 다음과 같습니다.

  • InternalFailure – Amazon 내부 SES 문제로 인해 메시지가 지연되었습니다.

  • 일반 - SMTP 대화 중에 일반적인 장애가 발생했습니다.

  • MailboxFull - 수신자의 사서함이 가득 찼으며 추가 메시지를 받을 수 없습니다.

  • SpamDetected - 수신자의 메일 서버가 계정에서 대량의 원치 않는 이메일을 감지했습니다.

  • RecipientServerError - 수신자의 이메일 서버에 일시적인 문제가 발생하여 메시지 전송이 금지되고 있습니다.

  • IPFailure - 메시지를 보내는 IP 주소가 수신자의 이메일 공급자에 의해 차단되거나 제한되고 있습니다.

  • TransientCommunicationFailure - 수신자의 이메일 공급자와 SMTP 대화하는 동안 일시적인 통신 실패가 발생했습니다.

  • BYOIPHostNameLookupUnavailable - AmazonSES이 IP 주소의 DNS 호스트 이름을 조회할 수 없습니다. 이러한 지연 유형은 자체 IP 가져오기를 사용할 때만 발생합니다.

  • 미결정 - AmazonSES이 배송 지연 이유를 확인할 수 없었습니다.

  • SendingDeferral – AmazonSES은 메시지를 내부적으로 연기하는 것이 적절하다고 간주했습니다.

delayedRecipients

이메일 수신자에 대한 정보가 있는 객체입니다.

expirationTime

Amazon이 메시지 전송 시도를 중지하는 날짜 및 시간SES입니다. 이 값은 ISO 8601 형식으로 표시됩니다.

reportingMTA

지연을 보고한 메시지 전송 에이전트(MTA)의 IP 주소입니다.

timestamp

지연이 발생한 날짜 및 시간으로, ISO 8601 형식으로 표시됩니다.

지연된 수신자

delayedRecipients 객체는 다음 값을 포함합니다.

필드 이름 설명

emailAddress

메시지 전송이 지연된 이메일 주소입니다.

status

전송 지연과 연결된 SMTP 상태 코드입니다.

diagnosticCode

수신 메시지 전송 에이전트()에서 제공하는 진단 코드입니다MTA.

구독 객체

Subscription 이벤트에 대한 정보가 포함된 JSON 객체에는 다음 필드가 있습니다.

필드 이름 설명

contactList

연락처가 있는 목록의 이름입니다.

timestamp

가 구독 알림을 ISP 보낸 ISO8601 형식(YYYY-MM-DDThh:mm:ss.sZ)의 날짜 및 시간입니다.

source

메시지가 전송된 이메일 주소(엔벨로프 MAIL FROM 주소).

newTopicPreferences

변경 후 상태를 나타내는 연락처 목록의 모든 주제의 구독 상태를 지정하는 JSON 데이터 구조(맵)입니다(구독된 연락처 또는 구독 취소된 연락처).

oldTopicPreferences

변경 전 상태를 나타내는 연락처 목록의 모든 주제의 구독 상태를 지정하는 JSON 데이터 구조(맵)입니다(구독된 연락처 또는 구독 취소된 연락처).

신규/이전 주제 기본 설정

newTopicPreferences 및 oldTopicPreferences 객체는 다음 값을 포함합니다.

필드 이름 설명

unsubscribeAll

연락처 목록의 모든 주제에서 연락처가 구독을 취소했는지를 지정합니다.

topicSubscriptionStatus

지정된 이벤트 유형에 SES 대해 에서 알림을 수신하도록 현재 구독하고 있는지 여부를 나타내는 topicName 필드에서 주제의 구독 상태를 지정합니다. 가능한 값은 subscriptionStatus 필드에서 OptIn (구독) 또는 OptOut (구독 취소)입니다.

topicDefaultSubscriptionStatus

topicName 필드에서 주제의 기본 구독 상태를 지정하여 이벤트 대상에 추가된 새 주제를 기본적으로 구독할지 아니면 구독 취소할지 결정합니다. 가능한 값은 subscriptionStatus 필드에서 OptIn (기본적으로 구독) 또는 OptOut (기본적으로 구독 취소)입니다.