本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon SES 發佈至 Amazon SNS 的事件資料內容
Amazon SES 以 JSON 格式將電子郵件傳送事件記錄發佈到 Amazon Simple Notification Service。
您可於 Amazon SES 發佈至 Amazon SNS 的事件資料範例 找到這些所有通知類型的範例記錄。
最上層 JSON 物件
電子郵件傳送事件記錄中最上層的 JSON 物件包含下列欄位。事件類型會決定有哪些其他物件。
欄位名稱 | 描述 |
---|---|
|
描述事件類型的字串。可能的數值: 如果您未不設定事件發佈,此欄位將命名為 |
|
包含生產該事件的電子郵件相關資訊之 JSON 物件。 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
|
此欄位只有在 |
郵件物件
每個電子郵件傳送事件記錄包含 mail
物件中原始電子郵件的相關資訊。其中包含 mail
物件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
傳送訊息的日期和時間,格式為 ISO8601 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
Amazon SES 指派給訊息的專有 ID。您傳送訊息後,Amazon SES 會回傳此數值給您。 注意此訊息 ID 是由 Amazon SES 指派。您可以在原始電子郵件內 |
|
傳送出該訊息的電子郵件地址 (信封的「寄件人」地址)。 |
|
用以傳送電子郵件之身分的 Amazon Resource Name (ARN)。在傳送授權的情況下, |
|
用以傳送電子郵件之帳戶的 AWS 帳戶 ID。在傳送授權的情況下, |
|
原始郵件收件人的電子郵件地址清單。 |
|
說明通知中的標題是否已截斷的字串,會在標題大於 10 KB 時顯示。可能值為 |
|
電子郵件原始標題的清單。清單中的每項標題都有 注意
|
|
電子郵件常用的原始標頭映射。 注意任何 |
|
與電子郵件相關聯的標籤清單。 |
退信物件
其中包含 Bounce
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
退信類型,由 Amazon SES 判定。 |
|
退信的副類型,由 Amazon SES 判定。 |
|
其中包含遭退信的原始郵件收件人之相關資訊的清單。 |
|
ISP 傳送退信通知時的日期和時間,其格式為 ISO8601 格式 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
退信的唯一 ID。 |
|
來自 DSN 的 注意此欄位只有在傳遞狀態通知 (DSN) 與退信連接時才會顯示。 |
退信的收件人
退信事件可能與單一收件人或多個收件人相關。bouncedRecipients
欄位擁有物件清單 (電子郵件地址發生退信的每個收件人都有一個物件),且包含下列欄位。
欄位名稱 | 描述 |
---|---|
|
收件人的電子郵件地址。若有可用的 DSN,此為來自 DSN 的 |
或者,如果 DSN 連接到退信,也可能會顯示下列欄位。
欄位名稱 | 描述 |
---|---|
|
來自 DSN 的 |
|
來自 DSN 的 |
|
由回報 MTA 發出的狀態碼。此為來自 DSN 的 |
退信類型
每個退信事件都是下表所列的其中一個類型。
事件發佈系統只會發佈 Amazon SES 不會再重試傳送的硬退信與軟退信。當您收到標示為 Permanent
的退信時,您應該從電子清單中移除對應的電子郵件地址,您將來無法再傳送給他們。當訊息發生多次軟退信時,您會收到 Transient
退信,而 Amazon SES 會停止嘗試重新遞送該訊息。未來您也許可以成功重新傳送給一開始導致 Transient
退信的地址。
bounceType | bounceSubType | 描述 |
---|---|---|
|
|
Amazon SES 無法判斷具體退信原因。 |
|
|
Amazon SES 收到一般硬退信。如果您收到此類退信,應該從您的郵寄清單中移除該收件人的電子郵件地址。 |
|
|
Amazon SES 收到永久硬退信,因為目標電子郵件地址不存在。如果您收到此類退信,應該從您的郵寄清單中移除該收件人的電子郵件地址。 |
|
|
Amazon SES 已禁止寄至此地址的傳送,因為它最近因無效地址而出現退信歷程記錄。若要複寫全域禁止名單,請參閱 使用 Amazon SES 帳戶級別禁止列表。 |
Permanent |
OnAccountSuppressionList |
Amazon SES 已禁止傳送至此地址,因為它列於帳戶層級禁止名單中。這不會計入您的退信率指標。 |
|
|
Amazon SES 收到一般退信。未來您也許可成功傳送給此收件人。 |
|
|
Amazon SES 收到信箱已滿退信。未來您也許可成功傳送給此收件人。 |
|
|
Amazon SES 收到訊息過大退信。若您減少訊息大小,也許可成功傳送給此收件人。 |
|
|
Amazon SES 收到內容遭拒退信。若您更改訊息內容,也許可成功傳送給此收件人。 |
|
|
Amazon SES 收到附件遭拒退信。若您移除或更改附件,也許可成功傳送給此收件人。 |
投訴物件
其中包含 Complaint
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
清單中包含可能曾提出投訴的收件人相關資訊。 |
|
ISP 傳送抱怨通知時的日期和時間,其格式為 ISO8601 格式 (YYYY-MM-DDThh: mm: ss.sZ)。 |
|
投訴的唯一 ID。 |
|
投訴的子類型,由 Amazon SES 判定。 |
此外,如果意見回饋報告連接到該投訴,可能顯示下列欄位。
欄位名稱 | 描述 |
---|---|
|
來自意見回饋報告的 |
|
自 ISP 傳送的意見回饋報告中的 |
|
來自回饋報告的 |
提出投訴的收件人
complainedRecipients
欄位包含可能曾提出投訴的收件人清單。
重要
大多數 ISP 會修改提出抱怨的收件人之電子郵件地址。因此,complainedRecipients
欄位將包含曾收過電子郵件、且地址位於發出抱怨通知的網域內之所有地址的清單。
在這個清單中的 JSON 物件包含下列欄位。
欄位名稱 | 描述 |
---|---|
|
收件人的電子郵件地址。 |
抱怨類型
您可能看到 complaintFeedbackType
欄位中由回報 ISP 根據 Internet Assigned Numbers Authority website
欄位名稱 | 描述 |
---|---|
|
指出自動發出的電子郵件或其他形式的電子郵件濫用。 |
|
電子郵件身分驗證故障報告。 |
|
指示某些形式的詐騙或網路釣魚活動。 |
|
指示提供報告的實體不會將訊息視為垃圾郵件。這可能會用於修正內含不正確標籤或者被歸類為垃圾郵件的訊息。 |
|
指示不符合其他註冊類型的任何其他意見回饋。 |
|
回報在原始訊息中找到病毒。 |
抱怨子類型
complaintSubType
欄位的值可以是 null 或 OnAccountSuppressionList
。如果該值為 OnAccountSuppressionList
,Amazon SES 會接受訊息,但不會嘗試傳送它,因為它位在帳戶層級禁止名單中。
交付物件
其中包含 Delivery
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
Amazon SES 傳遞電子郵件到收件人的郵件伺服器之日期和時間,以 ISO8601 格式 (YYYY-MM-DDThh:mm:ss.sZ) 顯示。 |
|
從 Amazon SES 接受來自寄件者請求,到 Amazon SES 將訊息傳遞給收件人電子郵件伺服器之間的毫秒數。 |
|
套用傳遞事件的預期收件人清單。 |
|
接受 Amazon SES 所傳送電子郵件的遠端 ISP 之 SMTP 回應訊息。此訊息會隨著電子郵件、接收郵件伺服器以及接收 ISP 而有所不同。 |
|
傳送郵件的 Amazon SES 郵件伺服器主機名稱。 |
傳送物件
包含關於 send
事件資訊的 JSON 物件將一律為空白。
拒絕物件
其中包含 Reject
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
電子郵件遭拒的原因。唯一可能的值為 |
開啟物件
其中包含 Open
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
收件人的 IP 地址。 |
|
開啟事件發生時的日期和時間,其格式為 ISO8601 格式 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
收件人用於開啟電子郵件中的連結的裝置或電子郵件用戶端使用者代理程式。 |
點選物件
其中包含 Click
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
收件人的 IP 地址。 |
|
點擊事件發生時的日期和時間,其格式為 ISO8601 格式 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
收件人用於點選電子郵件中的連結的用戶端使用者代理程式。 |
|
收件人點選的 URL 連結。 |
|
使用 |
算圖失敗物件
其中包含 Rendering Failure
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
用於傳送電子郵件的範本名稱。 |
|
提供更多關於轉譯失敗資訊的訊息。 |
DeliveryDelay 物件
其中包含 DeliveryDelay
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
延遲的類型。可能值為:
|
|
包含有關電子郵件收件人資訊的物件。 |
|
Amazon SES 將停止嘗試傳遞訊息的日期和時間。此數值以 ISO 8601 格式顯示。 |
|
報告延遲之郵件傳輸代理程式 (MTA) 的 IP 地址。 |
|
延遲發生的日期和時間,以 ISO 8601 格式顯示。 |
延遲的收件人
delayedRecipients
物件包含下列數值:
欄位名稱 | 描述 |
---|---|
|
導致訊息傳遞延遲的電子郵件地址。 |
|
與傳遞延遲相關聯的 SMTP 狀態碼。 |
|
接收訊息傳輸代理程式 (MTA) 所提供的診斷代碼。 |
訂閱物件
其中包含 Subscription
事件相關資訊的 JSON 物件有下列欄位。
欄位名稱 | 描述 |
---|---|
|
聯絡人名稱清單為開啟。 |
|
ISP 傳送訂閱通知時的日期和時間,其格式為 ISO8601 格式 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
傳送出該訊息的電子郵件地址 (信封的「寄件人」地址)。 |
|
JSON 資料結構 (映射) 指定聯絡清單中所有主題的訂閱狀態,顯示更改後的狀態 (已訂閱或已取消訂閱)。 |
|
JSON 資料結構 (映射) 指定聯絡清單中所有主題的訂閱狀態,顯示更改前的狀態 (已訂閱或已取消訂閱)。 |
新/舊主題偏好
newTopicPreferences
和 oldTopicPreferences
物件包含下列數值:
欄位名稱 | 描述 |
---|---|
|
指定聯絡人是否取消聯絡清單中的所有主題。 |
|
指定 |
|
指定 |