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

# Amazon SES イベント発行を使用して E メール送信をモニタリングする
<a name="monitor-using-event-publishing"></a>

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

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

## イベント発行が設定セットとメッセージタグと連携する方法
<a name="event-publishing-how-works"></a>

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

使用する E メール送信インターフェースに応じて、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) API オペレーションの [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) フィールドにパラメータとしてメッセージタグを指定するか、SES 固有の E メールヘッダーである [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) にメッセージタグを追加します。設定セットの詳細については、[Amazon SES の設定セットの使用](using-configuration-sets.md)を参照ください。

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

SES を使用して送信するメッセージに自動的に適用される自動タグの一覧は、次の表のとおりです。


**SES 自動タグ**  

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

## E メールキャンペーンのきめ細かなフィードバック
<a name="event-publishing-fine-grained-feedback"></a>

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

これらのタグを指定すると、SES は、フィードバックループ (FBL) の一環として苦情やスパム率などの配信統計を提供するために使用される標準の `Feedback-ID` ヘッダーにこのようなタグを自動的に追加します。「[フィードバックループ](faqs-enforcement.md#cm-feedback-loop)」を参照してください。`Feedback-ID` ヘッダーは、SES が苦情情報を収集するために使用する識別子である *SESInternalID* と、以下に示すような、SES を送信プラットフォームとして識別する静的タグ *AmazonSES* で構成されます。

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

これらのオプションのフィードバック ID タグは、E メールキャンペーンの一環として送信するメッセージなど、きめ細かいフィードバックを生成する方法として提供されています。次の例で説明されるとおり、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) オペレーションリクエストの [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) フィールドにメッセージタグとして指定することで、`ses:feedback-id-<{{a}} or {{b}}>` を使用できます。

```
{
  "FromEmailAddress": "noreply@example.com",
  "Destination": {
    "ToAddresses": [
      "customer@example.net"
    ]
  },
  "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 固有のヘッダーである [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers) に `ses:feedback-id-<{{a}} or {{b}}>` をメッセージタグとして追加します。

メッセージタグ `ses:feedback-id-<{{a}} or {{b}}>` は、その他のメッセージタグと同様、CloudWatch 値のソースとして指定すると、Amazon CloudWatch で追跡することもできます。「[CloudWatch Event 送信先の追加](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add)」を参照してください (追加料金が発生します。「[CloudWatch のメトリクスあたりの料金](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)」を参照してください)。**

## イベント発行を使用する方法
<a name="event-publishing-how-to-use"></a>

以下のセクションでは、SES イベント発行のセットアップと使用に必要な情報が記載されています。
+ [イベント発行のセットアップ](monitor-sending-using-event-publishing-setup.md)
+ [イベントデータの使用](working-with-event-data.md)

## イベント発行の用語
<a name="event-publishing-terminology"></a>

SES イベント発行に関連する用語の定義は、以下のリストのとおりです。

**メール送信イベント**  
SES に送信した E メールの結果に関連付けられた情報。以下に示しているのは、送信イベントです。  
+ **送信数**— 送信リクエストが成功すると、Amazon SES はそのメッセージを受信者のメールサーバーに配信しようと試行します。(アカウントレベルまたはグローバル抑制が使用されている場合でも、SES により送信済みとしてカウントされますが、配信は抑制されます)。
+ **レンダリング失敗** – テンプレートのレンダリング問題により、E メールが送信されませんでした。このイベントタイプは、テンプレートデータが見つからない場合や、テンプレートのパラメータとデータが一致しない場合に発生します。（このイベントタイプは、[https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) または [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html) API オペレーションを使用して E メールを送信する場合にのみ発生します。）
+ **拒否** - Amazon SESは E メールを受け取りましたが、この E メールにウイルスが含まれていると判断して拒否したため、受信者のメールサーバーに E メール配信を試みませんでした。
+ **配信** - Amazon SES は、受取人のメールサーバーにメールを正常に配信しました。
+ **バウンス** – *ハードバウンス*により、受信者のメールサーバーが E メールを完全に拒否しました。(*ソフトバウンス*は、SES が E メールの配信を再試行しない場合にのみ含まれます。通常、これらのソフトバウンスは配信障害を示しますが、メールが受信者の受信トレイに正常に届いた場合でも、場合によってはソフトバウンスが返されることがあります。これは通常、受信者が不在の自動返信を送信した場合に発生します。ソフトバウンスの詳細については、この [AWS re:Post 記事](https://repost.aws/knowledge-center/ses-understand-soft-bounces)を参照してください)。
+ **苦情**— Eメールは受信者のメールサーバーに正常に配信されましたが、受信者はスパムとしてマークしました。
+ **配信の遅延** – 一時的な問題が発生したため、メールを受信者のメールサーバーに配信できませんでした。配信の遅延は、受信者の受信トレイがいっぱいになった場合や、受信側の電子メールサーバーで一時的な問題が発生した場合などに発生します。
+ **サブスクリプション**— メールは正常に配信されましたが、受信者がEメールヘッダーの `List-Unsubscribe` またはフッターの `Unsubscribe` リンクをクリックし、サブスクリプションの設定を更新しました。
+ **オープン** – 受信者がメッセージを受け取り、E メールクライアントで開きました。
+ **クリック** – 受信者はメール内の 1 つ以上のリンクをクリックしました。

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

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

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

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