Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES

Untuk memungkinkan Anda melacak pengiriman email pada tingkat terperinci, Anda dapat mengatur Amazon SES untuk mempublikasikan peristiwa pengiriman email ke Amazon, Amazon Data Firehose CloudWatch, Amazon Pinpoint, 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 mempublikasikan data pengiriman email ke CloudWatch dan membuat dasbor yang melacak kinerja kampanye email Anda, atau Anda dapat menggunakan Amazon SNS untuk mengirimi Anda pemberitahuan ketika peristiwa tertentu terjadi.

Cara kerja penerbitan acara dengan set konfigurasi dan tag pesan

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 dapat memberikan tag pesan sebagai parameter ke EmailTagsbidang operasi SendEmailAPI atau menambahkan tag pesan ke header email khusus SES. X-SES-MESSAGE-TAGS 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:caller-identity	Identitas IAM pengguna Amazon SES yang mengirimkan email.
ses:configuration-set	Nama Set Konfigurasi yang terkait dengan email.
ses:from-domain	Domain alamat “Dari”.
ses:outgoing-ip	Alamat IP yang digunakan Amazon SES untuk mengirimkan email.
ses:source-ip	Alamat IP yang digunakan pemanggil untuk mengirimkan email.
ses:source-tls-version	Versi protokol TLS yang digunakan penelepon untuk mengirim 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

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:

• Kirim — Permintaan kirim berhasil dan Amazon SES akan mencoba mengirimkan pesan ke server email penerima. (Jika tingkat akun atau penekanan global sedang digunakan, SES masih akan menghitungnya sebagai kirim, tetapi pengiriman ditekan.)

• RenderingFailure— Email tidak dikirim karena masalah rendering template. 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 tersebut, tetapi memutuskan bahwa email tersebut berisi virus dan tidak berusaha mengirimkannya ke server email penerima.

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

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

• Keluhan — Email berhasil dikirim ke server email penerima, tetapi penerima menandainya sebagai spam.

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

• Langganan — Email berhasil dikirim, tetapi penerima memperbarui preferensi langganan dengan mengklik List-Unsubscribe header email atau Unsubscribe tautan di footer.

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

• Klik — Penerima mengklik 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

AWS Layanan tempat Anda mempublikasikan acara 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.