Skip to content
Last updated

メール配信イベントテーブル

Engage Studioは、Treasure Data CDP内でマーケターが効果的なメールキャンペーンを作成・管理するために設計された強力な機能です。効果的なメールマーケティングの重要な側面は、パフォーマンスを追跡する能力です。Engage Studioは、詳細なメールメトリクスを自動的に収集することで、メール配信パフォーマンスインサイトを提供します。 これらの貴重なメールメトリクスは、使用する各メールドメイン用に専用のTreasure Dataテーブルに自動的に保存されます。このテーブルを使用すると、メール送信の結果を詳細なレベルで分析できます。

メールパフォーマンスデータは、Treasure Dataアカウントの以下の場所に保存されます。

  • Database: delivery_email_<your email domain>

  • Table: events

メールパフォーマンス(events)テーブルのスキーマ

eventsテーブルには、メールキャンペーン中に発生する各イベントに関する詳細情報をキャプチャするさまざまな列が含まれています。このテーブルのスキーマには次のフィールドが含まれます。

  • time (int): delivery_timestampと同等で、時刻を表します。

  • email_sender_id (string): 送信者のID。

  • email_domain_id (string): メールドメインのID。

  • email_domain (string): 送信に使用されたメールドメイン。

  • message_id (string): 送信リクエストが成功した際にAmazon SESによってメッセージに割り当てられた一意のID。これはメッセージが送信されたときにAmazon SESが返したIDです。なお、Amazon SESはこのIDをmailオブジェクトのcommonHeadersにも含めます。

  • email_template_id (string): メッセージに使用されたEmail Template ID。このIDは、Engage Studioでメールテンプレートを編集する際のURLパスで確認できます。

  • from (string): FROMメールアドレス。

  • to (string): 受信者のTOメールアドレス。これは元のメールの受信者としてリストされているメールアドレスの1つです。

  • to_plain_address (string): 元々表示名が含まれていた場合でも、シンプルな形式の受信者のメールアドレス。

  • subject (string): メールの件名。これはmailオブジェクトのcommonHeadersで確認できます。

  • timestamp (string): 元のメッセージが送信された日時(ISO8601形式)。

  • event_type (string): 発生したイベントのタイプを示す重要なフィールド。このフィールドは、送信された各メールのさまざまな結果を説明します。

  • delivery_reporting_mta (string): 配信のMail Transfer Agent(MTA)アドレス。Amazon SESでは、これはメールを送信したSESメールサーバーのホスト名です。

  • delivery_smtp_response (string): 配信のMTAログ。これは、Amazon SESからのメールを受け入れたリモートISPからのSMTP応答メッセージです。

  • delivery_processing_time_millis (long): 配信処理にかかった時間(ミリ秒)。これは、Amazon SESがリクエストを受け入れてから受信者のサーバーにメッセージを渡すまでの時間です。

  • delivery_timestamp (string): メールが配信された時刻。

  • open_user_agent (string): メールが開封されたときに使用されたメールクライアントのUser Agent。

  • open_timestamp (string): メールが開封された時刻。

  • open_ip_address (string): 受信者がメールを開封したIPアドレス。

  • click_user_agent (string): メールがクリックされたときに使用されたメールクライアントのUser Agent。

  • click_timestamp (string): メールがクリックされた時刻。

  • click_ip_address (string): 受信者がメールをクリックしたIPアドレス。

  • bounce_reporting_mta (string): バウンスが発生する前に配信を試みたMTAのIPアドレス。

  • bounce_feedback_id (string): バウンスに関連付けられた一意のID。

  • bounce_timestamp (string): Bounceとしてマークされた時刻。

  • bounce_subtype (string): バウンスのサブタイプ。

  • bounce_type (string): バウンスのタイプ(Undetermined、Permanent、またはTransient)。

  • bounce_recipient_status (string): DSNのStatusフィールドの値。これは、メッセージの配信ステータスを示す受信者ごとのトランスポート非依存ステータスコードです。

  • bounce_recipient_action (string): DSNのActionフィールドの値。これは、このレシピエントにメッセージを配信しようとした結果としてReporting-MTAが実行したアクションを示します。

  • bounce_recipient_address (string): バウンスした元のメールの受信者に関する情報を含むリスト

  • bounce_recipient_diagnostic_code (string): レポートMTAが発行したステータスコード。これはDSNのDiagnostic-Codeフィールドの値です。このフィールドはDSNに存在しない場合があります(したがってJSONにも存在しません)。

  • custom_event_id (string): パフォーマンス計算に使用される任意のキャンペーンID。この識別子を使用すると、例えばCustomer Journey Orchestration(CJO)シナリオ内でメールキャンペーンを適切に追跡するのに役立ちます。このIDはメールActivationを設定する際に設定されます。

  • test_mode (boolean): メールがSendTest機能によって送信されたことを示す場合はTrue

メールイベントタイプの理解

event_type列は、送信アクティビティの監視とキャンペーンパフォーマンスの理解に不可欠です。送信された各メールの結果を分類します。この列で見つかる可能性のある値とその意味、およびテーブルでキャプチャされる関連情報は次のとおりです。

  • Send : メール送信リクエストが成功し、Amazon SESが配信を試みます。抑制によって配信が抑制された場合でも、送信としてカウントされます。

  • Delivery : Amazon SESがメールを受信者のメールサーバーに正常に配信しました。deliveryオブジェクトには、配信のtimestampdelivery_timestamp)、processingTimeMillisdelivery_processing_time_millis)、recipientssmtpResponsedelivery_smtp_response)、reportingMTAdelivery_reporting_mta)、およびremoteMtaIpが含まれます。

  • Bounce : 受信者のメールサーバーがメールを拒否したパーマネントまたはトランジェントバウンスを示します。パーマネントバウンスは、将来の送信が成功する可能性が低く、送信者の評判に悪影響を与える可能性があるため、受信者をリストから削除する必要があることを意味します。トランジェントバウンスは、一時的な問題が解決すれば、後で正常に配信される可能性があります。

  • Complaint : メールは配信されましたが、受信者がスパムとしてマークしました。complaintオブジェクトには、complainedRecipientstimestampfeedbackIdcomplaintSubType、およびオプションでuserAgentcomplaintFeedbackType、およびフィードバックレポートからのarrivalDateが含まれます。ほとんどのISPは苦情を申し立てた特定のメールアドレスを編集するため、complainedRecipientsリストには苦情を発行したドメインの受信者が含まれます。complaintFeedbackTypeは、苦情の理由(例:abuse、fraud、virus)を示すことができます。

  • DeliveryDelay : 受信トレイが満杯またはトランジェントサーバーの問題など、問題によりメール配信が一時的に遅延しました。delivery delayオブジェクトには、delayType(例:MailboxFull、MessageTooLarge)、delayedRecipientsexpirationTime(SESが配信を停止する時刻)、reportingMTA、およびtimestampが含まれます。

  • Open : 受信者がメールクライアントでメッセージを開封しました。これはHTMLメール用のオープンピクセルトラッキングに依存しています。openオブジェクトには、受信者のipAddressopen_ip_address)、timestampopen_timestamp)、およびuserAgentopen_user_agent)が含まれます。オープントラッキングはHTMLメールでのみ機能することに注意してください。テキストのみのメールクライアントはこのメトリクスを提供しません。

  • Click : 受信者がメール内の1つまたは複数のリンクをクリックしました。これはクリックトラッキングに依存しており、HTTPS + カスタムドメインをサポートしています。

キャンペーントラッキングのためのcustom_event_idの活用

custom_event_id列は、個々のメールキャンペーンまたはジャーニーのパフォーマンスを追跡するために特別に設計されています。メールActivationを設定する際、キャンペーンの一意の識別子をCustom Event IDパラメータに入力できます。このIDはeventsテーブルに記録され、そのキャンペーン専用のパフォーマンスメトリクス(送信、配信、開封、クリック、バウンスなど)を簡単にフィルタリングして計算できるようになります。これは、Customer Journey Orchestration(CJO)経由でキャンペーンを実行する場合に特に有用です。