Direct Mail イベント - - Alibaba Cloud ドキュメントセンター

このトピックでは、イベントソースとしての Direct Mail が Cloud Monitor を通じて EventBridge に発行するイベントタイプについて説明します。

サポートされているリージョン

Direct Mail は、中国 (杭州) 、ドイツ (フランクフルト) 、シンガポール、米国 (バージニア) のリージョンで EventBridge にイベントを発行できます。

イベントタイプ

Direct Mail は、次のイベントタイプを EventBridge に発行できます。

イベントタイプ	type パラメーターの値
メール配信の失敗	dm:Deliver:Fail
メール配信の成功	dm:Deliver:Succeed
メール FBL レポートデータ	dm:Feedback:FblReport
メール再サブスクリプションデータ	dm:Feedback:Subscribe
メールサブスクリプション解除データ	dm:Feedback:UnSubscribe
クリックイベント	dm:Trace:Click
開封イベント	dm:Trace:Open
グレーリストアドレス検証の非同期結果	dm:Validator:GrayListResult

CloudEvents 仕様で定義されているパラメーターの詳細については、「概要」をご参照ください。

メール配信の失敗

メールの配信に失敗すると、EventBridge は次の例のようなイベントを受信します。

{
  "data": {
    "header": {
      "X-Notify-Message-ID": "test******@******"
    },
    "env_id": "60000******",
    "account": "batch******@top",
    "from": "batch******@top",
    "rcpt": "xxx******@aliyun.com",
    "msg_id": "1df******@******",
    "channel_name": "bg:vip_*",
    "outbound_ip": "8.*.*.7",
    "send_time": "2024-04-29T11:07:04",
    "deliver_time": "2024-04-29T11:07:12",
    "status": "2",
    "event": "dm:Deliver:Fail",
    "region": "cn-hangzhou",
    "err_code": "554",
    "err_msg": "554  RCPT xxx******@aliyun.com dosn't exist",
    "failed_type": "SmtpNxBox",
    "esp": "*mail.com",
    "ip_pool_id": "10306c37-****-****-a82f-1dafb56a9dd2",
    "is_dedicated_ip": true,
    "tag": "xxxxx"
  },
  "id": "8734hhidu983hi457",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:{AccountId}:*",
  "time": "2024-04-29T11:07:12+08:00",
  "type": "dm:Deliver:Fail",
  "aliyunaccountid": "123456789098****",
  "aliyunpublishtime": "2024-04-29T11:07:13.179PRC",
  "aliyuneventbusname": "default",
  "aliyunregionid": "cn-hangzhou",
  "aliyunpublishaddr": "172.25.XX.XX"
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
header	Object		メールに関連するヘッダー。
X-Notify-Message-ID	String	test****@example.com	カスタムヘッダー X-Notify-Message-ID。
env_id	String	60000****	メール送信時にシステムから返されるメール ID。
account	String	batch****@top	送信者のメールアドレス。
from	String	batch****@top	送信者のメールアドレス。
rcpt	String	a****@aliyun.com	受信者のメールアドレス。
msg_id	String	1df****@example.com	メールの Message-ID フィールド。
channel_name	String	bg:vip_*	この配信のアウトバウンド IP アドレスが属するチャンネルの名前。
outbound_ip	String	8...7	この配信のアウトバウンド IP アドレス。
send_time	String	2024-04-29T11:07:04	メールが受理された時間。
deliver_time	String	2024-04-29T11:07:12	メール配信が完了した時間。
status	String	2	配信ステータス。 0: 成功。 2: 無効なアドレス。 3: 受信者がメールを迷惑メールとしてマークしました。 4: その他の失敗。
event	String	dm:Deliver:Fail	イベントメッセージのタイプ。これは type パラメーターと同じです。
region	String	cn-hangzhou	イベントが発生したリージョン。
err_code	String	554	配信完了時に受信者のメールサービスプロバイダー (ESP) から返されたコード。
err_msg	String	554 RCPT a****@aliyun.com dosn't exist	配信完了時に受信者の ESP から返されたメッセージ。
failed_type	String	SmtpNxBox	配信結果の分類。
esp	String	*mail.com	受信者のメールプロバイダーの分類。
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	メールの送信に使用された IP プールの ID。
is_dedicated_ip	Boolean	true	専用 IP アドレスが使用されたかどうかを示します。
tag	String	xxxxx	メールの送信に使用されたタグ。

メール配信の成功

メールが正常に配信されると、EventBridge は次の例のようなイベントを受信します。

{
  "data": {
    "header": {
      "X-Notify-Message-ID": "test******@******"
    },
    "env_id": "60000******",
    "account": "batch******@top",
    "from": "batch******@top",
    "rcpt": "xxx******@aliyun.com",
    "msg_id": "1df******@******",
    "channel_name": "bg:vip_*",
    "outbound_ip": "8.*.*.7",
    "send_time": "2024-04-29T11:07:04",
    "deliver_time": "2024-04-29T11:07:12",
    "status": "0",
    "event": "dm:Deliver:Succeed",
    "region": "cn-hangzhou",
    "err_code": "250",
    "err_msg": "250 Send Mail OK",
    "failed_type": "SendOk",
    "esp": "*mail.com",
    "ip_pool_id": "10306c37-****-****-a82f-1dafb56a9dd2",
    "is_dedicated_ip": true,
    "tag": "xxxxx"
  },
  "id": "8734hhidu983hi457",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:{AccountId}:*",
  "time": "2024-04-29T11:07:12+08:00",
  "type": "dm:Deliver:Succeed",
  "aliyunaccountid": "123456789098****",
  "aliyunpublishtime": "2024-04-29T11:07:13.179PRC",
  "aliyuneventbusname": "default",
  "aliyunregionid": "cn-hangzhou",
  "aliyunpublishaddr": "172.25.XX.XX"
}

data フィールドのパラメーターの説明については、「パラメーターの説明」をご参照ください。

メール FBL レポートデータ

メールがフィードバックループ (FBL) を通じて報告されると、EventBridge は次の例のようなイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Feedback:FblReport",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "send_time": "1726821644",
        "send_email": "from@xxx.com",
        "block_email": "to@yyy.com",
        "subject": "Hello Mr.xxx",
        "message_id": "<msgid***@xxx.com>",
        "block_time": "1726821667",
        "fbl_isp": "outlook**",
        "fingerprint": "SMTPD_abc****"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
send_time	String	1726821644	メールが送信された時間。
send_email	String	from@xxx.com	送信者のメールアドレス。
block_email	String	to@yyy.com	ブロックされた受信者のメールアドレス。
subject	String	Hello Mr.xxx	メールの件名。
message_id	String	<msgid***@xxx.com>	メールの一意の識別子。
block_time	String	1726821667	メールがブロックされた時間。
fbl_isp	String	outlook**	送信者のインターネットサービスプロバイダー (ISP) 。
fingerprint	String	SMTPD_abc****	メールの指紋。

メール再サブスクリプションデータ

受信者が再サブスクライブすると、EventBridge は次の例のようなイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Feedback:Subscribe",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "operate_time": "2024-04-29T11:25:48",
        "envid": "6000*********",
        "from": "from@xxx.com",
        "rcpt": "to@yyy.com",
        "client_ip": "102.**.**.1"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
operate_time	String	2024-04-29T11:25:48	操作が発生した時間。時刻は UTC です。
env_id	String	6000*********	メール送信時にシステムから返されるメール ID。
from	String	from@xxx.com	送信者のアドレス。
rcpt	String	to@yyy.com	受信者のアドレス。
client_ip	String	102...1	開封イベントのクライアント IP アドレス

メールサブスクリプション解除データ

受信者がサブスクライブを解除すると、EventBridge は次の例のようなイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Feedback:UnSubscribe",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "operate_time": "2024-04-29T11:25:48",
        "envid": "6000*********",
        "from": "from@xxx.com",
        "rcpt": "to@yyy.com",
        "client_ip": "102.**.**.1"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
operate_time	String	2024-04-29T11:25:48	操作が発生した時間。時刻は UTC です。
env_id	String	6000*********	メール送信時にシステムから返されるメール ID。
from	String	from@xxx.com	送信者のアドレス。
rcpt	String	to@yyy.com	受信者のアドレス。
client_ip	String	102...1	イベントのソースクライアントの IP アドレス

クリックイベント

受信者がメール内のリンクをクリックすると、EventBridge は次の例のようなイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Trace:Click",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "operate_time": "2024-04-29T11:25:48",
        "client_ip": "202.**.**.1",
        "env_id": "60000******",
        "from": "batch******@top",
        "rcpt": "xxx******@aliyun.com",
        "msg_id": "1df******@******",
        "event": "dm:Trace:Click",
        "region": "cn-hangzhou",
        "url": "https://www.aliyun.com",
        "outbound_ip": "102.**.**.1",
        "esp": "*mail.com",
        "ip_pool_id": "10306c37-****-****-a82f-1dafb56a9dd2",
        "is_dedicated_ip": true,
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1",
        "tag": "xxxxx"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
operate_time	String	2024-04-29T11:25:48	操作が発生した時間。
client_ip	String	202...1	リンクをクリックしたクライアントの IP アドレス。
env_id	String	60000******	メール送信時にシステムから返されるメール ID。
from	String	batch****@top	送信者のアドレス。
rcpt	String	xxx******@aliyun.com	受信者のアドレス。
msg_id	String	1df****@****	メールの Message-ID フィールド。
event	String	dm:Trace:Click	イベントタイプ。
region	String	cn-hangzhou	イベントが発生したリージョン。
url	String	https://www.aliyun.com	クリックされた URL。
outbound_ip	String	102...1	メールの送信に使用されたアウトバウンド IP アドレス。
esp	String	*mail.com	受信者のメールプロバイダーの分類。
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	メールの送信に使用された IP プールの ID。
is_dedicated_ip	Boolean	true	専用 IP アドレスが使用されたかどうかを示します。
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	クリックイベントのユーザーエージェント。
tag	String	xxxxx	メールの送信に使用されたタグ。

オープンイベント

イベントが発生すると、EventBridge は次のサンプルイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Trace:Open",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "operate_time": "2024-04-29T11:25:48",
        "client_ip": "202.**.**.1",
        "env_id": "60000******",
        "from": "batch******@top",
        "rcpt": "xxx******@aliyun.com",
        "msg_id": "1df******@******",
        "event": "dm:Trace:Open",
        "region": "cn-hangzhou",
        "outbound_ip": "102.**.**.1",
        "esp": "*mail.com",
        "ip_pool_id": "10306c37-****-****-a82f-1dafb56a9dd2",
        "is_dedicated_ip": true,
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1",
        "tag": "xxxxx"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
operate_time	String	2024-04-29T11:25:48	操作が発生した時間。
client_ip	String	192.168.XX.XX	メールを開封したクライアントの IP アドレス。
env_id	String	60000******	メール送信時にシステムから返されるメール ID。
from	String	batch****@top	送信者のアドレス。
rcpt	String	a****@aliyun.com	受信者のアドレス。
msg_id	String	1df****@example.com	メールの Message-ID フィールド。
event	String	dm:Trace:Click	イベントタイプ。
region	String	cn-hangzhou	イベントが発生したリージョン。
outbound_ip	String	102...1	メールの送信に使用されたアウトバウンド IP アドレス。
esp	String	*mail.com	受信者のメールプロバイダーの分類。
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	メールの送信に使用された IP プールの ID。
is_dedicated_ip	Boolean	true	専用 IP アドレスが使用されたかどうかを示します。
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	開封イベントのユーザーエージェント。
tag	String	xxxxx	メールの送信に使用されたタグ。

グレーリストアドレス検証の非同期結果

グレーリストアドレス検証の非同期結果が利用可能になると、EventBridge は次の例のようなイベントを受信します。

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.dm",
    "specversion": "1.0",
    "subject": "acs.dm:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "dm:Validator:GrayListResult",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "request_id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
        "submission_time": "1763541726",
        "completion_time": "1763541793",
        "email": "xxxxxx@yyy.com",
        "status": "INVALID",
        "sub_status": "MAILBOX_NOT_EXISTS",
        "provider": "XXXX",
        "is_free_mail": false,
        "local_part": "xxxxxx",
        "domain_part": "yyy.com"
    }
}

次の表に、data フィールドのパラメーターを示します。

パラメーター	タイプ	例	説明
request_id	String	45ef4dewdwe1-7c35-447a-bd93-fab****	リクエストが送信されたときに OpenAPI (Open Application Programming Interface) によって返されたリクエスト ID。
submission_time	String	1763541726	検証リクエストが送信された時間。時刻は UTC です。
completion_time	String	1763541793	検証が完了した時間。時刻は UTC です。
email	String	xxxxxx@yyy.com	検証されたメールアドレス。
status	String	INVALID	検証後のメールアドレスのステータス。
sub_status	String	MAILBOX_NOT_EXISTS	検証後のメールアドレスのサブステータス。これはステータスに関する詳細を提供します。
provider	String	XXXX	アドレスのメールプロバイダーの分類。
is_free_mail	Boolean	false	アドレスが無料のメールプロバイダーのものであるかどうかを示します。
local_part	String	xxxxxx	構文解析から取得したメールアドレスのローカルパート。値は小文字に変換され、サブアドレシングタグ (プラス記号の後の部分) は削除されます。
domain_part	String	yyy.com	構文解析から取得したメールアドレスのドメインパート。値は小文字に変換されます。