Isi data peristiwa yang diterbitkan Amazon SES ke Firehose

Amazon SES menerbitkan catatan peristiwa pengiriman email ke Amazon Data Firehose dalam format JSON. Saat menerbitkan acara ke Firehose, Amazon SES mengikuti setiap rekaman JSON dengan karakter baris baru.

Anda dapat menemukan contoh catatan untuk semua tipe notifikasi ini di Contoh data peristiwa yang diterbitkan Amazon SES ke Firehose.

Objek JSON tingkat atas

Objek JSON tingkat-atas dalam catatan peristiwa pengiriman email berisi bidang-bidang berikut.

Nama Bidang	Deskripsi
eventType	String yang menjelaskan tipe peristiwa. Nilai yang mungkin: BounceComplaint,Delivery,Send,,Reject,Open,Click,Rendering Failure,DeliveryDelay, atauSubscription. Jika Anda tidak menyiapkan penerbitan acara, bidang ini diberi namanotificationType.
mail	Objek JSON yang berisi informasi tentang email yang menghasilkan peristiwa tersebut.
bounce	Bidang ini hanya ada jika eventType adalah Bounce. Bidang ini berisi informasi tentang pentalan.
complaint	Bidang ini hanya ada jika eventType adalah Complaint. Bidang ini berisi informasi tentang aduan.
delivery	Bidang ini hanya ada jika eventType adalah Delivery. Bidang ini berisi informasi tentang penyampaian.
send	Bidang ini hanya ada jika eventType adalah Send.
reject	Bidang ini hanya ada jika eventType adalah Reject. Bidang ini berisi informasi tentang penolakan.
open	Bidang ini hanya ada jika eventType adalah Open. Bidang ini berisi informasi tentang peristiwa pembukaan.
click	Bidang ini hanya ada jika eventType adalah Click. Bidang ini berisi informasi tentang peristiwa pengeklikan.
failure	Bidang ini hanya ada jika eventType adalah Rendering Failure. Bidang ini berisi informasi tentang peristiwa kegagalan rendering.
deliveryDelay	Bidang ini hanya ada jika eventType adalah DeliveryDelay. Bidang tersebut berisi informasi tentang penyampaian email yang tertunda.
subscription	Bidang ini hanya ada jika eventType adalah Subscription. Ini berisi informasi tentang preferensi berlangganan.

Objek surat

Setiap catatan peristiwa pengiriman email berisi informasi tentang email asli di dalam objek mail. Objek JSON yang berisi informasi tentang objek mail memiliki bidang berikut.

Nama Bidang	Deskripsi
timestamp	Tanggal dan waktu, dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ), ketika pesan dikirim.
messageId	ID unik yang ditetapkan Amazon SES ke pesan. Amazon SES mengembalikan nilai ini kepada Anda saat Anda mengirim pesan. catatan ID pesan ini ditetapkan oleh Amazon SES. Anda dapat menemukan ID pesan email asli di bidang headers dan commonHeaders dari objek mail.
source	Alamat email asal pesan dikirim (alamat envelope MAIL FROM).
sourceArn	Nama Amazon Resource Name (ARN) identitas yang digunakan untuk mengirim email. Dalam hal otorisasi pengiriman, sourceArn adalah ARN identitas yang pemilik identitasnya mengotorisasi penggunaan pengirim delegasi untuk mengirim email. Untuk informasi selengkapnya tentang otorisasi pengiriman, lihat Metode autentikasi email.
sendingAccountId	ID akun AWS dari akun yang digunakan untuk mengirim email. Dalam hal otorisasi pengiriman, sendingAccountId adalah ID akun pengirim delegasi.
destination	Daftar alamat email yang merupakan penerima email asli.
headersTruncated	String yang menentukan jika header terpotong atau tidak di dalam notifikasi, yang terjadi jika header lebih besar dari 10 KB. Nilai yang mungkin adalah true dan false.
headers	Daftar header asli email. Setiap header dalam daftar memiliki bidang name dan bidang value. catatan Setiap ID pesan dalam bidang headers berasal dari pesan asli yang Anda teruskan ke Amazon SES. ID pesan yang selanjutnya ditetapkan Amazon SES ke pesan ada di bidang messageId dari objek mail.
commonHeaders	Pemetaan header asli email yang umum digunakan. catatan ID pesan apa pun di dalam commonHeaders bidang adalah ID pesan yang kemudian ditetapkan Amazon SES ke pesan di messageId bidang mail objek.
tags	Daftar tag yang terkait dengan email.

Objek pentalan

Objek JSON yang berisi informasi tentang peristiwa Bounce akan selalu memiliki bidang berikut.

Nama Bidang	Deskripsi
bounceType	Tipe pentalan, seperti yang ditentukan oleh Amazon SES.
bounceSubType	Subtipe pentalan, seperti yang ditentukan oleh Amazon SES.
bouncedRecipients	Daftar yang berisi informasi tentang penerima email asli yang terpental.
timestamp	Tanggal dan waktu, dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ), ketika ISP mengirim notifikasi pentalan.
feedbackId	ID unik untuk pentalan.
reportingMTA	Nilai bidang Reporting-MTA dari DSN. Nilai ini adalah nilai dari Message Transfer Authority (MTA) yang mencoba melakukan operasi penyampaian, penggantian, atau gateway yang dijelaskan dalam DSN. catatan Bidang ini hanya muncul jika notifikasi status penyampaian (DSN) dilampirkan ke pentalan.

Penerima yang terpental

Peristiwa pentalan mungkin berkaitan dengan satu atau beberapa penerima. Bidang bouncedRecipients menyimpan daftar objek—satu objek per penerima yang terkait dengan peristiwa pentalan—dan akan selalu berisi bidang berikut.

Nama Bidang	Deskripsi
emailAddress	Alamat email penerima. Jika DSN tersedia, ini adalah nilai bidang Final-Recipient dari DSN.

Secara opsional, jika DSN dilampirkan ke pentalan, bidang berikut mungkin juga ada.

Nama Bidang	Deskripsi
action	Nilai bidang Action dari DSN. Hal ini menunjukkan tindakan yang dilakukan oleh MTA pelaporan sebagai akibat dari upayanya untuk menyampaikan pesan ke penerima ini.
status	Nilai bidang Status dari DSN. Ini adalah kode status bebas-transportasi per penerima yang menunjukkan status penyampaian pesan.
diagnosticCode	Kode status yang dikeluarkan oleh MTA pelaporan. Ini adalah nilai bidang Diagnostic-Code dari DSN. Bidang ini mungkin tidak ada di DSN (dan karena itu juga tidak ada di JSON).

Tipe pentalan

Setiap peristiwa pentalan akan menjadi salah satu tipe yang ditunjukkan pada tabel berikut.

Sistem penerbitan peristiwa hanya menerbitkan pentalan keras dan pentalan lunak yang tidak akan lagi dicoba ulang oleh Amazon SES. Saat Anda menerima pentalan bertanda Permanent, Anda harus menghapus alamat-alamat email yang sesuai dari daftar email Anda; Anda tidak akan dapat mengirim kepada alamat-alamat tersebut di masa mendatang. Pentalan Transient dikirimkan kepada Anda saat pesan terpental lunak beberapa kali, dan Amazon SES telah berhenti mencoba menyampaikannya kembali. Anda mungkin akan berhasil mengirim ulang ke alamat yang awalnya menghasilkan pentalan Transient lain kali.

bounceType	bounceSubType	Deskripsi
Undetermined	Undetermined	Amazon SES tidak dapat menentukan alasan pentalan tertentu.
Permanent	General	Amazon SES menerima pentalan keras umum. Jika Anda menerima tipe pentalan ini, maka Anda harus menghapus alamat email penerima dari daftar email Anda.
Permanent	NoEmail	Amazon SES menerima pentalan keras permanen karena alamat email target tidak ada. Jika Anda menerima tipe pentalan ini, maka Anda harus menghapus alamat email penerima dari daftar email Anda.
Permanent	Suppressed	Amazon SES telah menahan pengiriman ke alamat ini karena memiliki riwayat terpental baru-baru ini sebagai alamat yang tidak valid. Untuk mengganti daftar penindasan global, lihat. Menggunakan daftar penindasan tingkat akun Amazon SES
Permanent	OnAccountSuppressionList	Amazon SES telah menahan pengiriman ke alamat ini karena berada di daftar penahanan tingkat akun. Ini tidak dihitung terhadap metrik rasio pentalan Anda.
Transient	General	Amazon SES menerima pentalan umum. Anda mungkin akan berhasil mengirim ke penerima ini lain kali.
Transient	MailboxFull	Amazon SES menerima pentalan penuh kotak surat. Anda mungkin akan berhasil mengirim ke penerima ini lain kali.
Transient	MessageTooLarge	Amazon SES menerima pesan pentalan yang terlalu besar. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda mengurangi ukuran pesan.
Transient	ContentRejected	Amazon SES menerima pentalan yang ditolak konten. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda mengubah konten pesan.
Transient	AttachmentRejected	Amazon SES menerima pentalan yang ditolak lampiran. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda menghapus atau mengubah lampiran.

Objek aduan

Objek JSON yang berisi informasi tentang peristiwa Complaint memiliki bidang berikut.

Nama Bidang	Deskripsi
complainedRecipients	Daftar yang berisi informasi tentang penerima yang mungkin telah mengirimkan aduan.
timestamp	Tanggal dan waktu, dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ), ketika ISP mengirim notifikasi aduan.
feedbackId	ID unik untuk aduan.
complaintSubType	Subtipe aduan, seperti yang ditentukan oleh Amazon SES.

Selanjutnya, jika laporan umpan balik dilampirkan pada aduan, bidang berikut mungkin ada.

Nama Bidang	Deskripsi
userAgent	Nilai bidang User-Agent dari laporan umpan balik. Nilai ini menunjukkan nama dan versi sistem yang menghasilkan laporan.
complaintFeedbackType	Nilai bidang Feedback-Type dari laporan umpan balik yang diterima dari ISP. Ini berisi tipe umpan balik.
arrivalDate	Nilai bidang Arrival-Date atau Received-Date dari laporan umpan balik dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ). Bidang ini mungkin tidak ada dalam laporan (dan karenanya juga tidak ada di JSON).

Penerima yang diadukan

Bidang complainedRecipients berisi daftar penerima yang mungkin telah mengirimkan aduan.

penting

Karena sebagian besar ISP menyunting alamat email penerima yang mengirimkan aduan dari notifikasi aduan mereka, daftar ini berisi informasi tentang penerima yang mungkin telah mengirimkan aduan, berdasarkan penerima pesan asli dan ISP tempat kami menerima aduan. Amazon SES melakukan pencarian terhadap pesan asli untuk menentukan daftar penerima ini.

Objek JSON dalam daftar ini berisi bidang berikut.

Nama Bidang	Deskripsi
emailAddress	Alamat email penerima.

Tipe aduan

Anda mungkin melihat tipe aduan berikut di dalam bidang complaintFeedbackType sebagaimana ditetapkan oleh ISP pelaporan, sesuai dengan Situs Web Otoritas Nomor yang Ditetapkan Internet:

Nama Bidang	Deskripsi
abuse	Menunjukkan email yang tidak diminta atau beberapa jenis penyalahgunaan email lainnya.
auth-failure	Laporan kegagalan otentikasi email.
fraud	Menunjukkan beberapa jenis penipuan atau aktivitas phishing.
not-spam	Menunjukkan bahwa entitas yang menyediakan laporan tidak menganggap pesan tersebut sebagai spam. Tindakan ini dapat digunakan untuk memperbaiki pesan yang salah ditandai atau dikategorikan sebagai spam.
other	Menunjukkan umpan balik lain yang tidak sesuai dengan tipe terdaftar lainnya.
virus	Melaporkan bahwa virus ditemukan dalam pesan asal.

Objek penyampaian

Objek JSON yang berisi informasi tentang peristiwa Delivery yang akan selalu memiliki bidang berikut.

Nama Bidang	Deskripsi
timestamp	Tanggal dan waktu ketika Amazon SES menyampaikan email ke server email penerima, dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ).
processingTimeMillis	Waktu dalam milidetik, antara saat Amazon SES menerima permintaan dari pengirim hingga saat Amazon SES meneruskan pesan ke server email penerima.
recipients	Daftar penerima yang dituju yang berlaku untuk peristiwa penyampaian.
smtpResponse	Pesan respons SMTP dari ISP jarak jauh yang menerima email dari Amazon SES. Pesan ini akan bervariasi menurut email, server email penerimaan, dan ISP penerimaan.
reportingMTA	Nama host server email Amazon SES yang mengirim email.

Kirim objek

Objek JSON yang berisi informasi tentang peristiwa send selalu kosong.

Tolak objek

Objek JSON yang berisi informasi tentang peristiwa Reject akan selalu memiliki bidang berikut.

Nama Bidang	Deskripsi
reason	Alasan email ditolak. Satu-satunya nilai yang mungkin adalah Bad content, yang berarti Amazon SES mendeteksi bahwa email tersebut berisi virus. Saat pesan ditolak, Amazon SES berhenti memprosesnya, dan tidak berusaha mengirimkannya ke server email penerima.

Buka objek

Objek JSON yang berisi informasi tentang peristiwa Open akan selalu berisi bidang berikut.

Nama Bidang	Deskripsi
ipAddress	Alamat IP penerima.
timestamp	Tanggal dan waktu ketika peristiwa pembukaan terjadi dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ).
userAgent	Agen pengguna perangkat atau klien email yang digunakan penerima untuk membuka email.

Klik objek

Objek JSON yang berisi informasi tentang peristiwa Click akan selalu berisi bidang berikut.

Nama Bidang	Deskripsi
ipAddress	Alamat IP penerima.
timestamp	Tanggal dan waktu ketika peristiwa pengeklikan terjadi dalam format ISO8601 (HH-BB-TTTTTjj:mm:dd.sZ).
userAgent	Agen pengguna klien yang digunakan penerima untuk mengeklik tautan di dalam email.
link	URL tautan yang diklik oleh penerima.
linkTags	Daftar tanda yang ditambahkan ke tautan menggunakan atribut ses:tags. Untuk informasi selengkapnya tentang menambahkan tanda ke tautan di email Anda, lihat T5. Dapatkah saya menandai tautan dengan pengenal unik? dalam FAQ metrik pengiriman email Amazon SES.

Objek Kegagalan Rendering

Objek JSON yang berisi informasi tentang peristiwa Rendering Failure memiliki bidang berikut.

Nama Bidang	Deskripsi
templateName	Nama templat yang digunakan untuk mengirim email.
errorMessage	Pesan yang menyediakan informasi selengkapnya tentang kegagalan rendering.

DeliveryDelay objek

Objek JSON yang berisi informasi tentang peristiwa DeliveryDelay memiliki bidang berikut.

Nama Bidang	Deskripsi
delayType	Tipe penundaan. Kemungkinan nilai adalah: InternalFailure— Masalah internal Amazon SES menyebabkan pesan tertunda. Umum – Kegagalan umum terjadi selama percakapan SMTP. MailboxFull— Kotak pesan penerima penuh dan tidak dapat menerima pesan tambahan. SpamDetected— Server email penerima telah mendeteksi sejumlah besar email yang tidak diminta dari akun Anda. RecipientServerError— Masalah sementara dengan server email penerima mencegah pengiriman pesan. IPFailure – Alamat IP yang mengirim pesan diblokir atau di-throttling oleh penyedia email penerima. TransientCommunicationFailure— Ada kegagalan komunikasi sementara selama percakapan SMTP dengan penyedia email penerima. BYOIP HostNameLookupUnavailable - Amazon SES tidak dapat mencari nama host DNS untuk alamat IP Anda. Tipe penundaan ini hanya terjadi ketika Anda menggunakan Bawa IP Anda Sendiri. Tidak dapat ditentukan – Amazon SES tidak dapat menentukan alasan penundaan penyampaian. SendingDeferral— Amazon SES telah menganggap pantas untuk menunda pesan secara internal.
delayedRecipients	Objek yang berisi informasi tentang penerima email.
expirationTime	Tanggal dan waktu ketika Amazon SES akan berhenti mencoba menyampaikan pesan. Nilai ini ditampilkan dalam format ISO 8601.
reportingMTA	Alamat IP Message Transfer Agent (MTA) yang melaporkan penundaan.
timestamp	Tanggal dan waktu terjadinya penundaan, ditampilkan dalam format ISO 8601.

Penerima tertunda

Objek delayedRecipients berisi nilai-nilai berikut:

Nama Bidang	Deskripsi
emailAddress	Alamat email yang mengakibatkan penyampaian pesan tertunda.
status	Kode status SMTP yang terkait dengan penundaan penyampaian.
diagnosticCode	Kode diagnostik yang disediakan oleh Message Transfer Agent (MTA) penerimaan.

Objek berlangganan

Objek JSON yang berisi informasi tentang peristiwa Subscription memiliki bidang berikut.

Nama Bidang	Deskripsi
contactList	Nama daftar kontak berada.
timestamp	Tanggal dan waktu, dalam format ISO8601 (YYYY-MM-DDTHH: MM: SS.sz), ketika ISP mengirim pemberitahuan berlangganan.
source	Alamat email asal pesan dikirim (alamat envelope MAIL FROM).
newTopicPreferences	Struktur data JSON (peta) yang menentukan status langganan semua topik dalam daftar kontak yang menunjukkan status setelah perubahan (kontak berlangganan atau berhenti berlangganan).
oldTopicPreferences	Struktur data JSON (peta) yang menentukan status langganan semua topik dalam daftar kontak yang menunjukkan status sebelum perubahan (kontak berlangganan atau berhenti berlangganan).

Preferensi topik baru/lama

oldTopicPreferencesObjek newTopicPreferences dan berisi nilai-nilai berikut.

Nama Bidang	Deskripsi
unsubscribeAll	Menentukan apakah kontak berhenti berlangganan dari semua topik dalam daftar kontak.
topicSubscriptionStatus	Menentukan topik di topicName bidang dan memetakan status langganan (OptInatau OptOut) di subscriptionStatus bidang.
topicDefaultSubscriptionStatus	Menentukan topik di topicName bidang dan memetakan status langganan (OptInatau OptOut) di subscriptionStatus bidang.