Lacak event pengiriman email melalui Direct Mail dan EventBridge-Direct Mail-Alibaba Cloud

Topik ini menjelaskan cara mengintegrasikan Direct Mail dengan Alibaba Cloud EventBridge untuk mendistribusikan notifikasi hasil pengiriman email.

Setelah mengonfigurasi EventBridge, hasil pengiriman email melalui Direct Mail akan dikirim ke target event tertentu seperti MNS dan HTTP berdasarkan aturan Event Publishing yang ditetapkan di EventBridge. Ini memungkinkan Anda mendapatkan hasil pengiriman secara asinkron.

Berikut adalah langkah-langkah untuk menyiapkan Event Publishing.

Aktifkan EventBridge dan berikan izin akses

1. Di halaman utama Alibaba Cloud, cari EventBridge dan aktifkan layanan tersebut. Layanan ini gratis.

Buat aturan event

Di Konsol EventBridge, pilih Cloud Service Dedicated Event Bus > Create Rule untuk membuat aturan Event Publishing untuk Direct Mail. Konfigurasikan informasi dasar dengan memasukkan nama aturan dan deskripsi.

Konfigurasikan pola peristiwa. Atur Tipe Sumber Event ke Alibaba Cloud Service Event Source. Pilih acs.dm sebagai sumber event. Jenis event yang didukung adalah Send Failed, Send Succeeded, Link Clicked, dan Email Opened. Anda dapat menambahkan jenis event sesuai kebutuhan. Jenis event yang tidak ditambahkan akan difilter.

Konfigurasikan target event. Pilih tipe layanan. Topik ini menggunakan MNS sebagai contoh. Tentukan antrian tujuan. Untuk informasi lebih lanjut tentang cara mengaktifkan MNS dan membuat antrian, lihat bagian Aktifkan MNS dan Buat Antrian untuk Menerima Pesan dalam topik ini. Secara default, isi pesan diatur ke Complete Event, dan Base64 encoding dinonaktifkan. Anda dapat mengonfigurasi opsi pengulangan dan antrian pesan gagal sesuai kebutuhan. Setelah konfigurasi selesai, klik Buat Aturan.

Setelah aturan dibuat, Anda dapat melihatnya di halaman ikhtisar EventBridge.

Jenis event dan metode modifikasi

Jenis Event yang Didukung

Jenis event	nilai parameter type
Pengiriman email gagal	dm:Deliver:Fail
Pengiriman email berhasil	dm:Deliver:Succeed
Data laporan FBL	dm:Feedback:FblReport
Event klik	dm:Trace:Click
Event buka	dm:Trace:Open

Ubah Statistik untuk Berbagai Jenis Event

Di panel navigasi di sebelah kiri, klik Aturan Event. Temukan aturan dan klik Edit di kolom Aksi. Di langkah Konfigurasi Pola Event, Anda dapat mengubah jenis event.

Persyaratan Awal untuk Mengumpulkan Statistik pada Event Buka dan Klik

Untuk mendistribusikan notifikasi untuk event buka dan klik email, Anda harus terlebih dahulu mengaktifkan fitur Pelacakan data. Untuk informasi lebih lanjut, lihat Bagaimana cara mengaktifkan Pelacakan data?.

Aktifkan Event Publishing di Konsol Direct Mail

Di Konsol Direct Mail, nyalakan saklar Event Publishing.

b3070724625e6b3377fe779d96bf76ec

Terima Pesan Event Publishing dan verifikasi rantai validasi

Bagian ini menggunakan target event MNS yang telah diatur dalam prosedur sebelumnya sebagai contoh untuk menjelaskan cara memverifikasi rantai validasi Event Publishing.

Aktifkan MNS dan buat antrian untuk menerima pesan

Masuk ke Konsol Message Service (MNS). Jika Anda belum mengaktifkan MNS, ikuti petunjuk di layar untuk mengaktifkan layanan.
Di panel navigasi di sebelah kiri, klik Antrian untuk masuk ke halaman Antrian.
Klik Buat Antrian. Kotak dialog Buat Antrian muncul.
Masukkan nama antrian. Anda dapat menentukan nama antrian kustom. Dalam contoh ini, antrian bernama delivery-result-queue dibuat. Pertahankan nilai default untuk parameter lainnya dan klik OK.

Picu dan lihat Event Publishing

Setelah Anda mengirim email menggunakan Direct Mail, Anda dapat melihat catatan jejak event di Konsol EventBridge.

Lihat hasil dari target event

Buka Konsol MNS. Di daftar antrian, temukan antrian yang dikonfigurasi sebagai target event di EventBridge. Dalam contoh ini, antriannya adalah delivery-result-queue. Klik Kirim/Terima Pesan. Anda akan dialihkan ke halaman Kirim dan Terima Pesan.

Klik Terima Pesan di bagian bawah halaman. Anda dapat melihat pesan event yang baru saja dikirim. Klik Detail untuk melihat isi lengkap pesan event. Anda dapat melihat bahwa ID event sama dengan catatan di EventBridge, yang menunjukkan bahwa event berhasil dikirim ke MNS.

Contoh menyiapkan Event Publishing untuk alamat pengirim tertentu

Event Publishing yang dikonfigurasi dalam contoh sebelumnya berlaku untuk semua domain email dan alamat pengirim di Direct Mail. Anda dapat memodifikasi string JSON dari aturan event untuk mendistribusikan event berdasarkan kondisi filter, seperti alamat pengirim, untuk memenuhi kebutuhan bisnis Anda.

Contoh berikut menunjukkan cara mengonfigurasi Event Publishing untuk alamat pengirim tertentu, 'batch@sg.example.top'. Setelah Anda mengonfigurasi aturan, hanya catatan pesan email yang dikirim dari 'batch@sg.example.top' yang dikirim ke target event oleh EventBridge.

1. Saat membuat aturan event, tentukan konten pola event di bidang Konten Pola untuk menyaring event berdasarkan bidang tertentu.

Dalam contoh ini, konten polanya adalah sebagai berikut:

{
    "source": [
        "acs.dm"
    ],
    "type": [
        "dm:Deliver:Fail",
        "dm:Deliver:Succeed",
        "dm:Trace:Click",
        "dm:Trace:Open",
        "dm:Feedback:FblReport"
    ],
    "data": {
        "from": [
            "batch@sg.example.top"
        ]
    }
}

Kode berikut menunjukkan isi lengkap badan pesan event. Anda dapat menulis konten pola untuk aturan event berdasarkan isi dan struktur badan event. Untuk informasi lebih lanjut, lihat Pola event.

Semua nama bidang dalam konten pola harus ada di badan event. Jika tidak, pesan event akan difilter.
Nama bidang dalam pola event harus memiliki struktur bersarang yang sama dengan nama bidang dalam event.
Pola event melakukan pencocokan tepat karakter demi karakter. Pencocokan bersifat peka huruf besar/kecil. Tidak ada normalisasi string yang dilakukan selama proses pencocokan.
Nilai yang akan dicocokkan harus mengikuti aturan JSON: string dalam tanda kutip, angka, dan kata kunci true, false, dan null tanpa tanda kutip.
Pola event mendukung semantik OR. Kunci dalam pencocokan pola event mendukung semantik AND. Nilai kunci mendukung semantik OR untuk array.

Kode berikut menunjukkan badan pesan default dari sebuah event.

dm:Deliver:Succeed

{
    "datacontenttype": "application/json;charset=utf-8",
    "aliyunaccountid": "1491110661959791",
    "data": {
        "rcpt": "example@example.com",
        "deliver_time": "2024-05-22T08:27:42Z",
        "err_code": "250",
        "failed_type": "SendOk",
        "env_id": "600000083914199845",
        "send_time": "2024-05-22T08:27:41Z",
        "err_msg": "250 Send Mail OK",
        "header": {},
        "from": "example2@aliyun.com",
        "event": "dm:Deliver:Succeed",
        "region": "cn-hangzhou",
        "msg_id": "d93a742c-adec-487d-8c39-98069c583760@example.net",
        "account": "example2@aliyun.com",
        "status": 0
    },
    "subject": "acs:dm:cn-hangzhou:1491110661959791:*",
    "aliyunoriginalaccountid": "1491110661959791",
    "source": "acs.dm",
    "type": "dm:Deliver:Succeed",
    "aliyunpublishtime": "2024-05-22T08:27:42.539Z",
    "specversion": "1.0",
    "aliyuneventbusname": "default",
    "id": "1223c134-b66d-4d53-b05e-780c0261ce22",
    "time": "2024-05-22T08:27:42.462Z",
    "aliyunregionid": "cn-hangzhou"
}

dm:Deliver:Fail

{
    "datacontenttype": "application/json;charset=utf-8",
    "aliyunaccountid": "1406423658557179",
    "data": {
        "rcpt": "dm-cccxcvzsupp***@alibaba-inc.com",
        "channel_name": "bg:alibabak",
        "deliver_time": "2025-05-06T08:25:35",
        "err_code": "554",
        "outbound_ip": "8.219.XX.XX",
        "failed_type": "SmtpNxBox",
        "env_id": "576461125340473909",
        "send_time": "2025-05-06T08:25:30",
        "err_msg": "554  RCPT (dm-cccxcvzsupport@alibaba-inc.com) dosn't exist",
        "header": {},
        "from": "dm@email.sdyyr.top",
        "event": "dm:Deliver:Fail",
        "region": "ap-southeast-1",
        "msg_id": "d00cacd9-4c40-4b0a-b049-ea35b5d06573@email.sdyyr.top",
        "account": "dm@email.sdyyr.top",
        "status": 2
    },
    "subject": "acs:dm:ap-southeast-1:1406423658557179:*",
    "aliyunoriginalaccountid": "1406423658557179",
    "source": "acs.dm",
    "type": "dm:Deliver:Fail",
    "aliyunpublishtime": "2025-05-06T08:25:35.634Z",
    "specversion": "1.0",
    "aliyuneventbusname": "default",
    "id": "b2063370-2e17-4be8-b19e-d912690f5aa1",
    "time": "2025-05-06T08:25:35.622Z",
    "aliyunregionid": "ap-southeast-1"
}

dm:Trace:Click

{
    "datacontenttype": "application/json;charset=utf-8",
    "aliyunaccountid": "1406423658557179",
    "data": {
        "rcpt": "dm-supp***@alibaba-inc.com",
        "env_id": "576461125225614607",
        "operateTime": "2025-05-06T08:33:41",
        "from": "dm@email.sdyyr.top",
        "client_ip": "42.120.XX.XXX",
        "userKp": "1406423658557179",
        "event": "dm:Trace:Click",
        "region": "ap-southeast-1",
        "msg_id": "8c34b82a-9a94-4e06-9579-963e846a688c@email.sdyyr.top",
        "url": "https://www.alibabacloud.com/help/en/direct-mail/user-guide/set-up-eventbridge"
    },
    "subject": "acs:dm:ap-southeast-1:1406423658557179:*",
    "aliyunoriginalaccountid": "1406423658557179",
    "source": "acs.dm",
    "type": "dm:Trace:Click",
    "aliyunpublishtime": "2025-05-06T08:33:41.472Z",
    "specversion": "1.0",
    "aliyuneventbusname": "default",
    "id": "0bf882fe-c9f8-4a29-bf26-7f0df7540c1c",
    "time": "2025-05-06T08:33:41.469Z",
    "aliyunregionid": "ap-southeast-1"
}

dm:Trace:Open

{
    "datacontenttype": "application/json;charset=utf-8",
    "aliyunaccountid": "1406423658557179",
    "data": {
        "rcpt": "dm-supp***@alibaba-inc.com",
        "env_id": "576461125225614607",
        "operateTime": "2025-05-06T08:33:36",
        "from": "dm@email.sdyyr.top",
        "client_ip": "42.120.XX.XXX",
        "userKp": "1406423658557179",
        "event": "dm:Trace:Open",
        "region": "ap-southeast-1",
        "msg_id": "8c34b82a-9a94-4e06-9579-963e846a688c@email.sdyyr.top"
    },
    "subject": "acs:dm:ap-southeast-1:1406423658557179:*",
    "aliyunoriginalaccountid": "1406423658557179",
    "source": "acs.dm",
    "type": "dm:Trace:Open",
    "aliyunpublishtime": "2025-05-06T08:33:36.336Z",
    "specversion": "1.0",
    "aliyuneventbusname": "default",
    "id": "a29d082d-3a21-4fa1-91e0-4a4ba183fd73",
    "time": "2025-05-06T08:33:36.335Z",
    "aliyunregionid": "ap-southeast-1"
}

dm:Feedback:FblReport

{
    "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@example.com",
        "block_email": "to@example.com",
        "subject": "Hello Mr.xxx",
        "message_id": "<msgid***@example.com>",
        "block_time": "1726821667",
        "fbl_isp": "outlook**",
        "fingerprint": "SMTPD_abc****"
    }
}

Untuk informasi lebih lanjut tentang bidang-bidang tersebut, lihat Event Direct Mail.

Catatan

Bidang waktu dalam detail event berada dalam format UTC.

2. Untuk memverifikasi alamat pengirim, kirim email dari batch@sg.example.top.

3. Anda dapat menemukan pesan ini di antrian MNS. Dalam contoh ini, MNS digunakan sebagai target event untuk menerima pesan event, sama seperti dalam prosedur menyiapkan Event Publishing. Anda dapat menetapkan target event sesuai kebutuhan.

4. Setelah Anda mengirim email dari alamat pengirim lain, Anda dapat menemukan detail event di Jejak Event di EventBridge. Namun, Anda tidak akan menerima pesan event ini di MNS. Ini menunjukkan bahwa notifikasi panggilan balik untuk alamat pengirim tertentu telah diimplementasikan.