Isi data acara yang SES diterbitkan Amazon ke Amazon SNS

Objek tingkat atas JSON Objek surat Objek pentalan Objek aduan Objek penyampaian Kirim objek Tolak objek Buka objek Klik objek Objek Kegagalan Rendering Objek DeliveryDelay Objek berlangganan

Amazon SES menerbitkan catatan peristiwa pengiriman email ke Amazon Simple Notification Service dalam JSON format.

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

JSONObjek tingkat atas dalam catatan peristiwa pengiriman email berisi bidang berikut. Jenis acara menentukan objek lain mana yang hadir.

Nama Bidang	Deskripsi
`eventType`	String yang menjelaskan tipe peristiwa. Nilai yang mungkin: `BounceComplaint`,`Delivery`,`Send`,,`Reject`,`Open`,`Click`,`Rendering Failure`,`DeliveryDelay`, atau`Subscription`. Jika Anda tidak menyiapkan penerbitan acara, bidang ini diberi nama`notificationType`.
`mail`	JSONObjek yang berisi informasi tentang email yang menghasilkan acara 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.

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

Nama Bidang	Deskripsi
`timestamp`	Tanggal dan waktu, dalam format ISO86 01 (YYYY-MM-:MM: DDThh SS.sz), saat pesan dikirim.
`messageId`	ID unik yang SES ditetapkan Amazon ke pesan. Amazon SES mengembalikan nilai ini kepada Anda saat Anda mengirim pesan. catatan ID pesan ini ditetapkan oleh AmazonSES. Anda dapat menemukan ID pesan email asli di bidang `headers` dan `commonHeaders` dari objek `mail`.
`source`	Alamat email tempat pesan dikirim (MAILFROMalamat amplop).
`sourceArn`	Nama Sumber Daya Amazon (ARN) dari identitas yang digunakan untuk mengirim email. Dalam hal mengirim otorisasi, itu `sourceArn` adalah identitas yang ARN pemilik identitas mengizinkan pengirim delegasi untuk digunakan untuk mengirim email. Untuk informasi selengkapnya tentang otorisasi pengiriman, lihat Metode autentikasi email.
`sendingAccountId`	ID AWS akun 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 ID pesan apa pun dalam `headers` bidang ini berasal dari pesan asli yang Anda kirimkan ke AmazonSES. ID pesan yang SES kemudian ditetapkan Amazon ke pesan ada di `messageId` bidang `mail` objek.
`commonHeaders`	Pemetaan header asli email yang umum digunakan. catatan Setiap ID pesan dalam `commonHeaders` bidang adalah ID pesan yang SES kemudian ditetapkan Amazon ke pesan di `messageId` bidang `mail` objek.
`tags`	Daftar tag yang terkait dengan email.

JSONObjek yang berisi informasi tentang suatu Bounce peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`bounceType`	Jenis bouncing, seperti yang ditentukan oleh AmazonSES.
`bounceSubType`	Subtipe pantulan, sebagaimana ditentukan oleh Amazon. SES
`bouncedRecipients`	Daftar yang berisi informasi tentang penerima email asli yang terpental.
`timestamp`	Tanggal dan waktu, dalam format ISO86 01 (YYYY-MM-:MM: SS.sz DDThh), ketika mengirim pemberitahuan bouncing. ISP
`feedbackId`	ID unik untuk pentalan.
`reportingMTA`	Nilai `Reporting-MTA` bidang dariDSN. Ini adalah nilai dari Message Transfer Authority (MTA) yang mencoba untuk melakukan pengiriman, relay, atau operasi gateway yang dijelaskan dalamDSN. catatan Bidang ini hanya muncul jika pemberitahuan status pengiriman (DSN) dilampirkan ke bouncing.

Peristiwa pentalan mungkin berkaitan dengan satu atau beberapa penerima. Bidang bouncedRecipients menyimpan daftar objek—satu objek per penerima yang alamat emailnya menghasilkan pentalan—dan berisi bidang berikut.

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

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

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

Setiap peristiwa pentalan adalah salah satu tipe yang ditunjukkan dalam tabel berikut.

Sistem penerbitan acara hanya menerbitkan hard bounce dan soft bounce yang tidak lagi dicoba lagi oleh Amazon. SES Ketika Anda menerima bounces yang ditandaiPermanent, Anda harus menghapus alamat email yang sesuai dari milis Anda; Anda tidak akan dapat mengirim kepada mereka di masa depan. TransientPantulan dikirimkan kepada Anda ketika pesan telah memantul beberapa kali, dan Amazon SES telah berhenti mencoba mengirimkannya 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 pantulan keras umum. Jika Anda menerima tipe pentalan ini, maka Anda harus menghapus alamat email penerima dari daftar email Anda.
`Permanent`	`NoEmail`	Amazon SES menerima hard bounce 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 menekan pengiriman ke alamat ini karena memiliki riwayat memantul baru-baru ini sebagai alamat yang tidak valid. Untuk mengganti daftar penindasan global, lihat. Menggunakan daftar SES penindasan tingkat akun Amazon
`Permanent`	`OnAccountSuppressionList`	Amazon SES telah menekan pengiriman ke alamat ini karena ada di daftar penindasan tingkat akun. Ini tidak dihitung terhadap metrik rasio pentalan Anda.
`Transient`	`General`	Amazon SES menerima pantulan umum. Anda mungkin akan berhasil mengirim ke penerima ini lain kali.
`Transient`	`MailboxFull`	Amazon SES menerima bouncing penuh kotak surat. Anda mungkin akan berhasil mengirim ke penerima ini lain kali.
`Transient`	`MessageTooLarge`	Amazon SES menerima pesan pantulan yang terlalu besar. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda mengurangi ukuran pesan.
`Transient`	`ContentRejected`	Amazon SES menerima bouncing konten yang ditolak. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda mengubah konten pesan.
`Transient`	`AttachmentRejected`	Amazon SES menerima bouncing lampiran yang ditolak. Anda mungkin akan berhasil mengirim ke penerima ini jika Anda menghapus atau mengubah lampiran.

JSONObjek yang berisi informasi tentang suatu Complaint peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`complainedRecipients`	Daftar yang berisi informasi tentang penerima yang mungkin telah mengirimkan aduan.
`timestamp`	Tanggal dan waktu, dalam format ISO86 01 (YYYY-MM-:MM: SS.sz DDThh), ketika mengirim pemberitahuan keluhan. ISP
`feedbackId`	ID unik untuk aduan.
`complaintSubType`	Subtipe keluhan, sebagaimana ditentukan oleh AmazonSES.

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 `Feedback-Type` bidang dari laporan umpan balik yang diterima dariISP. Ini berisi tipe umpan balik.
`arrivalDate`	Nilai `Arrival-Date` atau `Received-Date` bidang dari laporan umpan balik dalam format ISO86 01 (YYYY-MM DDThh -:MM: SS.sz). Bidang ini mungkin tidak ada dalam laporan (dan karena itu juga tidak ada dalamJSON).

Bidang complainedRecipients berisi daftar penerima yang mungkin telah mengirimkan aduan.

penting

Sebagian besar ISPs menyunting alamat email penerima yang mengajukan keluhan. Untuk alasan ini, bidang complainedRecipients menyertakan daftar semua orang yang dikirimi email yang alamatnya ada di domain yang mengeluarkan notifikasi aduan.

JSONobjek dalam daftar ini berisi bidang berikut.

Nama Bidang	Deskripsi
`emailAddress`	Alamat email penerima.

Anda dapat melihat jenis keluhan berikut di complaintFeedbackType bidang yang ditetapkan oleh pelaporanISP, menurut situs web Internet Assigned Numbers Authority:

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.

Nilai bidang complaintSubType bisa jadi tidak ada ataupun OnAccountSuppressionList. Jika nilainyaOnAccountSuppressionList, Amazon SES menerima pesan tersebut, tetapi tidak mencoba mengirimkannya karena ada di daftar penindasan tingkat akun.

JSONObjek yang berisi informasi tentang suatu Delivery peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`timestamp`	Tanggal dan waktu Amazon SES mengirimkan email ke server email penerima, dalam format ISO86 01 (YYYY-MM DDThh -:MM: SS.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 SMTP respons dari remote ISP yang menerima email dari AmazonSES. Pesan ini akan bervariasi menurut email, dengan menerima server email, dan dengan menerimaISP.
`reportingMTA`	Nama host dari server SES email Amazon yang mengirim email.

JSONObjek yang berisi informasi tentang suatu send peristiwa selalu kosong.

JSONObjek yang berisi informasi tentang suatu Reject peristiwa 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 mengandung virus. Ketika pesan ditolak, Amazon SES berhenti memprosesnya, dan tidak mencoba mengirimkannya ke server email penerima.

JSONObjek yang berisi informasi tentang suatu Open peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`ipAddress`	Alamat IP penerima.
`timestamp`	Tanggal dan waktu ketika peristiwa terbuka terjadi dalam format ISO86 01 (YYYY-MM DDThh -:MM: SS.sz).
`userAgent`	Agen pengguna perangkat atau klien email yang digunakan penerima untuk membuka email.

JSONObjek yang berisi informasi tentang suatu Click peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`ipAddress`	Alamat IP penerima.
`timestamp`	Tanggal dan waktu ketika peristiwa klik terjadi dalam format ISO86 01 (YYYY-MM DDThh -:MM: SS.sz).
`userAgent`	Agen pengguna klien yang digunakan penerima untuk mengeklik tautan di dalam email.
`link`	URLTautan yang diklik 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.

JSONObjek yang berisi informasi tentang suatu Rendering Failure peristiwa memiliki bidang berikut.

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

JSONObjek yang berisi informasi tentang suatu DeliveryDelay peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`delayType`	Tipe penundaan. Kemungkinan nilai adalah: InternalFailure— SES Masalah internal Amazon menyebabkan pesan tertunda. Umum — Kegagalan umum terjadi selama SMTP percakapan. 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. IPFailureAlamat IP yang mengirim pesan sedang diblokir atau dibatasi oleh penyedia email penerima. TransientCommunicationFailure— Ada kegagalan komunikasi sementara selama SMTP percakapan dengan penyedia email penerima. BYOIPHostNameLookupUnavailable— Amazon SES tidak dapat mencari DNS nama host untuk alamat IP Anda. Tipe penundaan ini hanya terjadi ketika Anda menggunakan Bawa IP Anda Sendiri. Belum ditentukan - Amazon SES tidak dapat menentukan alasan keterlambatan pengiriman. 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 ditunjukkan dalam format ISO 8601.
`reportingMTA`	Alamat IP dari Message Transfer Agent (MTA) yang melaporkan keterlambatan.
`timestamp`	Tanggal dan waktu ketika penundaan terjadi, ditampilkan dalam format ISO 8601.

Objek delayedRecipients berisi nilai-nilai berikut:

Nama Bidang	Deskripsi
`emailAddress`	Alamat email yang mengakibatkan penyampaian pesan tertunda.
`status`	Kode SMTP status yang terkait dengan penundaan pengiriman.
`diagnosticCode`	Kode diagnostik yang disediakan oleh Agen Transfer Pesan penerima (MTA).

JSONObjek yang berisi informasi tentang suatu Subscription peristiwa memiliki bidang berikut.

Nama Bidang	Deskripsi
`contactList`	Nama daftar kontak berada.
`timestamp`	Tanggal dan waktu, dalam format ISO86 01 (YYYY-MM-:MM: SS.sz DDThh), ketika mengirim pemberitahuan berlangganan. ISP
`source`	Alamat email tempat pesan dikirim (MAILFROMalamat amplop).
`newTopicPreferences`	JSONStruktur data (peta) yang menentukan status langganan semua topik dalam daftar kontak yang menunjukkan status setelah perubahan (kontak berlangganan atau berhenti berlangganan).
`oldTopicPreferences`	JSONStruktur data (peta) yang menentukan status langganan semua topik dalam daftar kontak yang menunjukkan status sebelum perubahan (kontak berlangganan atau berhenti berlangganan).

oldTopicPreferencesObjek newTopicPreferences dan berisi nilai-nilai berikut.

Nama Bidang	Deskripsi
`unsubscribeAll`	Menentukan apakah kontak berhenti berlangganan dari semua topik dalam daftar kontak.
`topicSubscriptionStatus`	Menentukan status langganan topik di `topicName` bidang yang menunjukkan apakah saat ini berlangganan untuk menerima pemberitahuan dari SES untuk jenis acara yang ditentukan. Nilai yang mungkin OptIn(berlangganan) atau OptOut(berhenti berlangganan) di bidang. `subscriptionStatus`
`topicDefaultSubscriptionStatus`	Menentukan status langganan default topik di `topicName` bidang menentukan apakah topik baru yang ditambahkan ke tujuan acara akan berlangganan atau berhenti berlangganan secara default. Nilai yang mungkin OptIn(berlangganan secara default) atau OptOut(berhenti berlangganan secara default) di bidang. `subscriptionStatus`

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menafsirkan data peristiwa dari Amazon SNS

Contoh rekaman peristiwa

Isi data acara yang SES diterbitkan Amazon ke Amazon SNS

Topik di bagian ini:

Objek tingkat atas JSON

Objek surat

catatan

catatan

catatan

Objek pentalan

catatan

Penerima yang terpental

Tipe pentalan

Objek aduan

Penerima yang diadukan

penting

Tipe aduan

Subtipe aduan

Objek penyampaian

Kirim objek

Tolak objek

Buka objek

Klik objek

Objek Kegagalan Rendering

DeliveryDelay objek

Penerima tertunda

Objek berlangganan

Preferensi topik baru/lama