Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES

Untuk memungkinkan Anda melacak pengiriman email pada tingkat yang terperinci, Anda dapat menyiapkan Amazon SES untuk menerbitkan peristiwa pengiriman email ke Amazon CloudWatch, Amazon Kinesis Data Firehose, atau Amazon Simple Notification Service berdasarkan karakteristik yang Anda tentukan.

Anda dapat melacak beberapa tipe peristiwa pengiriman email, yang meliputi pengiriman, penyampaian, pembukaan, pengeklikan, pentalan, aduan, penolakan, kegagalan rendering, dan penundaan penyampaian. Informasi ini dapat berguna untuk tujuan operasional dan analitis. Misalnya, Anda dapat memublikasikan data pengiriman email ke CloudWatch dan membuat dasbor yang melacak performa kampanye email Anda, atau Anda dapat menggunakan Amazon SNS untuk mengirimkan notifikasi saat peristiwa tertentu terjadi.

Cara kerja penerbitan peristiwa

Untuk menggunakan penerbitan peristiwa, Anda terlebih dahulu menyiapkan satu atau beberapa set konfigurasi. Sebuah set konfigurasi menentukan tempat untuk memublikasikan peristiwa Anda dan peristiwa yang akan dipublikasikan. Kemudian, setiap kali Anda mengirim email, Anda memberikan nama set konfigurasi dan satu atau beberapa tanda pesan, dalam bentuk pasangan nama/nilai, untuk mengategorikan email. Misalnya, jika Anda mengiklankan buku, maka Anda dapat menamai tanda pesan dengan genre, dan menetapkan nilai fiksi ilmiah atau barat, saat Anda mengirim email untuk kampanye terkait. Bergantung pada antarmuka pengiriman email yang Anda gunakan, Anda menyediakan tanda pesan sebagai parameter untuk panggilan API atau sebagai header email khusus Amazon SES. Untuk informasi selengkapnya tentang set konfigurasi, lihat Mengelola set konfigurasi di Amazon SES.

Selain tanda pesan yang Anda tentukan, Amazon SES juga menambahkan tanda otomatis ke pesan yang Anda kirim. Anda tidak perlu melakukan langkah-langkah tambahan untuk menggunakan tanda otomatis.

Tabel berikut mencantumkan tanda-otomatis yang secara otomatis diterapkan pada pesan yang Anda kirim menggunakan Amazon SES.

Tanda Otomatis Amazon SES
Nama tanda otomatis	Deskripsi
ses:configuration-set	Nama Set Konfigurasi yang terkait dengan email.
ses:caller-identity	Identitas IAM pengguna Amazon SES yang mengirimkan email.
ses:from-domain	Domain alamat “Dari”.
ses:source-ip	Alamat IP yang digunakan pemanggil untuk mengirimkan email.
ses:outgoing-ip	Alamat IP yang digunakan Amazon SES untuk mengirimkan email.

Cara menggunakan penerbitan peristiwa

Bagian berikut berisi informasi yang Anda perlukan untuk menyiapkan dan menggunakan penerbitan peristiwa Amazon SES.

• Menyiapkan penerbitan peristiwa

• Bekerja dengan data peristiwa

• Tutorial

Terminologi penerbitan peristiwa

Daftar berikut menentukan istilah yang terkait dengan penerbitan peristiwa Amazon SES.

Peristiwa pengiriman email

Informasi yang terkait dengan hasil email yang Anda kirimkan ke Amazon SES. Peristiwa pengiriman meliputi hal berikut:

• mengirim— Permintaan untuk mengirimkan berhasil dan Amazon SES akan mencoba untuk mengirimkan pesan ke server email penerima. (Jika penahanan tingkat akun atau global sedang digunakan, SES akan tetap dihitung sebagai pengiriman, namun penyampaian ditekan.)

• Kegagalan rendering— Email tidak terkirim karena masalah rendering templat. Tipe peristiwa ini dapat terjadi saat data templat tidak ada, atau jika ada ketidakcocokan antara parameter templat dan data. (Tipe peristiwa ini hanya terjadi ketika Anda mengirim email menggunakan operasi API SendTemplatedEmail atau SendBulkTemplatedEmail.)

• Tolak— Amazon SES menerima email, namun menentukan bahwa email tersebut berisi virus dan tidak mencoba mengirimkannya ke server email penerima.

• Pengiriman— Amazon SES berhasil mengirimkan email ke server email penerima.

• pentalan keras— Server email penerima secara permanen menolak email. (Pentalan lunak hanya disertakan saat Amazon SES gagal mengirimkan email setelah mencoba lagi selama jangka waktu tertentu.)

• Aduan— Email berhasil dikirim ke server email penerima, namun penerima menandainya sebagai spam.

• Penundaan Pengiriman— Email tidak dapat dikirim ke server email penerima karena terjadi masalah sementara. Penundaan penyamapaian dapat terjadi, misalnya, saat kotak masuk penerima penuh, atau saat server email penerima mengalami masalah sementara.

• Langganan— Email berhasil dikirim, namun penerima memperbarui preferensi langganan dengan mengeklikList-Unsubscribedi header email atauUnsubscribelink di footer.

• Buka— Penerima menerima pesan dan membukanya di klien email mereka.

• Klik— Penerima mengeklik satu atau beberapa tautan di email.

Set konfigurasi

Satu set aturan yang menentukan tujuan tempat Amazon SES menerbitkan peristiwa pengiriman email, dan tipe peristiwa pengiriman email yang ingin Anda terbitkan. Saat Anda mengirim email yang ingin Anda gunakan dengan penerbitan peristiwa, Anda menentukan set konfigurasi untuk dikaitkan dengan email.

Tujuan peristiwa

Layanan AWS tempat Anda menerbitkan peristiwa pengiriman email Amazon SES. Setiap tujuan peristiwa yang Anda siapkan adalah milik satu, dan hanya satu, set konfigurasi.

Tanda pesan

Pasangan nama/nilai yang Anda gunakan untuk mengategorikan email untuk tujuan penerbitan peristiwa. Contohnya adalah kampanye/buku dan kampanye/pakaian. Saat Anda mengirim email, Anda dapat menentukan tanda pesan sebagai parameter untuk panggilan API atau sebagai header email khusus Amazon SES.

Tanda otomatis

Tanda pesan yang secara otomatis disertakan dalam laporan penerbitan peristiwa. Ada tanda otomatis untuk nama set konfigurasi, domain alamat "Dari", alamat IP keluar pemanggil, alamat IP keluar Amazon SES, dan identitas IAM pemanggil.