Direct Mail events - - Alibaba Cloud Dokümantasyon Merkezi

Desteklenen bölgeler

Direct Mail hizmeti, aşağıdaki bölgelerde EventBridge hizmetine olay yayınlayabilir: Çin (Hangzhou), Almanya (Frankfurt), Singapur ve ABD (Virginia).

Olay türleri

Direct Mail hizmeti, aşağıdaki olay türlerini EventBridge hizmetine yayınlayabilir.

Olay türü	type parametresinin değeri
E-posta teslimatı başarısız oldu	dm:Deliver:Fail
E-posta teslimatı başarılı oldu	dm:Deliver:Succeed
E-posta FBL rapor verileri	dm:Feedback:FblReport
E-posta yeniden abonelik verileri	dm:Feedback:Subscribe
E-posta abonelikten çıkma verileri	dm:Feedback:UnSubscribe
Tıklama olayı	dm:Trace:Click
Açma olayı	dm:Trace:Open
Gri liste adres doğrulamasının eşzamansız sonucu	dm:Validator:GrayListResult

CloudEvents belirtiminde tanımlanan parametreler hakkında daha fazla bilgi için bkz. Olaylara genel bakış.

E-posta teslimatı başarısız oldu

Bir e-posta teslim edilemediğinde, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
header	Object		E-postayla ilgili üstbilgiler.
X-Notify-Message-ID	String	test****@example.com	Özel X-Notify-Message-ID üstbilgisi.
env_id	String	60000****	E-posta gönderildiğinde sistem tarafından döndürülen e-posta kimliği.
account	String	batch****@top	Gönderenin e-posta adresi.
from	String	batch****@top	Gönderenin e-posta adresi.
rcpt	String	a****@aliyun.com	Alıcının e-posta adresi.
msg_id	String	1df****@example.com	E-postanın Message-ID alanı.
channel_name	String	bg:vip_*	Bu teslimata ait giden IP adresinin ait olduğu kanalın adı.
outbound_ip	String	8...7	Bu teslimata ait giden IP adresi.
send_time	String	2024-04-29T11:07:04	E-postanın kabul edildiği zaman.
deliver_time	String	2024-04-29T11:07:12	E-posta teslimatının tamamlandığı zaman.
status	String	2	Teslimat durumu. 0: Başarılı. 2: Geçersiz adres. 3: Alıcı, e-postayı spam olarak işaretledi. 4: Diğer hatalar.
event	String	dm:Deliver:Fail	Olay mesajının türü. Bu değer, type parametresiyle aynıdır.
region	String	cn-hangzhou	Olayın gerçekleştiği bölge.
err_code	String	554	Teslimat tamamlandığında alıcının e-posta hizmet sağlayıcısı (ESP) tarafından döndürülen kod.
err_msg	String	554 RCPT a****@aliyun.com dosn't exist	Teslimat tamamlandığında alıcının ESP'si tarafından döndürülen mesaj.
failed_type	String	SmtpNxBox	Teslimat sonucunun sınıflandırması.
esp	String	*mail.com	Alıcının e-posta sağlayıcısının sınıflandırması.
ip_pool_id	String	10306c37---a82f-1dafb56a9dd2	E-postayı göndermek için kullanılan IP havuzunun kimliği.
is_dedicated_ip	Boolean	true	Özel bir IP adresinin kullanılıp kullanılmadığını gösterir.
tag	String	xxxxx	E-postayı göndermek için kullanılan etiket.

E-posta teslimatı başarılı oldu

Bir e-posta başarıyla teslim edildiğinde, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

{
  "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 alanındaki parametrelerin açıklamaları için bkz. Parametre açıklamaları.

E-posta FBL rapor verileri

Bir e-posta geri bildirim döngüsü (FBL) üzerinden raporlandığında, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
send_time	String	1726821644	E-postanın gönderildiği zaman.
send_email	String	from@xxx.com	Gönderenin e-posta adresi.
block_email	String	to@yyy.com	Engellenen alıcının e-posta adresi.
subject	String	Hello Mr.xxx	E-postanın konusu.
message_id	String	<msgid***@xxx.com>	E-postanın benzersiz tanımlayıcısı.
block_time	String	1726821667	E-postanın engellendiği zaman.
fbl_isp	String	outlook**	Gönderenin İnternet Hizmet Sağlayıcısı (ISP).
fingerprint	String	SMTPD_abc****	E-postanın parmak izi.

E-posta yeniden abonelik verileri

Bir alıcı yeniden abone olduğunda, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
operate_time	String	2024-04-29T11:25:48	İşlemin gerçekleştiği zaman. Zaman UTC cinsindendir.
env_id	String	6000*****	E-posta gönderildiğinde sistem tarafından döndürülen e-posta kimliği.
from	String	from@xxx.com	Gönderenin adresi.
rcpt	String	to@yyy.com	Alıcının adresi.
client_ip	String	102...1	Açma olayı için istemci IP adresi.

E-posta abonelikten çıkma verileri

Bir alıcı abonelikten çıktığında, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
operate_time	String	2024-04-29T11:25:48	İşlemin gerçekleştiği zaman. Zaman UTC cinsindendir.
env_id	String	6000*****	E-posta gönderildiğinde sistem tarafından döndürülen e-posta kimliği.
from	String	from@xxx.com	Gönderenin adresi.
rcpt	String	to@yyy.com	Alıcının adresi.
client_ip	String	102...1	Olay için kaynak istemcinin IP adresi.

Tıklama olayı

Bir alıcı e-postadaki bir bağlantıyı tıkladığında, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
operate_time	String	2024-04-29T11:25:48	İşlemin gerçekleştiği zaman.
client_ip	String	202...1	Bağlantıyı tıklayan istemcinin IP adresi.
env_id	String	60000	E-posta gönderildiğinde sistem tarafından döndürülen e-posta kimliği.
from	String	batch****@top	Gönderenin adresi.
rcpt	String	xxx@aliyun.com	Alıcının adresi.
msg_id	String	1df@	E-postadaki Message-ID alanı.
event	String	dm:Trace:Click	Olay türü.
region	String	cn-hangzhou	Olayın gerçekleştiği bölge.
url	String	https://www.aliyun.com	Tıklanan URL.
outbound_ip	String	102...1	E-postayı göndermek için kullanılan giden IP adresi.
esp	String	*mail.com	Alıcının e-posta sağlayıcısının sınıflandırması.
ip_pool_id	String	10306c37---a82f-1dafb56a9dd2	E-postayı göndermek için kullanılan IP havuzunun kimliği.
is_dedicated_ip	Boolean	true	Özel bir IP adresinin kullanılıp kullanılmadığını gösterir.
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	Tıklama olayı için kullanıcı aracısı.
tag	String	xxxxx	E-postayı göndermek için kullanılan etiket.

Açma olayı

Bir olay gerçekleştiğinde, EventBridge hizmeti aşağıdaki örnek olayı alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
operate_time	String	2024-04-29T11:25:48	İşlemin gerçekleştiği zaman.
client_ip	String	192.168.XX.XX	E-postayı açan istemcinin IP adresi.
env_id	String	60000	E-posta gönderildiğinde sistem tarafından döndürülen e-posta kimliği.
from	String	batch****@top	Gönderenin adresi.
rcpt	String	a****@aliyun.com	Alıcının adresi.
msg_id	String	1df****@example.com	E-postadaki Message-ID alanı.
event	String	dm:Trace:Click	Olay türü.
region	String	cn-hangzhou	Olayın gerçekleştiği bölge.
outbound_ip	String	102...1	E-postayı göndermek için kullanılan giden IP adresi.
esp	String	*mail.com	Alıcının e-posta sağlayıcısının sınıflandırması.
ip_pool_id	String	10306c37---a82f-1dafb56a9dd2	E-postayı göndermek için kullanılan IP havuzunun kimliği.
is_dedicated_ip	Boolean	true	Özel bir IP adresinin kullanılıp kullanılmadığını gösterir.
user_agent	String	Mozilla/5.0 (Macintosh; Intel Mac OS X ****) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1	Açma olayı için kullanıcı aracısı.
tag	String	xxxxx	E-postayı göndermek için kullanılan etiket.

Gri liste adres doğrulamasının eşzamansız sonucu

Gri liste adres doğrulaması için eşzamansız bir sonuç mevcut olduğunda, EventBridge hizmeti aşağıdaki örneğe benzer bir olay alır.

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

Aşağıdaki tabloda, data alanındaki parametreler açıklanmaktadır.

Parametre	Tür	Örnek	Açıklama
request_id	String	45ef4dewdwe1-7c35-447a-bd93-fab****	İstek gönderildiğinde OpenAPI (Open Application Programming Interface) tarafından döndürülen istek kimliği.
submission_time	String	1763541726	Doğrulama isteğinin gönderildiği zaman. Zaman UTC cinsindendir.
completion_time	String	1763541793	Doğrulamanın tamamlandığı zaman. Zaman UTC cinsindendir.
email	String	xxxxxx@yyy.com	Doğrulanmış e-posta adresi.
status	String	INVALID	Doğrulama sonrası e-posta adresinin durumu.
sub_status	String	MAILBOX_NOT_EXISTS	Doğrulama sonrası e-posta adresinin alt durumu. Bu değer, durum hakkında daha fazla ayrıntı sağlar.
provider	String	XXXX	Adresin e-posta sağlayıcısının sınıflandırması.
is_free_mail	Boolean	false	Adresin ücretsiz bir e-posta sağlayıcısından olup olmadığını gösterir.
local_part	String	xxxxxx	Söz dizimi ayrıştırmasından elde edilen e-posta adresinin yerel kısmı. Değer küçük harfe dönüştürülür ve alt adresleme etiketi (artı işaretinden sonraki kısım) kaldırılır.
domain_part	String	yyy.com	Söz dizimi ayrıştırmasından elde edilen e-posta adresinin alan kısmı. Değer küçük harfe dönüştürülür.