Amazon SESイベント発行を使用して E メール送信をモニタリングする

E メール送信を詳細レベルで追跡できるようにするには、定義した特性 EventBridge に基づいて Amazon 、Amazon Data Firehose CloudWatch、Amazon Pinpoint、Amazon Simple Notification Service、または Amazon に E メール送信イベントを発行SESするように Amazon を設定できます。

送信、配信、オープン、クリック、バウンス、苦情、拒否、レンダリングの失敗、配信遅延など、さまざまな種類の E メール送信イベントを追跡できます。この情報は、運用と分析の目的で役立ちます。例えば、E メール送信データを に発行 CloudWatch し、E メールキャンペーンのパフォーマンスを追跡するダッシュボードを作成したり、Amazon SNS を使用して特定のイベントが発生したときに通知を送信したりできます。

イベント発行が設定セットとメッセージタグと連携する方法

イベント発行を使用するには、まず 1 つ以上の設定セットをセットアップします。設定セットは、イベントの発行先の場所と発行するイベントを指定します。その後、メールを送信するたびに、設定セットの名前と 1 つ以上のメッセージタグを名前と値のペアの形式で指定し、メールを分類します。たとえば、書籍を宣伝する場合、関連するキャンペーンのメールを送信するときに、メッセージタグに genre という名前を付け、値 sci-fi または western を割り当てることができます。

使用する E メール送信インターフェイスに応じて、 SendEmailAPIオペレーションの EmailTagsフィールドにメッセージタグをパラメータとして指定するか、SES特定の E メールヘッダー にメッセージタグを追加しますX-SES-MESSAGE-TAGS。設定セットの詳細については、Amazon での設定セットの使用 SESを参照ください。

指定したメッセージタグに加えて、 は送信したメッセージに自動タグSESも追加します。自動タグを使用するために追加のステップを実行する必要はありません。

次の表に、 を使用して送信するメッセージに自動的に適用される自動タグを示しますSES。

SES の自動タグ

自動タグ名	説明
ses:caller-identity	E メールを送信したSESユーザーの IAM ID。
ses:configuration-set	E メールに関連付けられた設定セットの名前。
ses:from-domain	「From」アドレスのドメイン。
ses:outgoing-ip	E メールの送信SESに使用した IP アドレス。
ses:source-ip	呼び出し元がメールの送信に使用した IP アドレス。
ses:source-tls-version	発信者が E メールの送信に使用したTLSプロトコルバージョン。
ses:outgoing-tls-version	E メールの送信SESに使用したTLSプロトコルバージョン。

E メールキャンペーンのきめ細かなフィードバック

ses:feedback-id-<a or b> タグは、ハイブリッドタグまたは半自動タグと考えることができるオプションのメッセージタグです。前のセクションで説明した自動タグと似ていますが、違いは、手動で追加してses:プレフィックスキーを使用する必要があることです。ses:feedback-id-a および として定義されるこれらのタグのうち、最大 2 つを使用できますses:feedback-id-b。

これらのタグを指定すると、 は、フィードバックループ (FBL) の一部として、苦情やスパムレートなどの配信統計を提供するために使用される標準Feedback-IDヘッダーSESに自動的に追加します。「」を参照してくださいフィードバックループ。Feedback-ID ヘッダーは、SES苦情情報の収集SESInternalIDに使用される識別子 と、送信プラットフォームSESとして識別する静的タグ Amazon SESで構成されます。

FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))

これらのオプションのフィードバック ID タグは、E メールキャンペーンの一部として送信するメッセージなど、きめ細かなフィードバックを生成する方法として提供されます。次の例に示すように、SendEmailオペレーションリクエストの EmailTags フィールドにメッセージタグとして指定ses:feedback-id-<a or b>することで を使用できます。

{
  "FromEmailAddress": "[e-mail]",
  "Destination": {
    "ToAddresses": [
      "[e-mail]"
    ]
  },
  "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"
}

raw 形式で送信する場合は、 をメッセージタグses:feedback-id-<a or b>として SESに固有のヘッダー に追加しますX-SES-MESSAGE-TAGS。

ses:feedback-id-<a or b> メッセージタグは、他のメッセージタグと同様に CloudWatch 値ソースとして指定 CloudWatch することで Amazon で追跡することもできます CloudWatch イベント送信先の追加。 (追加料金が適用されます。「 のメトリクスあたりの料金 CloudWatch」を参照してください。）

イベント発行を使用する方法

以下のセクションには、SESイベントパブリッシングを設定して使用するために必要な情報が含まれています。

• イベント発行のセットアップ

• イベントデータの使用

イベント発行の用語

次のリストでは、SESイベント発行に関連する用語を定義します。

メール送信イベント

に送信する E メールの結果に関連する情報SES。以下に示しているのは、送信イベントです。

• 送信 – 送信リクエストは成功し、Amazon SESは受信者のメールサーバーにメッセージを配信しようとします。（アカウントレベルまたはグローバルサプレッションが使用されている場合、 SES は送信としてカウントしますが、配信は抑制されます。）

• RenderingFailure – テンプレートのレンダリングに問題があるため、E メールは送信されませんでした。このイベントタイプは、テンプレートデータが見つからない場合や、テンプレートのパラメータとデータが一致しない場合に発生します。（このイベントタイプは、 SendTemplatedEmailまたは SendBulkTemplatedEmailAPIオペレーションを使用して E メールを送信する場合にのみ発生します。）

• 拒否 – Amazon は E メールSESを受け入れましたが、ウイルスが含まれていると判断し、受信者のメールサーバーに配信しようとしませんでした。

• 配信 – Amazon は受信者のメールサーバーに E メールをSES正常に配信しました。

• バウンス – ハードバウンスにより、受信者のメールサーバーが E メールを完全に拒否しました。（ソフトバウンスは、 SES が E メールの配信を再試行しなくなった場合にのみ含まれます。 通常、これらのソフトバウンスは配信失敗を示しますが、メールが受信者の受信トレイに正常に届いた場合でも、場合によってはソフトバウンスが返されることがあります。 これは通常、受信者が out-of-office自動返信を送信したときに発生します。 ソフトバウンスの詳細については、この AWS re:Post 記事 を参照してください。）

• 苦情— Eメールは受信者のメールサーバーに正常に配信されましたが、受信者はスパムとしてマークしました。

• DeliveryDelay – 一時的な問題が発生したため、E メールを受信者のメールサーバーに配信できませんでした。配信の遅延は、受信者の受信トレイがいっぱいになった場合や、受信側の電子メールサーバーで一時的な問題が発生した場合などに発生します。

• サブスクリプション— メールは正常に配信されましたが、受信者がEメールヘッダーの List-Unsubscribe またはフッターの Unsubscribe リンクをクリックし、サブスクリプションの設定を更新しました。

• オープン – 受信者がメッセージを受け取り、E メールクライアントで開きました。

• クリック – 受信者はメール内の 1 つ以上のリンクをクリックしました。

設定セット

E メール送信イベントSESを発行する送信先と、発行する E メール送信イベントのタイプを定義する一連のルール。イベント発行で使用するメールを送信するとき、メールに関連付ける設定セットを指定します。

イベント送信先

E SESメール送信イベントを発行する AWS サービス。セットアップする各イベントの宛先は、設定セット 1 つだけに帰属しています。

メッセージタグ

イベント発行の目的でメールの分類に使用する名前と値のペア。たとえば、campaign/book や campaign/clothing などです。E メールを送信するときは、メッセージタグをAPI呼び出しのパラメータとして、または SES固有の E メールヘッダーとして指定します。

自動タグ

イベント発行レポートに自動的に含まれるメッセージタグ。設定セット名、「From」アドレスのドメイン、発信者の送信 IP アドレス、SES送信 IP アドレス、発信者の IAM ID には自動タグがあります。