Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES - Layanan Email Sederhana Amazon

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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.

Umpan balik halus untuk kampanye email

ses:feedback-id-<a or b>Tag adalah tag pesan opsional yang dapat Anda anggap sebagai tag hibrida atau semi-otomatis—meskipun mirip dengan tag otomatis yang dibahas di bagian sebelumnya, perbedaannya adalah Anda harus menambahkannya secara manual dan menggunakan kunci awalan. ses: Anda dapat menggunakan hingga dua tag ini yang didefinisikan sebagai ses:feedback-id-a danses:feedback-id-b.

Saat Anda menentukan tag ini, SES secara otomatis menambahkannya ke Feedback-ID header standar yang digunakan dalam menyediakan statistik pengiriman, seperti tingkat keluhan dan spam, sebagai bagian dari loop umpan balik (FBL), lihat. Loop umpan balik Feedback-IDHeader terdiri dari pengenal, SesInternalid, yang digunakan oleh SES untuk mengumpulkan informasi keluhan, dan tag statis, AmazonSes, mengidentifikasi SES sebagai platform pengiriman seperti:

FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))

Tag ID umpan balik opsional ini ditawarkan sebagai cara bagi Anda untuk menghasilkan umpan balik halus, seperti untuk pesan yang Anda kirim sebagai bagian dari kampanye email. Anda dapat menggunakan ses:feedback-id-<a or b> dengan menentukannya sebagai tag pesan di EmailTagsbidang permintaan SendEmailoperasi seperti yang ditunjukkan pada contoh berikut:

{ "FromEmailAddress": "noreply@example.com", "Destination": { "ToAddresses": [ "customer@example.net" ] }, "Content": { "Simple": { "Subject": { "Data": "Hello and welcome" }, "Body": { "Text": { "Data": "Lorem ipsum dolor sit amet." }, "Html": { "Data": "Lorem ipsum dolor sit amet." } } } }, "EmailTags": [ { "Name": "ses:feedback-id-a", "Value": "new-members-campaign" }, { "Name": "ses:feedback-id-b", "Value": "football-campaign" } ], "ConfigurationSetName": "football-club" }

Jika mengirim dalam format mentah, Anda akan menambahkan ses:feedback-id-<a or b> sebagai tag pesan ke header khusus SES. X-SES-MESSAGE-TAGS

Tag ses:feedback-id-<a or b> pesan juga dapat dilacak di Amazon CloudWatch dengan menentukannya sebagai sumber CloudWatch nilai seperti tag pesan lainnya, lihat Menambahkan Destinasi CloudWatch Acara (Biaya tambahan berlaku, lihat Harga per metrik untuk CloudWatch.)

Cara menggunakan penerbitan peristiwa

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

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.

  • BouncePantulan keras yang server email penerima menolak email secara permanen. (Pantulan lunak hanya disertakan ketika SES tidak lagi mencoba mengirimkan email. Umumnya pantulan lunak ini menunjukkan kegagalan pengiriman, meskipun dalam beberapa kasus pantulan lunak dapat dikembalikan bahkan ketika surat berhasil mencapai kotak masuk penerima. Ini biasanya terjadi ketika penerima mengirim balasan out-of-office otomatis. Pelajari lebih lanjut tentang soft bounce di artikel AWS re:Post ini.)

  • 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 dikirimkan, 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.