Event Direct Mail -

Topik ini menjelaskan jenis-jenis event yang dipublikasikan oleh Direct Mail sebagai sumber event ke EventBridge melalui Cloud Monitor.

Wilayah yang didukung

Direct Mail dapat mempublikasikan event ke EventBridge di wilayah berikut: Tiongkok (Hangzhou), Jerman (Frankfurt), Singapura, dan AS (Virginia).

Jenis event

Direct Mail dapat mempublikasikan jenis event berikut ke EventBridge.

Jenis event	Nilai parameter type
Pengiriman email gagal	dm:Deliver:Fail
Pengiriman email berhasil	dm:Deliver:Succeed
Data laporan FBL email	dm:Feedback:FblReport
Data langganan ulang email	dm:Feedback:Subscribe
Data pembatalan langganan email	dm:Feedback:UnSubscribe
Event klik	dm:Trace:Click
Event buka	dm:Trace:Open
Hasil asinkron validasi alamat daftar abu-abu	dm:Validator:GrayListResult

Untuk informasi selengkapnya mengenai parameter yang didefinisikan dalam spesifikasi CloudEvents, lihat Ikhtisar.

Pengiriman email gagal

Ketika pengiriman email gagal, EventBridge menerima event yang mirip dengan contoh berikut.

{
  "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"
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
header	Object		Header yang terkait dengan email.
X-Notify-Message-ID	String	test****@example.com	Header kustom X-Notify-Message-ID.
env_id	String	60000****	ID email yang dikembalikan sistem saat email dikirim.
account	String	batch****@top	Alamat email pengirim.
from	String	batch****@top	Alamat email pengirim.
rcpt	String	a****@aliyun.com	Alamat email penerima.
msg_id	String	1df****@example.com	Bidang Message-ID dari email.
channel_name	String	bg:vip_*	Nama saluran tempat alamat IP arah keluar untuk pengiriman ini berada.
outbound_ip	String	8...7	Alamat IP arah keluar untuk pengiriman ini.
send_time	String	2024-04-29T11:07:04	Waktu ketika email diterima.
deliver_time	String	2024-04-29T11:07:12	Waktu ketika pengiriman email selesai.
status	String	2	Status pengiriman. 0: Berhasil. 2: Alamat tidak valid. 3: Penerima menandai email sebagai spam. 4: Kegagalan lainnya.
event	String	dm:Deliver:Fail	Jenis pesan event. Ini sama dengan parameter type.
region	String	cn-hangzhou	Wilayah tempat event terjadi.
err_code	String	554	Kode yang dikembalikan oleh penyedia layanan email (ESP) penerima setelah pengiriman berhasil dilakukan.
err_msg	String	554 RCPT a****@aliyun.com dosn't exist	Pesan yang dikembalikan oleh ISP penerima saat pengiriman selesai.
failed_type	String	SmtpNxBox	Kategorisasi hasil pengiriman.
esp	String	*mail.com	Kategorisasi penyedia email penerima.
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	ID pool IP yang digunakan untuk mengirim email.
is_dedicated_ip	Boolean	true	Menunjukkan apakah alamat IP khusus digunakan.
tag	String	xxxxx	Tag yang digunakan untuk mengirim email.

Pengiriman email berhasil

Ketika email berhasil dikirim, EventBridge menerima event yang mirip dengan contoh berikut.

{
  "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"
}

Untuk deskripsi parameter dalam bidang data, lihat Deskripsi parameter.

Data laporan FBL email

Ketika email dilaporkan melalui loop umpan balik (FBL), EventBridge menerima event yang mirip dengan contoh berikut.

{
    "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****"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
send_time	String	1726821644	Waktu saat email dikirim.
send_email	String	from@xxx.com	Alamat email pengirim.
block_email	String	to@yyy.com	Alamat email penerima yang diblokir.
subject	String	Hello Mr.xxx	Subjek email.
message_id	String	<msgid***@xxx.com>	Pengidentifikasi unik email.
block_time	String	1726821667	Waktu saat email diblokir.
fbl_isp	String	outlook**	Penyedia layanan internet (ISP) pengirim.
fingerprint	String	SMTPD_abc****	Sidik jari email.

Data langganan ulang email

Ketika penerima melakukan langganan ulang, EventBridge menerima event yang mirip dengan contoh berikut.

{
    "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"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
operate_time	String	2024-04-29T11:25:48	Waktu saat operasi terjadi. Waktu dalam UTC.
env_id	String	6000*********	ID email yang dikembalikan sistem saat email dikirim.
from	String	from@xxx.com	Alamat pengirim.
rcpt	String	to@yyy.com	Alamat penerima.
client_ip	String	102...1	Alamat IP klien untuk event buka

Data pembatalan langganan email

Ketika penerima membatalkan langganan, EventBridge menerima event yang mirip dengan contoh berikut.

{
    "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"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
operate_time	String	2024-04-29T11:25:48	Waktu saat operasi terjadi. Waktu dalam UTC.
env_id	String	6000*********	ID email yang dikembalikan sistem saat email dikirim.
from	String	from@xxx.com	Alamat pengirim.
rcpt	String	to@yyy.com	Alamat penerima.
client_ip	String	102...1	Alamat IP klien sumber untuk event tersebut

Event klik

Ketika penerima mengklik tautan dalam email, EventBridge menerima event yang mirip dengan contoh berikut.

{
    "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"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
operate_time	String	2024-04-29T11:25:48	Waktu saat operasi terjadi.
client_ip	String	202...1	Alamat IP klien yang mengklik tautan.
env_id	String	60000******	ID email yang dikembalikan sistem saat email dikirim.
from	String	batch****@top	Alamat pengirim.
rcpt	String	xxx******@aliyun.com	Alamat penerima.
msg_id	String	1df****@****	Bidang Message-ID dalam email.
event	String	dm:Trace:Click	Jenis event.
region	String	cn-hangzhou	Wilayah tempat event terjadi.
url	String	https://www.aliyun.com	URL yang diklik.
outbound_ip	String	102...1	Alamat IP arah keluar yang digunakan untuk mengirim email.
esp	String	*mail.com	Kategorisasi penyedia email penerima.
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	ID pool IP yang digunakan untuk mengirim email.
is_dedicated_ip	Boolean	true	Menunjukkan apakah alamat IP khusus digunakan.
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	User agent untuk event klik.
tag	String	xxxxx	Tag yang digunakan untuk mengirim email.

Event buka

Ketika event terjadi, EventBridge menerima event contoh berikut.

{
    "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"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
operate_time	String	2024-04-29T11:25:48	Waktu saat operasi terjadi.
client_ip	String	192.168.XX.XX	Alamat IP klien yang membuka email.
env_id	String	60000******	ID email yang dikembalikan sistem saat email dikirim.
from	String	batch****@top	Alamat pengirim.
rcpt	String	a****@aliyun.com	Alamat penerima.
msg_id	String	1df****@example.com	Bidang Message-ID dalam email.
event	String	dm:Trace:Click	Jenis event.
region	String	cn-hangzhou	Wilayah tempat event terjadi.
outbound_ip	String	102...1	Alamat IP arah keluar yang digunakan untuk mengirim email.
esp	String	*mail.com	Kategorisasi penyedia email penerima.
ip_pool_id	String	10306c37-**-**-a82f-1dafb56a9dd2	ID pool IP yang digunakan untuk mengirim email.
is_dedicated_ip	Boolean	true	Menunjukkan apakah alamat IP khusus digunakan.
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	User agent untuk event buka.
tag	String	xxxxx	Tag yang digunakan untuk mengirim email.

Hasil asinkron validasi alamat daftar abu-abu

Ketika hasil asinkron untuk validasi alamat daftar abu-abu tersedia, EventBridge menerima event yang mirip dengan contoh berikut.

{
    "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"
    }
}

Tabel berikut menjelaskan parameter dalam bidang data.

Parameter	Tipe	Contoh	Deskripsi
request_id	String	45ef4dewdwe1-7c35-447a-bd93-fab****	ID permintaan yang dikembalikan oleh OpenAPI (Open Application Programming Interface) saat permintaan diajukan.
submission_time	String	1763541726	Waktu saat permintaan validasi diajukan. Waktu dalam UTC.
completion_time	String	1763541793	Waktu saat validasi selesai. Waktu dalam UTC.
email	String	xxxxxx@yyy.com	Alamat email yang divalidasi.
status	String	INVALID	Status alamat email setelah validasi.
sub_status	String	MAILBOX_NOT_EXISTS	Sub-status alamat email setelah validasi. Ini memberikan detail lebih lanjut mengenai status tersebut.
provider	String	XXXX	Kategorisasi penyedia email untuk alamat tersebut.
is_free_mail	Boolean	false	Menunjukkan apakah alamat tersebut berasal dari penyedia email gratis.
local_part	String	xxxxxx	Bagian lokal alamat email yang diperoleh dari penguraian sintaks. Nilainya diubah menjadi huruf kecil, dan tag sub-addressing (bagian setelah tanda plus) dihapus.
domain_part	String	yyy.com	Bagian domain alamat email yang diperoleh dari penguraian sintaks. Nilainya diubah menjadi huruf kecil.