カスタムドメインを設定してオープンとクリックの追跡を処理します
イベント発行を使用して、オープンおよびクリックイベントをキャプチャすると、Amazon SES は送信する E メールに小さな変更を加えます。オープンイベントをキャプチャするために、SES は SES を通じて送信される各 E メールに、1 x 1 ピクセルの透明な GIF イメージを追加します。このイメージには各 E メールに一意のファイル名が含まれており、SES が運用するサーバー上でホストされます。このイメージがダウンロードされると、SES はどのメッセージが誰によって開かれたのかを正確に判断できます。
デフォルトでは、このピクセルは E メールの下部に挿入されます。ただし、E メールプロバイダーのアプリケーションによっては、特定のサイズを超えると E メールのプレビューが切り捨てられ、メッセージの残りの部分を確認するためのリンクが表示される場合があります。このシナリオでは、SES ピクセルの追跡イメージはロードされず、追跡しようとしているオープン率は破棄されます。これを回避するには、必要に応じて E メールの本文に {{ses:openTracker}}
プレースホルダーを挿入して、E メールの先頭または他のいずれかの場所にピクセルを配置します。プレースホルダーを含むメッセージを SES が受信すると、そのメッセージはオープンの追跡ピクセルイメージに置き換えられます。
重要
-
複数ある
{{ses:openTracker}}
プレースホルダーは、送信時に SES が削除します。 -
E メールテンプレートには、使用する
{{ses:openTracker}}
プレースホルダーを 1 つのみ追加してください。複数のプレースホルダーを追加すると、400 BadRequestException
エラーコードが返されます。
リンククリックイベントをキャプチャするために、SES は E メールのリンクを SES が運用するサーバーへのリンクに置き換えます。これにより、受信者はただちに目的の宛先にリダイレクトされます。このサーバーに送信されるリクエストのヘッダーの合計サイズは、Cookie を含め、8,192 バイトを超えてはなりません。超える場合は、400 BadRequestException
エラーコードが返されます。
SES が所有および運用するドメインではなく、独自のドメインを使用して、受信者向けにより一貫性のあるエクスペリエンスを作成することができます。この場合、すべての SES インジケーターが削除されます。複数のカスタムドメインを設定して、オープンとクリックの追跡イベントを処理できます。これらのカスタムドメインは設定セットと関連付けられています。設定セットを使用して E メールを送信すると、その設定セットがカスタムドメインを使用するように設定されている場合、その E メール内のオープンとクリックのリンクは、その設定セットで指定されたカスタムドメインを自動的に使用します。
このセクションでは、所有するサーバー上にサブドメインを設定して、ユーザーを SES が運用する開封とクリックの追跡サーバーに自動的にリダイレクトする手順について説明します。これらのドメインの設定には 3 つのステップがあります。まず、サブドメイン自体を設定し、次にカスタムドメインを使用するよう設定セットを設定します。次に、カスタムドメインを使用するよう設定セットを設定し、オープンイベントおよびクリックイベントを発行するようにイベント送信先を設定します。このトピックには、これらのステップをすべて完了する手順が含まれています。
ただし、カスタムドメインを設定せずにオープンまたはクリック追跡を有効にするだけの場合は、オープンイベントやクリックイベントなど、指定したイベントタイプでトリガーされるイベント公開を有効にする設定セットのイベント送信先の定義に直接進むことができます。設定セットには、複数のイベントタイプが定義された複数のイベント送信先を含めることができます。Amazon SES でのイベント送信先の作成を参照してください。
パート 1: オープンとクリックのリンクのリダイレクトを処理するためのドメインの設定
リダイレクトドメインを設定する固有の手順は、ウェブホスティングプロバイダ (および HTTPS サーバーを使用する場合は Content Delivery Network) によって異なります。次のセクションの手順では、特定のステップではなく一般的なガイダンスを示します。
オプション 1: HTTP ドメインの設定
HTTP ドメインを使用してオープンとリンクのリンクを処理する予定の場合 (HTTPS ドメインではなく)、サブドメインを設定するプロセスには、数ステップのみが含まれます。
注記
HTTP プロトコルを使用するカスタムドメインを設定し、HTTPS プロトコルを使用するリンクを含む E メールを送信する場合、E メールのリンクをクリックすると警告メッセージが表示されることがあります。HTTPS プロトコルを使用するリンクが含まれる E メールを送信する場合は、HTTPS ドメインを使用して、クリックの追跡イベントを処理する必要があります。
オープンとクリックのリンクの処理のために、HTTP のサブドメインを設定するには
-
オープンとクリックの追跡リンクのために使用するサブドメインを作成します。SES では、このサブドメインはこのようなリンクの処理専用とし、追跡する E メールを送信する AWS リージョンごとにサブドメインを作成することをお勧めします。
-
SES で使用するサブドメインを検証します。詳細については、「ドメイン ID の作成」を参照してください。
-
リクエストを SES 追跡ドメインにリダイレクトするサブドメインの DNS 設定に新しい CNAME レコードを追加します。リダイレクト先のアドレスは、カスタムサブドメインと同じ AWS リージョン内である必要があります。
SES が利用可能な AWS リージョンの追跡ドメインは、次の表のとおりです。カスタムドメインと同じリージョンにあるドメインを選択してください。
AWS地域 AWS追跡ドメイン 米国東部 (オハイオ) r.us-east-2.awstrack.me
米国東部 (バージニア北部) r.us-east-1.awstrack.me
米国西部 (北カリフォルニア) r.us-west-1.awstrack.me
米国西部 (オレゴン) r.us-west-2.awstrack.me
アフリカ (ケープタウン) r.af-south-1.awstrack.me
アジアパシフィック (ジャカルタ) r.ap-southeast-3.awstrack.me
アジアパシフィック (ムンバイ) r.ap-south-1.awstrack.me
アジアパシフィック (大阪) r.ap-northeast-3.awstrack.me
アジアパシフィック (ソウル) r.ap-northeast-2.awstrack.me
アジアパシフィック (シンガポール) r.ap-southeast-1.awstrack.me
アジアパシフィック (シドニー) r.ap-southeast-2.awstrack.me
アジアパシフィック (ジャカルタ) r.ap-southeast-3.awstrack.me アジアパシフィック (ジャカルタ) r.ap-southeast-3.awstrack.me アジアパシフィック (東京) r.ap-northeast-1.awstrack.me
カナダ (中部) r.ca-central-1.awstrack.me
欧州 (フランクフルト) r.eu-central-1.awstrack.me
欧州 (アイルランド) r.eu-west-1.awstrack.me
欧州 (ロンドン) r.eu-west-2.awstrack.me
欧州 (ミラノ) r.eu-south-1.awstrack.me
欧州 (ストックホルム) r.eu-north-1.awstrack.me
イスラエル (テルアビブ) r.il-central-1.awstrack.me
中東 (バーレーン) r.me-south-1.awstrack.me
南米 (サンパウロ) r.sa-east-1.awstrack.me
AWS GovCloud (米国西部) r.us-gov-west-1.awstrack.me
AWS GovCloud (米国東部) r.us-gov-east-1.awstrack.me
注記
ウェブホスティングプロバイダによっては、サブドメインの DNS レコードの変更が有効になるまでに数分かかることがあります。ウェブホスティングプロバイダや IT 組織はこれらの遅延に関する追加情報を提供できます。
オプション 2: HTTPS ドメインの設定
HTTPS ドメインを使用して、開封とリンクのクリックを追跡することもできます。開封とリンクのクリックを追跡するために HTTPS ドメインを設定するには、「HTTP ドメインの設定」に必要なステップ以外に、いくつかの追加ステップを実行する必要があります。
オープンとクリックのリンクの処理のために、HTTPS のサブドメインを設定するには
-
オープンとクリックの追跡リンクのために使用するサブドメインを作成します。SES では、このサブドメインはこのようなリンクの処理専用とし、追跡する E メールを送信する AWS リージョンごとにサブドメインを作成することをお勧めします。
-
SES で使用するサブドメインを検証します。詳細については、「ドメイン ID の作成」を参照してください。
-
Amazon CloudFront
などのコンテンツ配信ネットワークを使用して新しいアカウントを作成します。「基本的な CloudFront ディストリビューションの開始方法」を参照してください。 -
例えば、
r.us-east-1.awstrack.me
などの SES 追跡ドメインであるオリジンに CDN を設定します。CDN は、カスタムドメインと同じリージョンにある AWS 追跡ドメインを指している必要があります。CDN は、リクエスタから提供されるHost
ヘッダーをオリジンに渡す必要があります。詳細については、この AWS re:Post 記事を参照してください。 SES が利用可能な AWS リージョンの追跡ドメインは、次の表のとおりです。カスタムドメインと同じリージョンにあるドメインを選択してください。
AWS地域 AWS追跡ドメイン 米国東部 (オハイオ) r.us-east-2.awstrack.me
米国東部 (バージニア北部) r.us-east-1.awstrack.me
米国西部 (北カリフォルニア) r.us-west-1.awstrack.me
米国西部 (オレゴン) r.us-west-2.awstrack.me
アフリカ (ケープタウン) r.af-south-1.awstrack.me
アジアパシフィック (ジャカルタ) r.ap-southeast-3.awstrack.me
アジアパシフィック (ムンバイ) r.ap-south-1.awstrack.me
アジアパシフィック (大阪) r.ap-northeast-3.awstrack.me
アジアパシフィック (ソウル) r.ap-northeast-2.awstrack.me
アジアパシフィック (シンガポール) r.ap-southeast-1.awstrack.me
アジアパシフィック (シドニー) r.ap-southeast-2.awstrack.me
アジアパシフィック (東京) r.ap-northeast-1.awstrack.me
カナダ (中部) r.ca-central-1.awstrack.me
欧州 (フランクフルト) r.eu-central-1.awstrack.me
欧州 (アイルランド) r.eu-west-1.awstrack.me
欧州 (ロンドン) r.eu-west-2.awstrack.me
欧州 (ミラノ) r.eu-south-1.awstrack.me
欧州 (ストックホルム) r.eu-north-1.awstrack.me
イスラエル (テルアビブ) r.il-central-1.awstrack.me
中東 (バーレーン) r.me-south-1.awstrack.me
南米 (サンパウロ) r.sa-east-1.awstrack.me
AWS GovCloud (米国西部) r.us-gov-west-1.awstrack.me
AWS GovCloud (米国東部) r.us-gov-east-1.awstrack.me
-
Route 53 を使用して、ドメインの DNS 設定を管理し、CDN として CloudFront を管理する場合、Route 53 で CloudFront ディストリビューションを参照するエイリアス記録を作成します (d111111abcdef8.cloudfront.netなど)。詳細については、Amazon Route 53 デベロッパーガイドの Amazon Route 53 コンソールを使用したレコードの作成を参照してください。
それ以外の場合、サブドメインの DNS 設定で、CDN のアドレスを参照する CNAME レコードを追加します。
-
信頼できる認証機関から SSL 証明書を取得します。証明書は、ステップ 1 で作成したサブドメインと、ステップ 3 ~ 5 で設定した CDN の両方をカバーする必要があります。証明書を CDN にアップロードします。
-
次の curl コマンドを使用すると、新しく作成したカスタムドメインが適切なリージョンと HTTPS プロトコルを使用しているかを検証できます。次の例では、ドメイン名前を除き、すべてがリテラルです。
curl --head https://
custom.domain.com
/favicon.ico以下の例のとおりの応答が返されます。
(python-sdk-test) jdoe@12a34567b89c BaconRedirectService % curl --head https://custom.domain.com/favicon.ico HTTPS/1.1 200 OK x-amz-ses-region: us-east-1 x-amz-ses-request-protocol: https Content-Type: image/x-icon Transfer-Encoding: chunked Date: Fri, 30 Aug 2024 13:50:14 GMT
この応答は、次のプロパティで構成されます。
-
x-amz-request-region
ヘッダー値は、リクエストを受信した SES リージョンです。 -
x-amz-request-protocol
ヘッダー値は、ヘッダーの CDN と SES 間のリクエストに使用されるプロトコルです。
設定が適正である場合、リージョンはドメインを作成したリージョンを反映し、プロトコルは HTTPS であるはずです。
-
パート 2: 設定セットを使用したカスタムリダイレクトドメインと HTTPS ポリシーの指定
開封とクリックの追跡リダイレクトを処理するようにドメインを設定した後、設定セットでカスタムドメインと HTTPS ポリシーを指定する必要があります。
設定セットを使用して E メールを送信する場合、設定セットがカスタムドメインを使用するように設定されていると、E メールの開封とクリックのリンクは、その設定セットで指定されたカスタムドメインを自動的に使用します。
これは SES コンソール、または CreateConfigurationSet
v2 API オペレーションを使用して実行できます。
コンソールを使用してカスタムリダイレクトドメインと HTTPS ポリシーを指定するには
-
設定セットを作成または編集する際に、「設定セットを作成します。」のステップ 4 の「追跡オプション」を使用して、カスタムリダイレクトドメインと HTTPS ポリシーのオプションを指定します。
AWS CLI を使用してカスタムリダイレクトドメインと HTTPS ポリシーを指定するには
SES API v2 の CreateConfigurationSet
オペレーションを使用し、TrackingOptions
プロパティを利用してカスタムリダイレクトドメインと HTTPS ポリシーを指定できます。次の例に示すように、このオペレーションは、AWS CLI から呼び出すことができます。
-
次のとおり、E メールを送信して追跡する AWS リージョンの設定セットを作成します。
aws sesv2 create-configuration-set --cli-input-json file://create.json
-
この例では、入力ファイルは
TrackingOptions
プロパティのパラメータを使用しています。CustomRedirectDomain
は、開封とクリックの追跡リンクに使用するカスタムドメインを指定し、HttpsPolicy
は HTTPS ポリシーオプションを指定します。{ "ConfigurationSetName": "my-config-set", "TrackingOptions": { "CustomRedirectDomain": "marketing.example.com", "HttpsPolicy": "REQUIRE" }, "SendingOptions": { "SendingEnabled": true } }
HttpsPolicy
パラメータでは、次の値を指定して、カスタムリダイレクトドメインの開封とクリックの追跡リンクのプロトコルを設定できます。-
OPTIONAL
– (デフォルト動作) 開封の追跡リンクは HTTP を使用してラップされます。クリックの追跡リンクは、リンクの元のプロトコルを使用してラップされます。 -
REQUIRE
– 開封とクリックの追跡リンクはどちらも HTTPS を使用してラップされます。 -
REQUIRE_OPEN_ONLY
– 開封の追跡リンクは HTTPS を使用してラップされます。クリックの追跡リンクは、リンクの元のプロトコルを使用してラップされます。
-
パート 3: 設定セットを使用した開封イベントタイプとクリックイベントタイプの指定
前のステップの設定セットでのカスタムドメインの指定後、設定セットを介してイベント送信先で開封イベントタイプおよび/またはクリックイベントタイプを指定する必要があります。
これは SES コンソール、または CreateConfigurationSetEventDestination
v2 API オペレーションを使用して実行できます。
コンソールを使用して開封イベントタイプおよび/またはクリックイベントタイプを選択するには
-
イベント送信先を作成または変更する際に、「イベント送信先の作成」のステップ 6 の「開封とクリックの追跡」を使用して、イベントタイプを指定します。