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を参照ください。

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

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

Amazon SES Auto-Tags
自動タグ名	説明
ses:caller-identity	E メールを送信した Amazon SES ユーザーの IAM ID。
ses:configuration-set	E メールに関連付けられた設定セットの名前。
ses:from-domain	「From」アドレスのドメイン。
ses:outgoing-ip	Amazon が E メールの送信SESに使用した IP アドレス。
ses:source-ip	呼び出し元がメールの送信に使用した IP アドレス。
ses:source-tls-version	発信者が E メールの送信に使用した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」を参照してください）。

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

以下のセクションには、Amazon SESイベント発行をセットアップして使用するために必要な情報が含まれています。

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

• イベントデータの使用

イベント発行の用語

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

メール送信イベント

Amazon に送信する 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 つ以上のリンクをクリックしました。

設定セット

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

イベント送信先

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

メッセージタグ

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

自動タグ

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