翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Virtual Deliverability Manager ダッシュボード
このダッシュボードには、開封/クリック、配信率、バウンス/クレーム統計を通じて配信性能や評価を読みやすいカードや時系列グラフなどで示す、アカウントの配信性能プログラムの概要が表示されます。ダッシュボードにはさらに詳細なビューが表示されるため、特定の ISP、送信 ID、E メールキャンペーンに関連する設定セットに関して問題がある場合に、より詳細な特定の表データにドリルダウンできます。
全体的な概要を確認できるほか、特定の詳細も表示できるため、E メールプログラム全体を見直すことなく、配信性能で問題のある領域に焦点を合わせることができます。また、このレベルのインサイトにより、遅延やブロックなど配信性能の大きな問題に発展する前に、傾向や潜在的な問題を把握できます。
カードと時系列グラフを示す Virtual Deliverability Manager ダッシュボードのアカウント概要
![\[カードと時系列グラフを示す Virtual Deliverability Manager ダッシュボードのアカウント概要\]](http://docs.aws.amazon.com/ja_jp/ses/latest/dg/images/vdm_db_overview_1.png)
日付範囲およびフィルター条件に一致する送信済みメッセージを示す Virtual Deliverability Manager ダッシュボードで選択された*メッセージ*テーブル。
![\[日付範囲およびフィルター条件に一致する送信済みメッセージを示す Virtual Deliverability Manager ダッシュボードで選択されたメッセージテーブル。\]](http://docs.aws.amazon.com/ja_jp/ses/latest/dg/images/vdm_db_overview_2.png)
ダッシュボードが提供する詳細なデータは、特定のデータセットにドリルダウンできるため、送信者の評価の向上や、E メールプログラムでのエンゲージメントとコンバージョンを向上させるのに最適な日時の算出に役立ちます。
+ **ISP データ** – 特定の ISP やメールボックスプロバイダーへの配信性能に問題がある場合に役に立ちます。それがなければ問題がない可能性があるアカウント全体の調整を試みる代わりに、問題のあるエンドポイントに集中し、そのベストプラクティスに沿って ISP に対する送信者の評価を高め、受信者に届くよう、受信トレイへの良好な配信性能を回復させることができます。また、1 つの ISP やメールボックスプロバイダーへの送信量が他の ISP またはメールボックスプロバイダーよりも多くなる場合があるため、ISP のディストリビューションを理解することも重要です。E メールのコンバージョンにプラスの影響を与えるには、トラフィックが常に最終の受信者に配信され、エンゲージメントが発生していることを確認する必要があります。
+ **ID および設定セットデータの送信** – アカウント配信に関する全体的な問題の原因となっている送信 ID と設定セットを特定するのに役立ちます。これらの問題に特に集中して設定を調整し、問題が解決するまで特定の ID で送信する回数を減らすことができます。例えば、送信 ID が誤ってサプレッションリストに送信され、すべてのトラフィックがその ID を通過するとします。その ID は設定セットと関連付けられているため、配信性能の問題が発生します。このような場合、送信 ID または設定セットを特定できれば、配信性能の問題の根本原因を特定するためにアカウント全体をくまなく調べるよりも、問題の修正に集中できるため有用です。
Virtual Deliverability Manager ダッシュボードに、選択した送信 ID (*example.com*) のドリルダウンデータが表示されます。カードには、配信性能と評価のメトリクスが表示されます。この表には、送信 ID が E メールを送信したすべての ISP が、入力された日付範囲内の各 ISP のメトリクス率とともに表示されます。
![\[Virtual Deliverability Manager ダッシュボードに、選択した送信 ID (example.com) のドリルダウンデータが表示されます。カードには、配信性能と評価のメトリクスが表示されます。この表には、送信 ID が E メールを送信したすべての ISP が、入力された日付範囲内の各 ISP のメトリクス率とともに表示されます。\]](http://docs.aws.amazon.com/ja_jp/ses/latest/dg/images/vdm_db_ident_drill_sort_export.png)
## Amazon SES コンソールでの Virtual Deliverability Manager ダッシュボードの使用
以下の手順は、Amazon SES コンソールで Virtual Deliverability Manager ダッシュボードを使用して、全体的な配信性能と評価の統計を表示し、問題のある領域をドリルダウンする方法を示します。
**Virtual Deliverability Manager ダッシュボードを使用して、アカウントの配信性能メトリクスの概要と詳細を表示できます。**
1. AWS マネジメントコンソール にサインインし、Amazon SES コンソール ([https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)) を開きます。
1. 左側のナビゲーションペインで、[**Virtual Deliverability Manager**] の下の [**ダッシュボード**] を選択します。
**注記**
アカウントで Virtual Deliverability Manager を有効にしていない場合、[**ダッシュボード**] は表示されません。詳細については、「[Virtual Deliverability Manager の使用開始](vdm-get-started.md)」を参照してください。
ダッシュボードメトリクスは、ほぼリアルタイムで表示されます。
ダッシュボードメッセージは、送信時間から数分以内に表示されます。
1. **[アカウント全体の概要]** パネルで、カード、時系列グラフ、ドリルダウンテーブルのすべてのメトリクスに使用する日付範囲を選択します。
1. [**日付範囲**] フィールドで、[**相対範囲**] (デフォルト) または [**絶対範囲**] を選択します。
+ **相対範囲** – 希望の日数に対応するラジオボタンを選択します。
+ *カスタム範囲* – 日 (最大 60 日)、週 (最大 8 週間)、または月 (最大 2 か月) の範囲を入力します。
+ **絶対範囲** – 最初に選択した日付が *[開始日]*、2 番目の日付が *[終了日]* となります。合計が 60 日を超えないようにしてください。1 日を指定するには、[*開始日*] と [*終了日*] の両方でその日を選択します。
**注記**
以下はダッシュボードのすべての日付範囲に適用されます。
すべての日時は UTC です。
[**相対範囲**] の日付の場合、最終日は UTC の午前 0 時のタイムスタンプで終了します。例えば、[*Last 7 days*] (過去 7 日間) を選択すると、7 日目は昨日の午前 0 時に終了することになります。
日付範囲が 30 日を超える場合、*[アカウント統計]* テーブルの *[差異率]* とカードの変更率には値が入力されません (ダッシュ `-` で示されます)。
1. カード、時系列グラフ、すべてのドリルダウンテーブル、*[アカウント統計]*、*[ISP]*、*[送信 ID]*、および *[設定セット]* では、入力した日付範囲から計算されたメトリクス合計が表示され、「[ダッシュボードメトリクスの計算方法](#vdm-dashboard-rates)」で説明されているメトリクス計算が使用されます。
+ *[ISP]*、*[送信 ID]*、または *[設定セット]* 表のいずれかで現在表示しているデータのローカル `.csv` ファイルを作成するには、その **[エクスポート]** ボタンを選択します。
1. 入力した日付範囲の **[ボリューム]** と **[レート]** の推移を示す時系列グラフが **[メトリクス]** ペインに表示されます。グラフの日付間隔にカーソルを合わせると、日次集計に基づく正確なボリューム数またはレートパーセンテージが表示されます。*[メトリクスを選択してください]* ドロップダウンを使用して、表示したいメトリクスを絞り込むことができます。
1. [**アカウント**] タブを選択すると、[**アカウント統計**] 表が表示されます。
+ この表には、入力した日付範囲から計算された *[送信済み]*、*[配信済み]*、*[苦情]*]、*[一時的/永続的なバウンス]*、*[開封とクリック]* の合計 **[件数]**、**[発生率]**、**[差異率]** を示す、配信と評価のメトリクスの概要が表示されます。
**注記**
日付範囲が 30 日を超える場合、*[差異率]* には値が入力されません (ダッシュ `-` で示されます)。
1. [**ISP**] タブを選択して [**ISP**] 表を表示します。
+ この表には、送信先の ISP ごとに、入力した日付範囲から計算された *[送信量]*、*[配信済み]*、*[一時的/永続的なバウンス]*、*[苦情]*、*[開封とクリック]* のメトリクスが表示されます。
+ 特定の ISP をフィルタリングするには、*[ISP の比較]* 検索ボックス内で、含める各 ISP に対応するチェックボックスをオンにします。
+ このテーブルで現在表示しているデータのローカル `.csv` ファイルを作成するには、その **[エクスポート]** ボタンを選択します。
1. [**Sending identities**] (送信 ID) タブを選択して、[**Sending identities**] (送信 ID) 表を表示します。
+ この表には、使用した各送信 ID ごとに、入力した日付範囲から計算された *[送信量]*、*[配信済み]*、*[一時的/永続的なバウンス]*、*[苦情]*、*[開封とクリック]* のメトリクスが表示されます。
+ 特定の送信 ID をフィルタリングするには、*[ID の比較]* 検索ボックス内で、含める各 ID に対応するチェックボックスをオンにします。
+ 特定の送信 ID をドリルダウンするには、[**Sending identity**] (送信 ID) 列でその名前を選択します。
+ 選択された送信 ID について、入力した日付範囲から計算された *[配信率]*、*[苦情]*、*[一時的/永続的なバウンス]*、*[開封とクリック]* を示すカードが表示されます。
+ 時系列グラフが更新され、入力した日付範囲から計算された、選択済み送信 ID のすべてのメトリクスが表示されます。
+ 送信 ID が E メールを送信したすべての ISP と、入力された日付範囲から計算された各 ISP のメトリクスを一覧表示する ISP の表が表示されます。
+ このテーブルで現在表示しているデータのローカル `.csv` ファイルを作成するには、その **[エクスポート]** ボタンを選択します。
1. [**設定セット**] タブを選択して [**設定セット**] 表を表示します。
+ この表には、E メールの送信に使用された各設定セットについて、入力した日付範囲から計算された *[送信量]*、*[配信済み]*、*[一時的/永続的なバウンス]*、*[苦情]*、*[開封とクリック]* のメトリクスが表示されます。
+ 特定の設定セットをフィルタリングするには、*[設定セットの比較]* 検索ボックス内で、含める各設定セットに対応するチェックボックスを選択します。
+ 特定の設定セットを詳しく調べるには、[**設定セット**] 列でその名前を選択します。
+ 選択された設定セットについて、入力した日付範囲から計算された *[配信率]*、*[苦情]*、*[一時的/永続的なバウンス]*、*[開封とクリック]* を示すグラフィックカードが表示されます。
+ 時系列グラフが更新され、入力した日付範囲から計算された、選択済み設定セットのすべてのメトリクスが表示されます。
+ 入力された日付範囲から計算された、各 ISP で指定されたメトリクスで E メールの送信に設定セットが使用された、すべての ISP を一覧表示する ISP の表が表示されます。
+ このテーブルで現在表示しているデータのローカル `.csv` ファイルを作成するには、その **[エクスポート]** ボタンを選択します。
1. **[メッセージ]** タブを選択して、**[メッセージ]** テーブルを表示します。
これは、送信済みメッセージを検索して見つけることができる、インタラクティブなテーブルです。各メッセージについて、現在の配信ステータス、エンゲージメントステータス、イベント履歴を追跡したり、メールボックスプロバイダーから返されたレスポンスを確認したりできます。特定のメッセージを検索する方法のポイントは、以下のとおりです。
+ 日付範囲選択ツール内で日付範囲を選択すると、過去 30 日間に送信したメッセージをフィルタリングできます。日付範囲を選択しない場合、デフォルトの検索範囲は、タイムゾーン内の現在の日付を含む過去 7 日間になります。
+ *[メッセージを検索]* フィールドでは、*[受信者]*、*[送信元アドレス]*、*[件名]*、*[ISP]*、*[エンゲージメントイベント]*、*[配信イベント]*、および *[メッセージ ID]* でフィルタリングでき、以下のプロパティが適用されます。
+ フィルタータイプに応じて、大文字と小文字を区別してテキスト文字列を入力するか、リストから値を選択します。
+ *[エンゲージメントイベント]* は 1 つの値に限定されます。*[件名]* には 1 回の検索で最大 2 つの値を指定でき、他のすべてのフィルターには最大 5 つの値を指定できます。*[メッセージ ID]* によるフィルタリングでは、日付範囲など、選択した他のフィルターはすべて除外されます。
+ *[メッセージ ID]* 列はデフォルトでは非表示になっていますが、歯車アイコンを選択して、**[メッセージ]** テーブルを表示する方法をカスタマイズすることで、表示できます。
+ フィルターと日付範囲を選択し、**[検索]** を選択すると、検索条件に一致するメッセージがテーブルに入力されます。このテーブルには最大 100 件のメッセージをロードできます。*検索で 100 件を超えるメッセージが返された場合、テーブル内の 100 件のメッセージは、返されたメッセージの合計から無作為に抽出したものです。*
+ **[詳細を表示]** を選択した後にメッセージのラジオボタンを選択すると、**[メッセージ情報]** サイドバーが表示されます。このサイドバーには、メッセージの完全なイベント履歴の詳細が新しい順に表示されるほか、メールボックスプロバイダーから返されたレスポンスまたは診断コードが表示されます。
+ このテーブルで現在表示しているデータのローカル `.csv` ファイルを作成するには、その **[エクスポート]** ボタンを選択します。
## を使用した Virtual Deliverability Manager メトリクスデータへのアクセス AWS CLI
次の例は、 AWS CLIを使用して Virtual Deliverability Manager のメトリクスデータにアクセスする方法を示しています。これは、コンソールの Virtual Deliverability Manager ダッシュボードで使用されているのと同じデータです。
**を使用して配信性能メトリクスデータにアクセスするには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_BatchGetMetricData.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_BatchGetMetricData.html) オペレーションを使用して、配信性能メトリクスデータにアクセスできます。次の例に示すように、このオペレーションは、 AWS CLI から呼び出すことができます。
+ 配信性能メトリクスデータにアクセスする:
```
aws --region us-east-1 sesv2 batch-get-metric-data --cli-input-json file://sends.json
```
+ 入力ファイルは、次のようになります。
```
{
"Queries": [
{
"Id": "Retrieve-Account-Sends",
"Namespace": "VDM",
"Metric": "SEND",
"StartDate": "2022-11-04T00:00:00",
"EndDate": "2022-11-05T00:00:00"
}
]
}
```
パラメータ値と関連するデータ型に関する詳細は、Amazon SES API v2 リファレンスの [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_BatchGetMetricDataQuery.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_BatchGetMetricDataQuery.html) データ型からリンクして確認できます。
## を使用した配信性能メトリクスデータのフィルタリングとエクスポート AWS CLI
この例は、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html) オペレーションを使用して、 AWS CLIにより配信性能メトリクスデータをフィルタリングし、.csv ファイルまたは.json ファイルにエクスポートする方法を示しています。これは、Virtual Deliverability Manager ダッシュボードの **[ISP]**、**[送信 ID]**、および **[設定セット]** の各テーブルで使用されているものと同じデータです。
**を使用して配信性能メトリクスデータをフィルタリングして .csv または .json ファイルにエクスポートするには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html) データ型と共に [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html) オペレーションを使用して、メトリクスデータをフィルタリングし、.csv ファイルまたは .json ファイルにエクスポートできます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出します。
+ 入力ファイルを使用して配信性能メトリクスデータをフィルタリングおよびエクスポートする:
```
aws --region us-east-1 sesv2 create-export-job --cli-input-json file://metric-export-input.json
```
+ この例では、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html) パラメータを使用して、E メールを送信したすべての ISP をフィルタリングし、指定した日付範囲内の配信成功率を表示します。出力ファイルには .csv 形式が指定されています。
```
{
"ExportDataSource": {
"MetricsDataSource": {
"Dimensions": {
"ISP": ["*"]
},
"Namespace": "VDM",
"Metrics": [
{
"Name": "DELIVERY",
"Aggregation": "RATE"
}
],
"StartDate": "2023-06-13T00:00:00",
"EndDate": "2023-06-20T00:00:00"
}
},
"ExportDestination": {
"DataFormat": "CSV"
}
}
```
パラメータ値と関連するデータ型に関する詳細は、「Amazon SES API v2 リファレンス」で、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ExportDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ExportDataSource.html) 型のオブジェクトとして [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MetricsDataSource.html) で確認できます。
## を使用して、送信されたメッセージ、配信とエンゲージメントのステータス、結果をエクスポートする AWS CLI
これらの例は、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html) オペレーションを使用して、 AWS CLIにより、送信した特定のメッセージを検索して見つける方法、その現在の配信ステータスやエンゲージメントステータスを確認する方法、および検索結果を .csv ファイルまたは .json ファイルにエクスポートする方法について示しています。これは、Virtual Deliverability Manager ダッシュボードの **[メッセージ]** テーブルで使用されているのと同じデータです。
**送信済みメッセージ、配信ステータス、エンゲージメントステータスを検索し、 を使用して結果を .csv または .json ファイルにエクスポートするには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) データ型と共に [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateExportJob.html) オペレーションを使用してフィルターを適用し、送信した特定のメッセージを見つけたり、その配信ステータスやエンゲージメントステータスを確認したり、結果を .csv ファイルまたは .json ファイルにエクスポートしたりできます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出します。
**注記**
フィルタリングした検索で 10,000 件を超えるメッセージが返された場合、API の結果セット内の 10,000 件のメッセージは、返されたメッセージの合計から無作為に抽出したものです。
+ 入力ファイルを使用して、送信済みメッセージを検索し、現在のステータスを確認し、結果をエクスポートする:
```
aws --region us-east-1 sesv2 create-export-job --cli-input-json file://message-insights-export-input.json
```
+ この例で、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) パラメータを使用して、件名が「Sale Ends Tonight\$1」と等しいメッセージをフィルタリングします。出力ファイルには .csv 形式が指定されています。
```
{
"ExportDataSource": {
"MessageInsightsDataSource": {
"StartDate": "2023-07-01T00:00:00",
"EndDate": "2023-07-10T00:00:00",
"Include": {
"Subject": [
"Sale Ends Tonight!"
]
}
}
},
"ExportDestination": {
"DataFormat": "CSV"
}
}
```
+ この例で、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) パラメータを使用して、件名が「Hello」で始まり、FromEmailAddress に「information」を含み、「@example.com」で終わる送信先に送信されたメッセージをフィルタリングします。出力ファイルには .json 形式が指定されています。
```
{
"ExportDataSource": {
"MessageInsightsDataSource": {
"StartDate": "2023-07-01T00:00:00",
"EndDate": "2023-07-10T00:00:00",
"Include": {
"Subject": [
"Hello*"
],
"FromEmailAddress": [
"*information*"
],
"Destination": [
"*@example.com"
]
}
}
},
"ExportDestination": {
"DataFormat": "JSON"
}
}
```
+ この例で、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) パラメータを使用して、件名が「Hello」で始まるメッセージをフィルタリングし、FromEmailAddress が「noreply@example.com」である結果を除外します。出力ファイルには .csv 形式が指定されています。
```
{
"ExportDataSource": {
"MessageInsightsDataSource": {
"StartDate": "2023-07-01T00:00:00",
"EndDate": "2023-07-10T00:00:00",
"Include": {
"Subject": [
"Hello*"
]
},
"Exclude": {
"FromEmailAddress": [
"noreply@example.com"
]
}
}
},
"ExportDestination": {
"DataFormat": "CSV"
}
}
```
+ この例で、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) パラメータを使用して、件名が「Hello」で始まり、FromEmailAddress に「information」を含み、「@example.com」で終わる送信先に送信され、ISP として Gmail を使用し、最終配信イベントが「DELIVERY」で、最終エンゲージメントイベントが「OPEN」または「CLICK」であるメッセージをフィルタリングします。出力ファイルには .json 形式が指定されています。
```
{
"ExportDataSource": {
"MessageInsightsDataSource": {
"StartDate": "2023-07-01T00:00:00",
"EndDate": "2023-07-10T00:00:00",
"Include": {
"Subject": [
"Hello*"
],
"FromEmailAddress": [
"*information*"
],
"Destination": [
"*@example.com"
],
"Isp": [
"Gmail"
],
"LastDeliveryEvent": [
"DELIVERY"
],
"LastEngagementEvent": [
"OPEN", "CLICK"
]
}
}
},
"ExportDestination": {
"DataFormat": "JSON"
}
}
```
+ この例で、入力ファイルは [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) パラメータを使用して、送信先が「@example1.com」、「@example2.com」、または「@example3.com」で終わるメッセージをフィルタリングし、LastDeliveryEvent が「SEND」または「DELIVERY」と等しいメッセージを除外します。出力ファイルには .csv 形式が指定されています。
```
{
"ExportDataSource": {
"MessageInsightsDataSource": {
"StartDate": "2023-07-01T00:00:00",
"EndDate": "2023-07-10T00:00:00",
"Include": {
"Destination": [
"*@example1.com",
"*@example2.com",
"*@example3.com"
]
},
"Exclude": {
"LastDeliveryEvent": [
"SEND",
"DELIVERY"
]
}
}
},
"ExportDestination": {
"DataFormat": "CSV"
}
}
```
パラメータ値と関連するデータ型に関する詳細は、「Amazon SES API v2 リファレンス」で、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ExportDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ExportDataSource.html) 型のオブジェクトとして [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MessageInsightsDataSource.html) で確認できます。
## を使用したエクスポートジョブの管理 AWS CLI
これらの例は、 AWS CLIを使用して、一覧表示、情報の取得、およびキャンセルにより、エクスポートジョブを管理する方法について示しています。
**を使用してエクスポートジョブを一覧表示するには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListExportJobs.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListExportJobs.html) オペレーションを使用して、エキスポートジョブを一覧表示できます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出すことができます。
+ エクスポートジョブを一覧表示する:
```
aws --region us-east-1 sesv2 list-export-jobs --export-source-type=METRICS_DATA
```
```
aws --region us-east-1 sesv2 list-export-jobs --job-status=CREATED
```
```
aws --region us-east-1 sesv2 list-export-jobs --cli-input-json file://list-export-jobs-input.json
```
+ 入力ファイルは、次のようになります。
```
{
"NextToken": "",
"PageSize": 0,
"ExportSourceType": "METRICS_DATA",
"JobStatus": "CREATED"
}
```
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListExportJobs.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListExportJobs.html) オペレーションのパラメータ値に関する詳細情報については、「Amazon SES API v2 リファレンス」に記載されています。
**を使用してエクスポートジョブに関する情報を取得するには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetExportJob.html) オペレーションを使用して、エキスポートジョブに関する情報を取得できます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出すことができます。
+ エクスポートジョブに関する情報を取得する:
```
aws --region us-east-1 sesv2 get-export-job --job-id=
```
```
aws --region us-east-1 sesv2 get-export-job --cli-input-json file://get-export-job-input.json
```
+ 入力ファイルは、次のようになります。
```
{
"JobId": "e2220d6b-dce5-45f2-bf60-3287a465b732"
}
```
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetExportJob.html) オペレーションのパラメータ値に関する詳細情報については、「Amazon SES API v2 リファレンス」に記載されています。
**を使用してエクスポートジョブをキャンセルするには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CancelExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CancelExportJob.html) オペレーションを使用して、エキスポートジョブをキャンセルできます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出すことができます。
+ エクスポートジョブをキャンセルする:
```
aws --region us-east-1 sesv2 cancel-export-job --job-id=
```
```
aws --region us-east-1 sesv2 cancel-export-job --cli-input-json file://cancel-export-job-input.json
```
+ 入力ファイルは、次のようになります。
```
{
"JobId": "e2220d6b-dce5-45f2-bf60-3287a465b732"
}
```
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_API_CancelExportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_API_CancelExportJob.html) オペレーションのパラメータ値に関する詳細情報については、「Amazon SES API v2 リファレンス」に記載されています。
## を使用してメッセージの完全なイベント履歴と ISP レスポンスを表示する AWS CLI
以下の例は、 AWS CLIを使用して、メッセージの完全なイベント履歴の詳細と、メールボックスプロバイダーから返されたレスポンスまたは診断コードを確認する方法について示しています。これは、Virtual Deliverability Manager ダッシュボードの **[メッセージ]** テーブルにあるメッセージのラジオボタンを選択した後で、**[メッセージ情報]** サイドバーで使用されているのと同じデータです。
**を使用してメッセージのイベント履歴と ISP レスポンスを表示するには AWS CLI**
Amazon SES API v2 の [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetMessageInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetMessageInsights.html) オペレーションを使用して、送信済みメッセージの詳細を確認できます。次の例 AWS CLI に示すように、 からこのオペレーションを呼び出すことができます。
+ message-id で識別される送信済み E メールに関するメッセージ詳細を確認する:
```
aws --region us-east-1 sesv2 get-message-insights --message-id 01000100001000dd-2a19190d-99d4-0000-9f00-deb5bbf2bfbe-000001
```
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetMessageInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetMessageInsights.html) オペレーションのパラメータ値に関する詳細情報については、「Amazon SES API v2 リファレンス」に記載されています。
## Virtual Deliverability Manager のダッシュボードメトリクスの計算方法
Virtual Deliverability Manager ダッシュボードに表示されるすべてのレートカードとドリルダウンの表では、*[アカウント全体の概要]* パネルに入力された日付範囲のメトリクスが計算されます。
ダッシュボードに表示されるメトリクスレートの割合は、表の説明のように計算されます。最後の 4 列は、表示されるメトリクスの取得に使用される基本的な計算の修飾子を表しています。例えば、[*Open rate*] (開封率) は、エンゲージメントの追跡を有効にして配信された HTML メッセージの開封合計数を、配信された合計数で割った値です。エンゲージメントの追跡なしで、HTML でエンコードせずに送信したメッセージは反映されません。
| レート割合 | 計算方法 | エンゲージメントの追跡が有効で、HTML 形式 | 少なくとも 1 つの追跡対象リンクがある | SES [FBL](faqs-enforcement.md#cm-feedback-loop) を使用して ISP に配信される | アカウントレベルのサプレッションリストに含まれる場合は除外 |
| --- | --- | --- | --- | --- | --- |
| Open rate | 開封合計/配信合計 | ✓ | | | |
| クリック率 | クリック合計/配信合計 | ✓ | ✓ | | |
| Complaint rate | 苦情合計/配信合計 | | | ✓ | ✓ |
| 配信率 | 配信合計/送信合計 | | | | |
| 一時的なバウンス率 | 一時的なバウンスの合計/送信合計 | | | | ✓ |
| 永久バウンス率 | 永久バウンスの合計/送信合計 | | | | ✓ |
| 合計送信量 | レート割合が表示されない (送信したものすべてが常に 100%) | | | | |
すべてのメトリクスの差分率とボリューム合計の計算方法:
+ **差分率** – 特定の日付範囲における前回のメトリクス合計と比較したメトリクス合計の差。例えば、*過去 7 日間*が指定された日付範囲の場合、*直前の 7 日間のメトリクス率が、過去 7 日間のメトリクス率になります*。
+ *合計送信量* 差分率の計算方法は異なります。例えば、*(直前の 7 日間の送信量 - 過去 7 日間の送信量)/過去 7 日間の送信量*になります。
+ **ボリューム** – 各メトリクスの合計数。
**注記**
ドリルダウン表の [*配信済み*] 列には、開封率、クリック率、苦情率の計算に使用される配信済み修飾子を除いたストレート配信数が表示されます。
Virtual Deliverability Manager は、受信者が 1 人である E メールのメトリクスのみを追跡します。複数の受信者がいる E メールは、Virtual Deliverability Manager ダッシュボードのメトリクスにはカウントされません。
このような場合、CloudWatch メトリクスには複数の受信者がいる E メールが含まれるため、Virtual Deliverability Manager のメトリクスの数は Amazon CloudWatch メトリクスの数よりも少なくなります。
*SES メールボックスシミュレーター*に送信された E メールは、Virtual Deliverability Manager ダッシュボードのいずれのメトリクスにもカウントされません。
代理送信者のアカウントを介して送信された E メール (以前のクロスアカウント送信) は、Virtual Deliverability Manager ダッシュボードのどのメトリクスにもカウントされません。
**重要**
Apple Mail のプライバシー保護とそのエンゲージメント率への影響: Apple が iOS15 から Apple デバイス向けにメールプライバシー保護 (MPP) 機能を実装した結果、必ずしも受信者がメッセージを開くかクリックしたときではなく、Apple Mail アプリケーションの起動時に MPP トリガーが開くことで、エンゲージメント数が増大しています。これにより、エンゲージメントデータが通常よりもはるかに高い数値で表示されるため、E メールマーケティング担当者はエンゲージメントを確認する際にこの点を考慮する必要があります。ウェブアクティビティ、アプリケーション/ポータルの使用状況など、エンゲージメントを特定する方法は他にもいくつかあります。また、Apple 以外のデバイスからのプロキシデータを使用して集計メトリクスを構築することもできます。注目すべき重要な点は、エンゲージメントの傾向です。これにより、E メール送信に問題があるかどうかがわかります。詳細については、「[Apple Mail's Privacy Protection](https://aws.amazon.com/blogs/messaging-and-targeting/apple-mails-ios15-privacy-protection-impact-to-senders-2/)」を参照してください。