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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

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

最上位JSONオブジェクト

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

フィールド名 説明

eventType

イベントのタイプを説明する文字列。可能な値: BounceComplaintDeliverySendRejectOpenClickRendering FailureDeliveryDelay、または Subscription

もしイベント発行のセットアップをしなかった場合は、このフィールドは notificationType と名付けられます。

mail

イベントを生成した E メールに関する情報を含むJSONオブジェクト。

bounce

このフィールドは、eventTypeBounce の場合のみ表示されます。このフィールドには、バウンスに関する情報が含まれています。

complaint

このフィールドは、eventTypeComplaint の場合のみ表示されます。このフィールドには、苦情に関する情報が含まれています。

delivery

このフィールドは、eventTypeDelivery の場合のみ表示されます。このフィールドには、配信に関する情報が含まれています。

send

このフィールドは、eventTypeSend の場合のみ表示されます。

reject

このフィールドは、eventTypeReject の場合のみ表示されます。このフィールドには、拒否に関する情報が含まれています。

open

このフィールドは、eventTypeOpen の場合のみ表示されます。このフィールドには、オープンイベントに関する情報が含まれています。

click

このフィールドは、eventTypeClick の場合のみ表示されます。このフィールドには、クリックイベントに関する情報が含まれています。

failure

このフィールドは、eventTypeRendering Failure の場合のみ表示されます。このフィールドには、レンダリング失敗イベントに関する情報が含まれています。

deliveryDelay

このフィールドは、eventTypeDeliveryDelay の場合のみ表示されます。E メールの遅延配信に関する情報が含まれています。

subscription

このフィールドは、eventTypeSubscription の場合のみ表示されます。このフィールドには、サブスクリプション設定に関する情報が含まれています。

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 (デフォルトでサブスクライブ解除) です。