Amazon が Firehose SES に発行するイベントデータの内容

Amazon SES は、E メール送信イベントレコードを JSON形式で Amazon Data Firehose に発行します。Firehose にイベントを発行する場合、Amazon は各JSONレコードに改行文字をSES付けます。

これらのすべての通知タイプのレコード例については、「Amazon が Firehose SES に発行するイベントデータの例」を参照してください。

最上位JSONオブジェクト

E メール送信イベントレコードの最上位JSONオブジェクトには、次のフィールドが含まれます。

フィールド名	説明
eventType	イベントのタイプを説明する文字列。可能な値: Bounce、Complaint、Delivery、Send、Reject、Open、Click、Rendering Failure、DeliveryDelay、または Subscription。 もしイベント発行のセットアップをしなかった場合は、このフィールドは notificationType と名付けられます。
mail	イベントを生成した E メールに関する情報を含む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 の場合のみ表示されます。E メールの遅延配信に関する情報が含まれています。
subscription	このフィールドは、eventType が Subscription の場合のみ表示されます。このフィールドには、サブスクリプション設定に関する情報が含まれています。

Mail オブジェクト

各メール送信イベントレコードには、mail オブジェクトの元のメールに関する情報が含まれています。JSON オブジェクトに関する情報を含むmailオブジェクトには、次のフィールドがあります。

フィールド名	説明
timestamp	メッセージが送信された日時。ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ）。
messageId	Amazon がメッセージにSES割り当てた一意の ID。Amazon は、メッセージを送信したときにこの値をSES返しました。 注記 このメッセージ ID は Amazon によって割り当てられましたSES。元の E メールのメッセージ ID は、mail オブジェクトの headers および commonHeaders フィールドにあります。
source	メッセージが送信された E メールアドレス (エンベロープMAILFROMアドレス）。
sourceArn	E メールの送信に使用された ID の Amazon リソースネーム (ARN）。送信承認の場合、 sourceArnは、ID 所有者が代理送信者が E メールの送信に使用することを承認した ID ARNの です。送信承認の詳細については、「E メールの認証方法」を参照してください。
sendingAccountId	E メールの送信に使用されたアカウントのアカウント AWS ID。送信承認の場合、sendingAccountId は代理送信者のアカウント ID です。
destination	元のメールの受取人の E メールアドレスのリスト。
headersTruncated	通知でヘッダーが切り捨てられたかどうかを示す文字列。切り捨ては、ヘッダーが 10 KB を超える場合に発生します。指定できる値は true および false です。
headers	E メールの元のヘッダーの一覧。リスト内の各ヘッダーには、name フィールドと value フィールドがあります。 注記 headers フィールド内のメッセージ ID は、Amazon に渡した元のメッセージからのものですSES。その後 Amazon がメッセージにSES割り当てたメッセージ ID は、 mail オブジェクトの messageIdフィールドにあります。
commonHeaders	E メールの元の一般的に使用されるヘッダーのマッピング。 注記 commonHeaders フィールド内のメッセージ ID は、Amazon がSESその後mailオブジェクトの messageIdフィールドのメッセージに割り当てたメッセージ ID です。
tags	E メールに関連付けられたタグのリストです。

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。これは、 で説明されている配信、リレー、またはゲートウェイオペレーションを実行しようとした Message Transfer Authority (MTA) の値ですDSN。 注記 このフィールドは、配信ステータス通知 (DSN) がバウンスにアタッチされた場合にのみ表示されます。

バウンスとなった受取人

バウンスイベントには、1 人の受信者に関するものと複数の受信者に関するものがあります。bouncedRecipients フィールドにはオブジェクトのリストが含まれ (バウンスイベントが関係する受信者ごとに 1 つのオブジェクト)、常に以下のフィールドが含まれています。

フィールド名	説明
emailAddress	受取人の E メールアドレス。DSN が使用可能な場合、これは からの Final-Recipientフィールドの値ですDSN。

オプションで、 DSNがバウンスにアタッチされている場合、次のフィールドも存在する可能性があります。

フィールド名	説明
action	からの Actionフィールドの値DSN。これは、この受信者にメッセージを配信しようとした結果MTA、レポートによって実行されたアクションを示します。
status	からの Statusフィールドの値DSN。これは、メッセージの配信状態を示す、受取人ごとに個別の、トランスポート独立型ステータスコードです。
diagnosticCode	レポート によって発行されたステータスコードMTA。これは、 の Diagnostic-Codeフィールドの値ですDSN。このフィールドは、 に存在しない DSN (したがって、 にも存在しないJSON) 場合があります。

バウンスのタイプ

各バウンスイベントは、以下の表に示すいずれかのタイプになります。

イベント発行システムは、Amazon によって再試行されなくなるハードバウンスとソフトバウンスのみを公開しますSES。とマークされたバウンスを受け取ったらPermanent、対応する E メールアドレスをメーリングリストから削除する必要があります。今後送信することはできません。Transientバウンスは、メッセージのソフトバウンスが複数回発生し、Amazon SESが再配信を停止したときに送信されます。最初は Transient バウンスとして返されても、将来的には同じアドレスに正常に再送できる場合があります。

bounceType	bounceSubType	説明
Undetermined	Undetermined	Amazon SES は特定のバウンス理由を特定できませんでした。
Permanent	General	Amazon は一般的なハードバウンスSESを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。
Permanent	NoEmail	ターゲット E メールアドレスが存在しないため、Amazon は永続的なハードバウンスSESを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。
Permanent	Suppressed	Amazon SES は、無効なアドレスとしてバウンスした最近の履歴があるため、このアドレスへの送信を抑制しました。グローバルサプレッションリストを上書きするには、「Amazon SESアカウントレベルのサプレッションリストの使用」を参照してください。
Permanent	OnAccountSuppressionList	Amazon SESは、アカウントレベルのサプレッションリスト に含まれているため、このアドレスへの送信を抑制しました。これは、バウンス率のメトリクスに対してはカウントされません。
Transient	General	Amazon は一般的なバウンスSESを受け取りました。今後、この受信者に正常に再送できる可能性があります。
Transient	MailboxFull	Amazon はメールボックスのフルバウンスSESを受信しました。今後、この受信者に正常に再送できる可能性があります。
Transient	MessageTooLarge	Amazon は、バウンスが大きすぎるメッセージSESを受信しました。メッセージサイズを小さくすることで、この受信者に正常に再送できる可能性があります。
Transient	ContentRejected	Amazon はコンテンツ拒否バウンスSESを受信しました。メッセージのコンテンツを変更することで、この受信者に正常に再送できる可能性があります。
Transient	AttachmentRejected	Amazon は、バウンスを拒否された添付ファイルSESを受信しました。添付ファイルを削除または変更することで、この受信者に正常に再送できる可能性があります。

苦情のオブジェクト

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	フィードバックレポートの Arrival-Dateまたは Received-Dateフィールドの値を ISO8601 形式で指定します (YYYY-MM-DDThh:mm:ss.sZ）。このフィールドはレポートにない (したがって、 にもないJSON) 可能性があります。

苦情を申告した受取人

complainedRecipients フィールドには、苦情の送信元と思われる受信者のリストが含まれます。

重要

ほとんどの は苦情通知から苦情を送信した受信者の E メールアドレスISPsを編集するため、このリストには、元のメッセージの受信者と苦情ISPを受け取った に基づいて、苦情を送信した可能性のある受信者に関する情報が含まれています。Amazon SES は元のメッセージに対して検索を実行して、この受信者リストを決定します。

JSON このリスト内の オブジェクトには、次のフィールドが含まれます。

フィールド名	説明
emailAddress	受取人の E メールアドレス。

苦情のタイプ

Internet Assigned Numbers Authority のウェブサイト によるとISP、レポート によって割り当てられた complaintFeedbackTypeフィールドに次の苦情タイプが表示される場合があります。

フィールド名	説明
abuse	迷惑メールまたはその他のメール不正使用。
auth-failure	E メールの認証障害レポート
fraud	なんらかの詐欺またはフィッシング行為を示します。
not-spam	レポートの提供者がこのメッセージをスパムではないと見なしていることを示します。このタイプは、誤ってスパムとしてタグ付けまたは分類されたメッセージを修正するために使用される場合があります。
other	その他の登録されたタイプに該当しないフィードバックを示します。
virus	元のメッセージでウイルスが見つかったことを示します。

配信オブジェクト

Delivery イベントに関する情報を含むJSONオブジェクトには、常に次のフィールドがあります。

フィールド名	説明
timestamp	Amazon が E メールを受信者のメールサーバーにSES配信した日時を ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) で表します。
processingTimeMillis	Amazon が送信者からのリクエストSESを受け入れてから、Amazon がメッセージを受信者のメールサーバーに渡SESしたまでの時間をミリ秒単位で表します。
recipients	配信イベントの適用対象となる受信者のリスト。
smtpResponse	Amazon からの E メールを受け入れISPたリモートのSMTP応答メッセージSES。このメッセージは、E メール、メールサーバー、および の受信によって異なりますISP。
reportingMTA	SES メールを送信した Amazon メールサーバーのホスト名。

Send オブジェクト

send イベントに関する情報を含むJSONオブジェクトは常に空です。

Reject オブジェクト

Reject イベントに関する情報を含むJSONオブジェクトには、常に次のフィールドがあります。

フィールド名	説明
reason	メールが拒否された理由。指定できる値は のみです。つまりBad content、Amazon は E メールにウイルスが含まれていることをSES検出しました。メッセージが拒否されると、Amazon はメッセージの処理SESを停止し、受信者のメールサーバーへの配信を試みません。

Open オブジェクト

Open イベントに関する情報を含むJSONオブジェクトには、常に次のフィールドが含まれます。

フィールド名	説明
ipAddress	受信側の IP アドレス
timestamp	オープンイベントが ISO8601 形式で発生した日時 (YYYY-MM-DDThh:mm:ss.sZ）。
userAgent	受取人がメールを開くために使用したしたデバイスまたは E メールクライアントのユーザーエージェント。

Click オブジェクト

Click イベントに関する情報を含むJSONオブジェクトには、常に次のフィールドが含まれます。

フィールド名	説明
ipAddress	受信側の IP アドレス
timestamp	クリックイベントが ISO8601 形式で発生した日時 (YYYY-MM-DDThh:mm:ss.sZ）。
userAgent	受信者が E メールのリンクをクリックするために使用したクライアントのユーザーエージェント。
link	受信者がクリックしたリンクURLの 。
linkTags	ses:tags 属性を使用してリンクに追加されたタグのリスト。メール内のリンクにタグを追加する方法については、「Amazon SES E メール送信メトリクスに関するよくある質問」の「Q5. リンクに一意の識別子をタグ付けできますか?」を参照してください。

レンダリング失敗オブジェクト

Rendering Failure イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。

フィールド名	説明
templateName	E メールの送信に使用されるテンプレートの名前。
errorMessage	レンダリング失敗に関する詳細情報を提供するメッセージ。

DeliveryDelay オブジェクト

DeliveryDelay イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。

フィールド名	説明
delayType	遅延のタイプ。可能な値は以下のとおりです。 InternalFailure – Amazon の内部SES問題により、メッセージが遅延しました。 全般 — SMTP会話中に一般的な障害が発生しました。 MailboxFull – 受信者のメールボックスがいっぱいで、追加のメッセージを受信できません。 SpamDetected – 受信者のメールサーバーが、アカウントから大量の未承諾 E メールを検出しました。 RecipientServerError – 受信者の E メールサーバーで一時的な問題が発生し、メッセージの配信が妨げられています。 IPFailure – メッセージを送信している IP アドレスが、受信者の E メールプロバイダーによってブロックまたはスロットリングされています。 TransientCommunicationFailure – 受信者の E メールプロバイダーとのSMTP会話中に一時的な通信障害が発生しました。 BYOIPHostNameLookupUnavailable — Amazon SES は IP アドレスのDNSホスト名を検索できませんでした。このタイプの遅延は、Bring Your Own IP を使用する場合にのみ発生します。 未確定 — Amazon SESは配信遅延の原因を特定できませんでした。 SendingDeferral — Amazon SESは、メッセージを内部的に延期することが適切であると判断しました。
delayedRecipients	E メールの受取人に関する情報を含むオブジェクト。
expirationTime	Amazon SESがメッセージの配信を停止する日時。この値は 8601 ISO 形式で表示されます。
reportingMTA	遅延を報告したメッセージ転送エージェント (MTA) の IP アドレス。
timestamp	遅延が発生した日時。8601 ISO 形式で表示されます。

遅延受取人

delayedRecipients オブジェクトには、以下の値が含まれています。

フィールド名	説明
emailAddress	メッセージの配信が遅れる原因となった E メールアドレス。
status	配信遅延に関連するSMTPステータスコード。
diagnosticCode	受信側の Message Transfer Agent () によって提供される診断コードMTA。

サブスクリプションオブジェクト

Subscription イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。

フィールド名	説明
contactList	連絡先が含まれているリストの名前。
timestamp	がサブスクリプション通知ISPを送信したときの ISO8601 形式 （YYYY-MM-DDThh:mm:ss.sZ) の日付と時刻。
source	メッセージが送信された E メールアドレス (エンベロープMAILFROMアドレス）。
newTopicPreferences	連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定するJSONデータ構造 (マップ）。変更後のステータスを示します (連絡先がサブスクライブまたはサブスクライブ解除）。
oldTopicPreferences	連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定するJSONデータ構造 (マップ）。変更前のステータス (連絡先がサブスクライブまたはサブスクライブ解除) を示します。

新旧トピックの設定

newTopicPreferences および oldTopicPreferences オブジェクトには、以下の値が含まれています。

フィールド名	説明
unsubscribeAll	連絡先リストのすべてのトピックから、連絡先がサブスクライブ解除されているかどうかを指定します。
topicSubscriptionStatus	指定されたイベントタイプの から通知を受信するように現在サブスクライブされているかどうかを示す topicNameフィールドで、トピックSESのサブスクリプションステータスを指定します。指定できる値は、 subscriptionStatusフィールドの OptIn (サブスクライブ) または OptOut (サブスクライブ解除) です。
topicDefaultSubscriptionStatus	イベント送信先に追加された新しいトピックがデフォルトでサブスクライブされるか、サブスクライブ解除されるかを決定するtopicNameフィールドで、トピックのデフォルトのサブスクリプションステータスを指定します。指定できる値は、 subscriptionStatusフィールドで OptIn (デフォルトでサブスクライブ) または OptOut (デフォルトでサブスクライブ解除) です。