全部產品
Search
文件中心

:Direct Mail事件

更新時間:Jul 06, 2024

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

支援的地區

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

事件類型

Direct Mail支援發布到事件匯流排EventBridge的事件類型如下所示。

事件類型

type參數值

郵件投遞失敗

dm:Deliver:Fail

郵件投遞成功

dm:Deliver:Succeed

點擊事件

dm:Trace:Click

開啟事件

dm:Trace:Open

CloudEvents規範中定義的參數解釋,請參見事件概述

郵件投遞失敗

郵件投遞失敗時,事件匯流排EventBridge接收到的樣本事件如下所示。

{
  "data": {
    "header": {
      "X-Notify-Message-ID": "test****@example.com"
    },
    "env_id": "60000****",
    "account": "batch****@top",
    "from": "batch****@top",
    "rcpt": "a****@aliyun.com",
    "msg_id": "1df****@example.com",
    "send_time": "2024-04-29T11:07:04+08:00",
    "deliver_time": "2024-04-29T11:07:12+08:00",
    "status": "2",
    "event": "dm:Deliver:Fail",
    "region": "cn-hangzhou",
    "err_code": "554",
    "err_msg": "554  RCPT a****@aliyun.com dosn't exist",
    "failed_type": "SmtpNxBox"
  },
  "id": "8734hhidu983h****",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:123456789098****:215672",
  "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欄位。

send_time

String

2024-04-29T11:07:04+08:00

郵件接收時間。

deliver_time

String

2024-04-29T11:07:12+08:00

郵件投遞完成時間。

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

投遞結果分類。

郵件投遞成功

郵件投遞成功時,事件匯流排EventBridge接收到的樣本事件如下所示。

{
  "data": {
    "header": {
      "X-Notify-Message-ID": "test****@example.com"
    },
    "env_id": "60000****",
    "account": "batch****@top",
    "from": "batch****@top",
    "rcpt": "a****@aliyun.com",
    "msg_id": "1df****@example.com",
    "send_time": "2024-04-29T11:07:04+08:00",
    "deliver_time": "2024-04-29T11:07:12+08:00",
    "status": "0",
    "event": "dm:Deliver:Succeed",
    "region": "cn-hangzhou",
    "err_code": "250",
    "err_msg": "250 Send Mail OK",
    "failed_type": "SendOk"
  },
  "id": "8734hhidu983h****",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:123456789098****:215672",
  "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欄位包含的參數解釋,請參見參數解析

點擊事件

點擊事件時,事件匯流排EventBridge接收到的樣本事件如下所示。

{
  "data": {
    "operate_time": "2024-04-29T11:25:48+08:00",
    "client_ip": "192.168.XX.XX",
    "env_id": "60000****",
    "from": "batch****@top",
    "rcpt": "a****@aliyun.com",
    "msg_id": "1df****@example.com",
    "event": "dm:Trace:Click",
    "region": "cn-hangzhou",
    "url": "https://www.aliyun.com"
  },
  "id": "8734hhidu983h****",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:123456789098****:215672",
  "time": "2024-04-29T11:07:12+08:00",
  "type": "dm:Trace:Click",
  "aliyunaccountid": "123456789098****",
  "aliyunpublishtime": "2024-04-29T11:07:13.179PRC",
  "aliyuneventbusname": "default",
  "aliyunregionid": "cn-hangzhou",
  "aliyunpublishaddr": "172.25.XX.XX"
}

data欄位包含的參數解釋如下表所示。

參數

類型

樣本值

描述

operate_time

String

2024-04-29T11:25:48+08:00

事件操作時間。

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

事件發生的地區。

url

String

https://www.aliyun.com

點擊的URL。

開啟事件

開啟事件時,事件匯流排EventBridge接收到的樣本事件如下所示。

{
  "data": {
    "operate_time": "2024-04-29T11:25:48+08:00",
    "client_ip": "192.168.XX.XX",
    "env_id": "60000****",
    "from": "batch****@top",
    "rcpt": "a****@aliyun.com",
    "msg_id": "1df****@example.com",
    "event": "dm:Trace:Open",
    "region": "cn-hangzhou"
  },
  "id": "8734hhidu983h****",
  "source": "acs:dm",
  "specversion": "1.0",
  "subject": "acs:dm:cn-hangzhou:123456789098****:215672",
  "time": "2024-04-29T11:07:12+08:00",
  "type": "dm:Trace:Open",
  "aliyunaccountid": "123456789098****",
  "aliyunpublishtime": "2024-04-29T11:07:13.179PRC",
  "aliyuneventbusname": "default",
  "aliyunregionid": "cn-hangzhou",
  "aliyunpublishaddr": "172.25.XX.XX"
}

關於data欄位包含的參數解釋,請參見參數解析