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

# Isi data peristiwa yang diterbitkan Amazon SES ke Firehose
<a name="event-publishing-retrieving-firehose-contents"></a>

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](event-publishing-retrieving-firehose-examples.md).

**Topics**
+ [Objek JSON tingkat atas](#event-publishing-retrieving-firehose-contents-top-level-json-object)
+ [Objek surat](#event-publishing-retrieving-firehose-contents-mail-object)
+ [Objek pentalan](#event-publishing-retrieving-firehose-contents-bounce-object)
+ [Objek aduan](#event-publishing-retrieving-firehose-contents-complaint-object)
+ [Objek penyampaian](#event-publishing-retrieving-firehose-contents-delivery-object)
+ [Kirim objek](#event-publishing-retrieving-firehose-contents-send-object)
+ [Tolak objek](#event-publishing-retrieving-firehose-contents-reject-object)
+ [Buka objek](#event-publishing-retrieving-firehose-contents-open-object)
+ [Klik objek](#event-publishing-retrieving-firehose-contents-click-object)
+ [Objek Kegagalan Rendering](#event-publishing-retrieving-firehose-contents-failure-object)
+ [DeliveryDelay objek](#event-publishing-retrieving-firehose-delivery-delay-object)
+ [Objek berlangganan](#event-publishing-retrieving-firehose-subscription-object)

## Objek JSON tingkat atas
<a name="event-publishing-retrieving-firehose-contents-top-level-json-object"></a>

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: `Bounce``Complaint`,`Delivery`,`Send`,,`Reject`,`Open`,`Click`,`Rendering Failure`,`DeliveryDelay`, atau`Subscription`. Jika Anda tidak [menyiapkan penerbitan acara](monitor-sending-using-event-publishing-setup.md), bidang ini diberi nama`notificationType`.  | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-mail-object"></a>

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 ISO8601 format (*YYYY-MM-:MM: DDThh* SS.sz), saat pesan dikirim.  | 
|  `messageId`  |  ID unik yang ditetapkan Amazon SES ke pesan. Amazon SES mengembalikan nilai ini kepada Anda saat Anda mengirim pesan.  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 emailMenggunakan otorisasi pengiriman](sending-authorization.md).  | 
|  `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`.  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.  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
<a name="event-publishing-retrieving-firehose-contents-bounce-object"></a>

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 ISO8601 format (*YYYY-MM-:MM: DDThh SS.sz*), ketika ISP mengirim pemberitahuan bouncing.  | 
|  `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.  Bidang ini hanya muncul jika notifikasi status penyampaian (DSN) dilampirkan ke pentalan.   | 

### Penerima yang terpental
<a name="event-publishing-retrieving-firehose-contents-bounced-recipients"></a>

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
<a name="event-publishing-retrieving-firehose-contents-bounce-types"></a>

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](sending-email-suppression-list.md)   | 
| Permanent | OnAccountSuppressionList | Amazon SES telah menahan pengiriman ke alamat ini karena berada di [daftar penahanan tingkat akun](sending-email-suppression-list.md). 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`  |  `CustomTimeoutExceeded`  |  Amazon SES tidak berhasil mengirimkan email dalam waktu yang ditentukan oleh pengirim email. *(Pesan bouncing akan menentukan alasan kemungkinan kegagalan upaya pengiriman dalam TTL yang ditentukan.)*   | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-complaint-object"></a>

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 ISO8601 format (*YYYY-MM-:MM: DDThh SS.sz*), ketika ISP mengirim pemberitahuan keluhan.  | 
|  `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 `Arrival-Date` atau `Received-Date` bidang dari laporan umpan balik dalam ISO8601 format (*YYYY-MM* -:MM: SS.sz). DDThh Bidang ini mungkin tidak ada dalam laporan (dan karenanya juga tidak ada di JSON).  | 

### Penerima yang diadukan
<a name="event-publishing-retrieving-firehose-contents-complained-recipients"></a>

Bidang `complainedRecipients` berisi daftar penerima yang mungkin telah mengirimkan aduan. 

**penting**  
Karena sebagian besar ISPs menyunting alamat email penerima yang mengajukan keluhan dari pemberitahuan keluhan mereka, daftar ini berisi informasi tentang penerima yang mungkin telah mengirim keluhan, berdasarkan penerima pesan asli dan ISP tempat kami menerima keluhan. 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
<a name="event-publishing-retrieving-firehose-contents-complaint-types"></a>

Anda mungkin melihat tipe aduan berikut di dalam bidang `complaintFeedbackType` sebagaimana ditetapkan oleh ISP pelaporan, sesuai dengan [Situs Web Otoritas Nomor yang Ditetapkan Internet](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):


| 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
<a name="event-publishing-retrieving-firehose-contents-delivery-object"></a>

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


| Nama Bidang | Deskripsi | 
| --- | --- | 
|  `timestamp`  |  Tanggal dan waktu ketika Amazon SES mengirimkan email ke server email penerima, dalam ISO8601 format (*YYYY-MM* -:MM: SS.sz). DDThh  | 
|  `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.  | 
|  `remoteMtaIp`  |  Alamat IP dari MTA tempat Amazon SES mengirimkan email.  | 

## Kirim objek
<a name="event-publishing-retrieving-firehose-contents-send-object"></a>

Objek JSON yang berisi informasi tentang peristiwa `send` selalu kosong.

## Tolak objek
<a name="event-publishing-retrieving-firehose-contents-reject-object"></a>

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
<a name="event-publishing-retrieving-firehose-contents-open-object"></a>

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 terbuka terjadi dalam ISO8601 format (*YYYY-MM* -:MM: SS.sz). DDThh  | 
|  `userAgent`  |  Agen pengguna perangkat atau klien email yang digunakan penerima untuk membuka email.  | 

## Klik objek
<a name="event-publishing-retrieving-firehose-contents-click-object"></a>

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 klik terjadi dalam ISO8601 format (*YYYY-MM* -:MM: SS.sz). DDThh  | 
|  `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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) dalam [Metrik pengiriman email Amazon SES FAQs](faqs-metrics.md).  | 

## Objek Kegagalan Rendering
<a name="event-publishing-retrieving-firehose-contents-failure-object"></a>

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
<a name="event-publishing-retrieving-firehose-delivery-delay-object"></a>

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


| Nama Bidang | Deskripsi | 
| --- | --- | 
|  `delayType`  |  Tipe penundaan. Kemungkinan nilai adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/event-publishing-retrieving-firehose-contents.html)  | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-delivery-delay-object-recipients"></a>

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
<a name="event-publishing-retrieving-firehose-subscription-object"></a>

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


| Nama Bidang | Deskripsi | 
| --- | --- | 
|  `contactList`  |  Nama daftar kontak berada.  | 
|  `timestamp`  |  Tanggal dan waktu, dalam ISO8601 format *(YYYY-MM-:MM: DDThh SS.sz*), ketika ISP mengirim notifikasi 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
<a name="event-publishing-retrieving-firehose-contents-subscription-object-topic-preferences"></a>

`oldTopicPreferences`Objek `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`  |