Direct Mail事件 -

本文介紹Direct Mail通過CloudMonitor接入作為事件來源發布到事件匯流排EventBridge的事件類型。

支援的地區

支援Direct Mail發布到事件匯流排EventBridge的地區有華東1（杭州）、德國（法蘭克福）、新加坡、美國（維吉尼亞）。

事件類型

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	發送郵件使用的tag。

郵件投遞成功

郵件投遞成功時，事件匯流排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	點擊事件的UserAgent。
tag	String	xxxxx	發送郵件使用的tag。

開啟事件

開啟事件時，事件匯流排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	開啟事件的UserAgent。
tag	String	xxxxx	發送郵件使用的tag。

地址校正灰名單非同步結果

地址校正灰名單非同步結果時，事件匯流排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返回的請求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	文法校正解析得到的電子郵件地址的網域名稱部分（經過小寫化）