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 Anda pada tingkat terperinci, Anda dapat mengatur Amazon SES untuk mempublikasikan *peristiwa pengiriman email* ke Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service, atau EventBridge Amazon 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 lebih *tag pesan*, dalam bentuk name/value pasangan, untuk mengkategorikan 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 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags)bidang operasi [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)API atau menambahkan tag pesan ke header email khusus SES. [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) Untuk informasi selengkapnya tentang set konfigurasi, lihat [Mengelola set konfigurasi di Amazon SES](using-configuration-sets.md).
Selain tag pesan yang Anda tentukan, SES juga menambahkan *tag otomatis* ke pesan yang Anda kirim. Anda tidak perlu melakukan langkah-langkah tambahan untuk menggunakan tanda otomatis.
Tabel berikut mencantumkan tag otomatis yang diterapkan secara otomatis ke pesan yang Anda kirim menggunakan SES.
**Tag Otomatis SES**
| Nama tanda otomatis | Deskripsi |
| --- | --- |
| ses:caller-identity | Identitas IAM dari pengguna SES yang mengirim email. |
| ses:configuration-set | Nama Set Konfigurasi yang terkait dengan email. |
| ses:from-domain | Domain alamat “Dari”. |
| ses:outgoing-ip | Alamat IP yang digunakan SES untuk mengirim 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. |
| ses:outgoing-tls-version | Versi protokol TLS yang digunakan SES untuk mengirim email. |
## Umpan balik halus untuk kampanye email
`ses:feedback-id-`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` dan`ses: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](faqs-enforcement.md#cm-feedback-loop) `Feedback-ID`Header 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-` dengan menentukannya sebagai tag pesan di [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags)bidang permintaan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operasi 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-` sebagai tag pesan ke header khusus SES. [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers)
Tag `ses:feedback-id-` pesan juga dapat dilacak di Amazon CloudWatch dengan menentukannya sebagai sumber CloudWatch nilai seperti tag pesan lainnya, lihat [Menambahkan Destinasi CloudWatch Acara](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add) *(Biaya tambahan berlaku, lihat [Harga per metrik untuk CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)*.)
## Cara menggunakan penerbitan peristiwa
Bagian berikut berisi informasi yang Anda butuhkan untuk mengatur dan menggunakan penerbitan acara SES.
+ [Menyiapkan penerbitan peristiwa](monitor-sending-using-event-publishing-setup.md)
+ [Bekerja dengan data peristiwa](working-with-event-data.md)
## Terminologi penerbitan peristiwa
Daftar berikut mendefinisikan istilah yang terkait dengan penerbitan acara SES.
**Peristiwa pengiriman email**
Informasi yang terkait dengan hasil email yang Anda kirimkan ke 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 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) atau [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html).)
+ **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. (*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](https://repost.aws/knowledge-center/ses-understand-soft-bounces) 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**
Seperangkat aturan yang menentukan tujuan dimana SES menerbitkan peristiwa pengiriman email, dan jenis peristiwa pengiriman email yang ingin Anda publikasikan. 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 memublikasikan acara pengiriman email SES. Setiap tujuan peristiwa yang Anda siapkan adalah milik satu, dan hanya satu, set konfigurasi.
**Tanda pesan**
name/value Pasangan yang Anda gunakan untuk mengkategorikan email untuk tujuan penerbitan acara. Contohnya adalah *kampanye/buku* dan *kampanye/pakaian*. Saat mengirim email, Anda dapat menentukan tag pesan sebagai parameter untuk panggilan API atau sebagai header email khusus SES.
**Tanda otomatis**
Tanda pesan yang secara otomatis disertakan dalam laporan penerbitan peristiwa. Ada tag otomatis untuk nama set konfigurasi, domain alamat “Dari”, alamat IP keluar pemanggil, alamat IP keluar SES, dan identitas IAM pemanggil.
# Menyiapkan penerbitan peristiwa Amazon SES
Bagian ini menjelaskan apa yang perlu Anda lakukan untuk mengonfigurasi Amazon SES untuk mempublikasikan peristiwa pengiriman email Anda ke AWS layanan berikut:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
Langkah-langkah berikut yang diperlukan untuk menyiapkan penerbitan peristiwa tercakup dalam topik di bawah ini:
1. Anda harus membuat *set konfigurasi* menggunakan konsol Amazon SES atau API.
1. Tambahkan satu atau beberapa *tujuan acara* (CloudWatch, Firehose, Pinpoint, atau SNS) ke set konfigurasi, dan konfigurasikan parameter unik untuk tujuan acara.
1. Saat Anda mengirimkan email, Anda menentukan konfigurasi yang akan digunakan yang berisi tujuan peristiwa Anda.
**Topics**
+ [Langkah 1: Buat Set Konfigurasi](event-publishing-create-configuration-set.md)
+ [Langkah 2: Tambahkan tujuan peristiwa](event-publishing-add-event-destination.md)
+ [Langkah 3: Tentukan set konfigurasi saat Anda mengirim email](event-publishing-send-email.md)
# Langkah 1: Buat Set Konfigurasi
Anda harus terlebih dahulu memiliki set konfigurasi untuk menyiapkan penerbitan peristiwa. Jika Anda belum memiliki set konfigurasi, atau ingin membuat yang baru, silakan lihat [Membuat set konfigurasi di SES](creating-configuration-sets.md)
Anda juga dapat membuat set konfigurasi menggunakan [CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)operasi di Amazon SES API V2 atau Amazon SES CLI v2, lihat. [Buat set konfigurasi. (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli)
# Langkah 2: Tambahkan tujuan peristiwa
Tujuan peristiwa adalah tempat Anda memublikasikan peristiwa Amazon SES. Setiap tujuan peristiwa yang Anda siapkan adalah milik satu, dan hanya satu, set konfigurasi. Saat menyiapkan tujuan acara dengan Amazon SES, Anda memilih tujuan AWS layanan, dan Anda menentukan parameter yang terkait dengan tujuan tersebut.
Saat menyiapkan tujuan acara, Anda dapat memilih untuk mengirim acara ke salah satu AWS layanan berikut:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon EventBridge
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
Tujuan peristiwa yang Anda pilih bergantung pada tingkat detail terkait peristiwa sesuai keinginan Anda, dan cara menerima informasi peristiwa sesuai keinginan Anda. Jika Anda hanya ingin total berjalan dari setiap jenis acara (misalnya, sehingga Anda dapat mengatur alarm ketika totalnya terlalu tinggi), Anda dapat menggunakannya CloudWatch.
Jika Anda menginginkan catatan peristiwa terperinci yang dapat Anda keluarkan ke layanan lain seperti Amazon OpenSearch Service atau Amazon Redshift untuk analisis, Anda dapat menggunakan Firehose.
Jika Anda ingin menerima notifikasi ketika peristiwa tertentu terjadi, maka Anda dapat menggunakan Amazon SNS.
**Topics**
+ [Menyiapkan tujuan CloudWatch acara untuk penerbitan acara](event-publishing-add-event-destination-cloudwatch.md)
+ [Menyiapkan tujuan acara Firehose Data untuk penerbitan acara Amazon SES](event-publishing-add-event-destination-firehose.md)
+ [Menyiapkan EventBridge tujuan Amazon untuk penerbitan acara](event-publishing-add-event-destination-eventbridge.md)
+ [Siapkan tujuan acara Amazon Pinpoint untuk penerbitan acara](event-publishing-add-event-destination-pinpoint.md)
+ [Siapkan tujuan peristiwa Amazon SNS untuk penerbitan peristiwa](event-publishing-add-event-destination-sns.md)
# Menyiapkan tujuan CloudWatch acara untuk penerbitan acara
Dengan [ CloudWatch metrik Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), Anda dapat menggunakan tujuan acara untuk mempublikasikan acara pengiriman email Amazon SES. CloudWatch Karena tujuan CloudWatch acara hanya dapat diatur dalam set konfigurasi, Anda harus terlebih dahulu [membuat set konfigurasi](event-publishing-create-configuration-set.md) dan kemudian menambahkan tujuan acara ke set konfigurasi.
Saat Anda menambahkan tujuan CloudWatch acara ke set konfigurasi, Anda harus memilih satu atau beberapa CloudWatch *dimensi* yang sesuai dengan tag pesan yang Anda gunakan saat mengirim email. Seperti tag pesan, CloudWatch dimensi adalah name/value pasangan yang membantu Anda mengidentifikasi metrik secara unik.
Misalnya, Anda mungkin memiliki tanda pesan dan dimensi yang disebut `campaign` yang Anda gunakan untuk mengidentifikasi kampanye email Anda. Ketika Anda mempublikasikan acara pengiriman email ke CloudWatch, memilih tag dan dimensi pesan Anda penting karena pilihan ini memengaruhi CloudWatch penagihan Anda dan menentukan bagaimana Anda dapat memfilter data peristiwa pengiriman email Anda. CloudWatch
Bagian ini memberikan informasi untuk membantu Anda memilih dimensi, dan kemudian menunjukkan cara menambahkan tujuan CloudWatch acara ke set konfigurasi.
**Topics**
+ [Menambahkan Destinasi CloudWatch Acara](#event-publishing-add-event-destination-cloudwatch-add)
+ [Memilih CloudWatch Dimensi](#event-publishing-add-event-destination-cloudwatch-dimensions)
## Menambahkan Destinasi CloudWatch Acara
Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan CloudWatch acara ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
Anda juga dapat menggunakan [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operasi di Amazon SES API V2 untuk membuat dan memodifikasi tujuan acara.
**Untuk menambahkan detail tujuan CloudWatch acara ke set konfigurasi menggunakan konsol**
1. Ini adalah petunjuk terperinci untuk memilih CloudWatch sebagai jenis tujuan acara Anda di [Langkah 7](event-destinations-manage.md#specify-event-dest-step) dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add) Setelah memilih **jenis CloudWatch Tujuan**, memasukkan **Nama** tujuan, dan mengaktifkan **penerbitan Acara**, panel ** CloudWatch dimensi Amazon** akan ditampilkan—bidangnya akan dibahas dalam langkah-langkah berikut. *(Biaya tambahan berlaku, lihat [Harga per metrik untuk CloudWatch](#cw-add-pricing).)*
1. Untuk **Sumber Nilai**, tentukan bagaimana Amazon SES akan mendapatkan data yang diteruskan CloudWatch. Sumber nilai berikut tersedia:
+ **Tanda Pesan** – Amazon SES mengambil nama dan nilai dimensi dari tanda yang Anda tentukan dengan menggunakan header `X-SES-MESSAGE-TAGS` atau parameter API `EmailTags`. Untuk informasi selengkapnya tentang penggunaan tanda pesan, lihat [Langkah 3: Tentukan set konfigurasi saat Anda mengirim email](event-publishing-send-email.md).
**catatan**
Tanda pesan dapat mencakup angka 0–9, huruf A–Z (huruf besar dan kecil), tanda hubung (-), dan garis bawah (\$1).
Anda juga dapat menggunakan sumber nilai **Tanda Pesan** untuk membuat dimensi berdasarkan tanda otomatis Amazon SES. Untuk menggunakan tanda otomatis, ketik nama lengkap dari tanda otomatis tersebut sebagai **Nama Dimensi**. Misalnya, untuk membuat dimensi berdasarkan tanda otomatis set konfigurasi, gunakan `ses:configuration-set` untuk **Nama Dimensi**, dan nama set konfigurasi untuk **Nilai Default**. Untuk daftar lengkap tanda otomatis, lihat [Cara kerja penerbitan acara dengan set konfigurasi dan tag pesan](monitor-using-event-publishing.md#event-publishing-how-works).
+ **Header Email** – Amazon SES mengambil nama dan nilai dimensi dari header di dalam email.
**catatan**
Anda tidak dapat menggunakan header email berikut sebagai **Nama Dimensi**: `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id`, atau `Return-Path`.
+ **Tanda Tautan** – Amazon SES mengambil nama dan nilai dimensi dari tanda yang Anda tentukan di tautan. Untuk informasi selengkapnya tentang menambahkan tanda ke tautan, lihat [Dapatkah saya menandai tautan dengan pengenal unik?](faqs-metrics.md#sending-metric-faqs-clicks-q5).
1. Untuk **Nama Dimensi**, ketik nama dimensi yang ingin Anda lewati CloudWatch.
**catatan**
Nama dimensi hanya dapat berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (\$1), dan tanda hubung (-). Spasi, karakter beraksen, karakter non-Latin, dan karakter khusus lainnya tidak diperbolehkan.
1. Untuk **Nilai default**, ketik nilai dimensi.
**catatan**
Nilai dimensi hanya dapat berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (\$1), tanda hubung (-), pada tanda (@), dan titik (.). Spasi, karakter beraksen, karakter non-Latin, dan karakter khusus lainnya tidak diperbolehkan.
1. Jika Anda ingin menambahkan dimensi lagi, pilih **Tambahkan Dimensi**. Jika tidak, pilih **Selanjutnya**.
1. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih **Tambahkan tujuan**.
## Memilih CloudWatch Dimensi
Saat Anda memilih nama dan nilai untuk digunakan sebagai CloudWatch dimensi, pertimbangkan faktor-faktor berikut:
+ **Harga per metrik** — Anda dapat melihat metrik dasar Amazon SES secara CloudWatch gratis. Namun, ketika Anda mengumpulkan metrik menggunakan penerbitan acara, Anda dikenakan biaya [Pemantauan CloudWatch Terperinci](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Setiap kombinasi unik dari jenis peristiwa, nama dimensi, dan nilai dimensi menciptakan metrik yang berbeda CloudWatch. Saat Anda menggunakan CloudWatch, Pemantauan Terperinci, Anda dikenakan biaya untuk setiap metrik. Karena alasan ini, Anda mungkin ingin menghindari memilih dimensi yang dapat menghasilkan banyak nilai berbeda. Misalnya, kecuali Anda sangat tertarik untuk melacak peristiwa pengiriman email dengan domain "Dari", Anda mungkin tidak ingin menentukan dimensi untuk tanda otomatis Amazon SES `ses:from-domain` karena dapat menghasilkan banyak nilai berbeda. Untuk informasi selengkapnya, silakan lihat [Harga CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Pemfilteran metrik** — Jika metrik memiliki beberapa dimensi, Anda tidak dapat mengakses metrik CloudWatch berdasarkan setiap dimensi secara terpisah. Untuk alasan itu, pikirkan baik-baik sebelum Anda menambahkan lebih dari satu dimensi ke satu tujuan CloudWatch acara. Misalnya, jika Anda menginginkan metrik menurut `campaign` dan menurut kombinasi `campaign` dan `genre`, maka Anda perlu menambahkan dua tujuan peristiwa: satu hanya dengan `campaign` sebagai dimensi, dan satu dengan `campaign` dan `genre` sebagai dimensi.
+ **Sumber nilai dimensi** – Sebagai alternatif untuk menentukan nilai dimensi Anda menggunakan header khusus Amazon SES atau parameter ke API, Anda juga dapat memilih Amazon SES untuk mengambil nilai dimensi dari header pesan MIME Anda sendiri. Anda dapat menggunakan opsi ini jika Anda sudah menggunakan header kustom dan tidak ingin mengubah email atau panggilan Anda ke API pengiriman email untuk mengumpulkan metrik berdasarkan nilai header Anda. Jika Anda menggunakan header pesan MIME milik Anda sendiri untuk penerbitan peristiwa Amazon SES, maka nama dan nilai header yang Anda gunakan untuk penerbitan peristiwa Amazon SES hanya dapat menyertakan huruf A sampai Z, angka 0 sampai 9, garis bawah (\$1), tanda at (@), tanda hubung (-), dan titik (.). Jika Anda menentukan nama atau nilai yang berisi karakter lain, panggilan pengiriman email akan tetap berhasil, tetapi metrik acara tidak akan dikirim ke Amazon CloudWatch.
Untuk informasi selengkapnya tentang CloudWatch konsep, lihat [ CloudWatch Konsep Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) *di Panduan CloudWatch Pengguna Amazon*.
# Menyiapkan tujuan acara Firehose Data untuk penerbitan acara Amazon SES
Tujuan acara Amazon Data Firehose mewakili entitas yang menerbitkan peristiwa pengiriman email Amazon SES tertentu ke Firehose. Karena tujuan peristiwa Firehose hanya dapat diatur dalam set konfigurasi, Anda harus terlebih dahulu [membuat set konfigurasi](event-publishing-create-configuration-set.md). Selanjutnya, Anda menambahkan tujuan peristiwa ke set konfigurasi.
Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan acara Firehose ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
Anda juga dapat menggunakan [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operasi di tujuan Amazon SES API V2 untuk membuat dan memperbarui tujuan acara.
**Untuk menambahkan detail tujuan acara Firehose ke set konfigurasi menggunakan konsol**
1. Ini adalah petunjuk terperinci untuk memilih Firehose sebagai jenis tujuan acara Anda di [Langkah 7](event-destinations-manage.md#specify-event-dest-step) dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add) Setelah memilih **jenis Destinasi** Firehose, memasukkan **Nama** tujuan, dan mengaktifkan **penerbitan Acara**, panel **aliran pengiriman Amazon Data Firehose** akan ditampilkan—bidangnya akan dibahas dalam langkah-langkah berikut.
1. Untuk **aliran Pengiriman**, pilih aliran pengiriman Firehose yang ada, atau pilih **Buat aliran baru** untuk membuat yang baru menggunakan Firehose console.
Untuk informasi tentang membuat stream menggunakan Firehose console, lihat [Membuat Aliran Pengiriman Amazon Kinesis Firehose di Panduan Pengembang *Amazon* Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html).
1. Untuk Peran **Identity and Access Management (IAM), pilih peran** IAM yang izinnya dipublikasikan Amazon SES ke Firehose atas nama Anda. Anda dapat memilih peran yang sudah ada, meminta Amazon SES membuat peran untuk Anda, atau membuat peran Anda sendiri.
Jika Anda memilih peran yang ada atau membuat peran Anda sendiri, Anda harus mengubah kebijakan peran secara manual untuk memberikan izin peran untuk mengakses aliran pengiriman Firehose, dan memberikan izin Amazon SES untuk mengambil peran tersebut. Untuk kebijakan-kebijakan contoh, lihat [Memberikan Izin Amazon SES untuk Mempublikasikan ke Aliran Pengiriman Firehose Anda](#event-publishing-add-event-destination-firehose-role).
1. Pilih **Berikutnya**.
1. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih **Tambahkan tujuan**.
Untuk informasi tentang cara menggunakan `UpdateConfigurationSetEventDestination` API untuk menambahkan tujuan peristiwa Firehose, lihat Referensi [API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html).
## Memberikan Izin Amazon SES untuk Mempublikasikan ke Aliran Pengiriman Firehose Anda
Untuk mengaktifkan Amazon SES memublikasikan catatan ke aliran pengiriman Firehose, Anda harus menggunakan [peran AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) (IAM) dan melampirkan atau memodifikasi kebijakan izin dan kebijakan kepercayaan peran tersebut. Kebijakan izin memungkinkan peran untuk memublikasikan catatan ke aliran pengiriman Firehose Anda, dan kebijakan kepercayaan memungkinkan Amazon SES untuk mengambil peran tersebut.
Bagian ini menyediakan contoh dari kedua kebijakan tersebut. Untuk informasi tentang pelampiran kebijakan untuk IAM role, lihat [Mengubah Peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) dalam *Panduan Pengguna IAM*.
### Kebijakan Izin
Kebijakan izin berikut memungkinkan peran untuk memublikasikan catatan data ke aliran pengiriman Firehose Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Action": [
"firehose:PutRecordBatch"
],
"Resource": [
"arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name"
]
}
]
}
```
------
Buat perubahan berikut ke contoh kebijakan sebelumnya:
+ Ganti *delivery-region* dengan AWS Wilayah tempat Anda membuat aliran pengiriman Firehose.
+ Ganti *111122223333* dengan ID akun AWS Anda.
+ Ganti *delivery-stream-name* dengan nama aliran pengiriman Firehose.
### Kebijakan Kepercayaan
Kebijakan kepercayaan berikut memungkinkan Amazon SES untuk mengambil peran.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Buat perubahan berikut ke contoh kebijakan sebelumnya:
+ Ganti *delivery-region* dengan AWS Wilayah tempat Anda membuat aliran pengiriman Firehose.
+ Ganti *111122223333* dengan ID akun AWS Anda.
+ Ganti *configuration-set-name* dengan nama set konfigurasi yang terkait dengan aliran pengiriman Firehose.
# Menyiapkan EventBridge tujuan Amazon untuk penerbitan acara
Tujuan EventBridge acara Amazon memberi tahu Anda tentang peristiwa pengiriman email yang Anda tentukan dalam set konfigurasi. SES menghasilkan dan mengirim peristiwa pengiriman email yang Anda tentukan saat membuat tujuan acara ke bus acara EventBridge default. [Bus acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) adalah router yang menerima acara dan dapat mengirimkannya ke beberapa tujuan. Anda dapat mempelajari lebih lanjut tentang mengintegrasikan acara pengiriman email dengan Amazon EventBridge di[Memantau peristiwa SES menggunakan Amazon EventBridge](monitoring-eventbridge.md). Karena tujuan EventBridge acara hanya dapat diatur dalam set konfigurasi, Anda harus [membuat set konfigurasi](event-publishing-create-configuration-set.md) sebelum menambahkan tujuan acara ke set konfigurasi.
Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan EventBridge acara ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
Anda juga dapat menggunakan [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operasi di Amazon SES API V2 untuk membuat dan memodifikasi tujuan acara.
**Untuk menambahkan detail tujuan EventBridge acara ke set konfigurasi menggunakan konsol**
1. Ini adalah petunjuk terperinci untuk memilih EventBridge sebagai jenis tujuan acara Anda di [Langkah 7](event-destinations-manage.md#specify-event-dest-step) dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add) Setelah memilih **jenis EventBridge Tujuan** *Amazon*, memasukkan **Nama** tujuan, dan mengaktifkan **penerbitan Acara**, panel informasi **bus EventBridge acara Amazon** akan ditampilkan.
1. Pilih **Berikutnya**.
1. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih **Tambahkan tujuan**. Ini akan membuka halaman ringkasan tujuan acara di mana spanduk sukses akan mengonfirmasi apakah tujuan acara Anda berhasil dibuat atau diubah.
# Siapkan tujuan acara Amazon Pinpoint untuk penerbitan acara
Tujuan acara Amazon Pinpoint memberi tahu Anda tentang peristiwa pengiriman email yang Anda tentukan dalam set konfigurasi. Karena tujuan peristiwa Amazon Pinpoint hanya dapat diatur dalam set konfigurasi, Anda harus [membuat set konfigurasi](event-publishing-create-configuration-set.md) sebelum menambahkan tujuan acara ke set konfigurasi.
Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan peristiwa Amazon Pinpoint ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
Anda juga dapat menggunakan [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operasi di Amazon SES API V2 untuk membuat dan memodifikasi tujuan acara.
Ada biaya tambahan untuk jenis saluran yang telah Anda konfigurasikan dalam proyek Amazon Pinpoint Anda. Untuk informasi selengkapnya, lihat [Harga Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
**Untuk menambahkan detail tujuan acara Amazon Pinpoint ke set konfigurasi menggunakan konsol**
1. Ini adalah petunjuk terperinci untuk memilih Amazon Pinpoint sebagai jenis tujuan acara Anda di [Langkah 7](event-destinations-manage.md#specify-event-dest-step) dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
**catatan**
**Amazon Pinpoint tidak mendukung jenis acara **Penundaan pengiriman** atau Langganan.**
Setelah memilih **jenis Tujuan Amazon Pinpoint, memasukkan **Nama** tujuan**, dan mengaktifkan **penerbitan Acara**, panel **detail proyek Amazon Pinpoint** akan ditampilkan—bidangnya akan dibahas dalam langkah-langkah berikut.
1. Untuk **Project**, pilih proyek Amazon Pinpoint yang ada, atau pilih **Buat proyek baru di Amazon Pinpoint** untuk membuat yang baru.
Untuk informasi tentang membuat proyek, lihat [Membuat proyek](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) di *Panduan Pengguna Amazon Pinpoint*.
1. Pilih **Berikutnya**.
1. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih **Tambahkan tujuan**. Ini akan membuka halaman ringkasan tujuan acara di mana spanduk sukses akan mengonfirmasi apakah tujuan acara Anda berhasil dibuat atau diubah.
# Siapkan tujuan peristiwa Amazon SNS untuk penerbitan peristiwa
Tujuan acara Amazon SNS memberi tahu Anda tentang peristiwa pengiriman email yang Anda tentukan dalam set konfigurasi. Karena tujuan acara Amazon SNS hanya dapat diatur dalam set konfigurasi, Anda harus [membuat set konfigurasi](event-publishing-create-configuration-set.md) sebelum menambahkan tujuan acara ke set konfigurasi.
Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan acara Amazon SNS ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add)
Anda juga dapat menggunakan [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operasi di Amazon SES API V2 untuk membuat dan memodifikasi tujuan acara.
**catatan**
Pemberitahuan umpan balik untuk bouncing, keluhan, dan pengiriman juga dapat diatur melalui Amazon SNS untuk identitas pengiriman terverifikasi Anda. Untuk informasi lebih lanjut, lihat. [Mengonfigurasi notifikasi Amazon SNS untuk Amazon SES](configure-sns-notifications.md).
Ada biaya tambahan untuk mengirim pesan ke titik akhir yang berlangganan ke topik Amazon SNS Anda. Untuk informasi lebih lanjut, lihat [Harga Amazon SNS](https://aws.amazon.com/sns/pricing/).
**Untuk menambahkan detail tujuan peristiwa Amazon SNS ke set konfigurasi menggunakan konsol**
1. Ini adalah petunjuk terperinci untuk memilih Amazon SNS sebagai jenis tujuan acara Anda di [Langkah 7](event-destinations-manage.md#specify-event-dest-step) dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. [Membuat tujuan acara](event-destinations-manage.md#event-destination-add) Setelah memilih **jenis Tujuan Amazon SNS, memasukkan **Nama** tujuan**, dan mengaktifkan **penerbitan Acara**, panel topik **Amazon Simple Notification Service (SNS)** akan ditampilkan—bidangnya akan dibahas dalam langkah-langkah berikut.
1. Untuk **Topik SNS**, pilih topik Amazon SNS yang sudah ada, atau pilih **Buat topik SNS** untuk membuat topik baru.
Untuk informasi selengkapnya, lihat [Buat topik](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dalam *Panduan Developer Amazon Simple Notification Service*.
**penting**
**Saat Anda membuat topik menggunakan Amazon SNS, untuk **Jenis**, pilih saja Standar.** (SES tidak mendukung topik tipe FIFO.)
1. Pilih **Berikutnya**.
1. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih **Tambahkan tujuan**. Ini akan membuka halaman ringkasan tujuan acara di mana spanduk sukses akan mengonfirmasi apakah tujuan acara Anda berhasil dibuat atau diubah.
1. Apakah Anda membuat topik SNS baru atau memilih yang sudah ada, Anda sekarang perlu memberikan akses ke SES untuk mempublikasikan pemberitahuan ke topik tersebut. Pada halaman ringkasan tujuan acara dari langkah sebelumnya, pilih **Amazon SNS** dari kolom **Jenis tujuan** - ini akan membawa Anda ke daftar **Topik** di konsol Layanan Pemberitahuan Sederhana Amazon - *lakukan langkah-langkah berikut dari konsol Amazon SNS*:
1. Pilih nama topik SNS yang Anda buat atau modifikasi pada langkah sebelumnya.
1. Pada layar detail topik, pilih **Edit**.
1. Untuk memberikan izin SES untuk mempublikasikan pemberitahuan ke topik, pada layar **Edit topik** di konsol SNS, perluas **kebijakan Access** dan di **editor JSON**, tambahkan kebijakan izin berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Buat perubahan berikut ke contoh kebijakan sebelumnya:
+ Ganti *topic\$1region* dengan AWS Wilayah tempat Anda membuat topik SNS.
+ Ganti *111122223333* dengan ID AWS akun Anda.
+ Ganti *topic\$1name* dengan nama topik SNS Anda.
+ Ganti *configuration-set-name* dengan nama set konfigurasi Anda yang terkait dengan tujuan acara SNS.
1. Pilih **Simpan perubahan**.
# Langkah 3: Tentukan set konfigurasi saat Anda mengirim email
Setelah Anda [buat satu set konfigurasi](event-publishing-create-configuration-set.md) dan [tambahkan tujuan peristiwa](event-publishing-add-event-destination.md), langkah terakhir untuk penerbitan peristiwa adalah dengan mengirim email Anda.
Untuk menerbitkan peristiwa yang terkait dengan email, Anda harus menyediakan nama konfigurasi yang diatur untuk dikaitkan dengan email. Secara opsional, Anda dapat memberikan tanda pesan untuk mengategorikan email.
Anda menyediakan informasi ini ke Amazon SES sebagai parameter untuk API pengiriman email, header email khusus Amazon SES, atau header kustom dalam pesan MIME Anda. Metode yang Anda pilih tergantung pada antarmuka pengiriman email yang Anda gunakan, seperti yang ditunjukkan pada tabel berikut.
****
| Antarmuka Pengiriman Email | Cara Menerbitkan Peristiwa |
| --- | --- |
| `SendEmail` | Parameter API: |
| `SendTemplatedEmail` | Parameter API: |
| `SendBulkTemplatedEmail` | Parameter API: |
| `SendCustomVerificationEmail` | Parameter API: |
| `SendRawEmail` | Parameter API, header email khusus Amazon SES, atau header MIME kustom Jika Anda menentukan tanda pesan menggunakan header dan parameter API, Amazon SES hanya menggunakan tanda pesan yang disediakan oleh parameter API. Amazon SES tidak menggabungkan tanda pesan yang ditentukan oleh parameter dan header API. |
| Antarmuka SMTP | Header email khusus Amazon SES |
Bagian berikut menjelaskan cara menentukan set konfigurasi dan tanda pesan menggunakan header dan menggunakan parameter API.
+ [Menggunakan Parameter API Amazon SES](#event-publishing-using-ses-parameters)
+ [Menggunakan Header Email Khusus Amazon SES](#event-publishing-using-ses-headers)
+ [Menggunakan Header Email Kustom](#event-publishing-using-custom-headers)
**catatan**
Anda dapat secara opsional menyertakan tanda pesan di header email Anda. Tanda pesan dapat mencakup angka 0–9, huruf A–Z (huruf besar dan kecil), tanda hubung (-), dan garis bawah (\$1).
## Menggunakan Parameter API Amazon SES
Untuk menggunakan [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html), [SendTemplatedEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), [SendBulkTemplatedEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html), [SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html), atau [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)dengan penerbitan acara, Anda menentukan set konfigurasi dan tag pesan dengan meneruskan struktur data yang dipanggil [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)dan [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)ke panggilan API.
Untuk informasi selengkapnya tentang cara menggunakan API Amazon SES, lihat [Referensi API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Menggunakan Header Email Khusus Amazon SES
Saat Anda menggunakan `SendRawEmail` atau antarmuka SMTP, Anda dapat menentukan set konfigurasi dan tanda pesan dengan menambahkan header khusus Amazon SES ke email. Amazon SES menghapus header sebelum mengirim email. Tabel berikut menunjukkan nama-nama header yang akan digunakan.
| Informasi Penerbitan Peristiwa | Header |
| --- | --- |
| Set konfigurasi | `X-SES-CONFIGURATION-SET` |
| Tanda pesan | `X-SES-MESSAGE-TAGS` |
Contoh berikut menunjukkan bagaimana header dapat terlihat dalam email mentah yang Anda kirimkan ke Amazon SES.
```
1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
2. X-SES-CONFIGURATION-SET: myConfigurationSet
3. From: sender@example.com
4. To: recipient@example.com
5. Subject: Subject
6. Content-Type: multipart/alternative;
7. boundary="----=_boundary"
8.
9. ------=_boundary
10. Content-Type: text/plain; charset=UTF-8
11. Content-Transfer-Encoding: 7bit
12.
13. body
14. ------=_boundary
15. Content-Type: text/html; charset=UTF-8
16. Content-Transfer-Encoding: 7bit
17.
18. body
19. ------=_boundary--
```
## Menggunakan Header Email Kustom
Meskipun Anda harus menentukan nama set konfigurasi menggunakan header khusus Amazon SES `X-SES-CONFIGURATION-SET`, Anda dapat menentukan tanda pesan dengan menggunakan header MIME Anda sendiri.
**catatan**
Nama dan nilai header yang Anda gunakan untuk penerbitan peristiwa Amazon SES harus dalam ASCII. Jika Anda menentukan nama atau nilai header non-ASCII untuk penerbitan acara Amazon SES, panggilan pengiriman email akan tetap berhasil, tetapi metrik acara tidak akan dipancarkan ke Amazon. CloudWatch
# Bekerja dengan data peristiwa Amazon SES
Setelah Anda [menyiapkan penerbitan peristiwa](monitor-sending-using-event-publishing-setup.md) dan menentukan set konfigurasi untuk mengirim email, Anda dapat mengambil peristiwa pengiriman email dari tujuan peristiwa yang Anda tentukan saat menyiapkan set konfigurasi yang terkait dengan email.
Bagian ini menjelaskan cara mengambil peristiwa pengiriman email Anda dari Amazon CloudWatch dan Amazon Data Firehose, dan cara menafsirkan data peristiwa yang disediakan oleh Amazon SNS.
+ [Mengambil data acara Amazon SES dari CloudWatch](event-publishing-retrieving-cloudwatch.md)
+ [Mengambil data peristiwa Amazon SES dari Firehose](event-publishing-retrieving-firehose.md)
+ [Menafsirkan data peristiwa Amazon SES dari Amazon SNS](event-publishing-retrieving-sns.md)
# Mengambil data acara Amazon SES dari CloudWatch
Amazon SES dapat mempublikasikan metrik untuk acara pengiriman email Anda ke Amazon CloudWatch. Saat Anda mempublikasikan data peristiwa CloudWatch, data ini menyediakan metrik ini sebagai kumpulan data deret waktu yang diurutkan. Anda dapat menggunakan metrik ini untuk memantau performa pengiriman email Anda. Misalnya, Anda dapat memantau metrik keluhan dan mengatur CloudWatch alarm untuk memicu ketika metrik melebihi nilai tertentu.
Ada dua tingkat perincian di mana Amazon SES dapat mempublikasikan acara ini ke: CloudWatch
+ **Di seluruh Anda Akun AWS** — Metrik kasar ini, yang sesuai dengan metrik yang Anda pantau menggunakan konsol Amazon SES dan `GetSendStatistics` API, adalah total di seluruh Anda. Akun AWS Amazon SES menerbitkan metrik ini secara otomatis. CloudWatch
+ **Detail** – Metrik ini dikategorikan berdasarkan karakteristik email yang Anda tentukan menggunakan *tanda pesan*. Untuk memublikasikan metrik ini CloudWatch, Anda harus [menyiapkan penerbitan CloudWatch acara](monitor-sending-using-event-publishing-setup.md) dengan tujuan acara dan [menentukan set konfigurasi](event-publishing-send-email.md) saat mengirim email. Anda juga dapat menentukan tanda pesan atau menggunakan [tanda otomatis](monitor-using-event-publishing.md#event-publishing-how-works) yang disediakan oleh Amazon SES secara otomatis.
Bagian ini menjelaskan metrik yang tersedia dan cara melihat metrik di. CloudWatch
## Metrik yang Tersedia
Anda dapat mempublikasikan metrik pengiriman email Amazon SES berikut ke CloudWatch:
+ **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 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) atau [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html).)
+ **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. (*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](https://repost.aws/knowledge-center/ses-understand-soft-bounces) 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 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.
## Dimensi yang Tersedia
CloudWatch menggunakan nama dimensi yang Anda tentukan saat menambahkan tujuan CloudWatch acara ke set konfigurasi di Amazon SES. Untuk informasi selengkapnya, lihat [Menyiapkan tujuan CloudWatch acara untuk penerbitan acara](event-publishing-add-event-destination-cloudwatch.md).
## Melihat Metrik Amazon SES di Konsol CloudWatch
Prosedur berikut menjelaskan cara melihat metrik penerbitan acara Amazon SES Anda menggunakan CloudWatch konsol.
**Untuk melihat metrik menggunakan konsol CloudWatch**
1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Jika perlu, ubah wilayahnya. Dari bilah navigasi, pilih wilayah tempat AWS sumber daya Anda berada. Untuk informasi selengkapnya, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html).
1. Di panel navigasi, pilih **Semua Metrik**.
1. **Di panel **Metrik**, pilih SES.**
1. Pilih metrik yang ingin Anda lihat. Untuk melihat [metrik penerbitan acara](monitor-using-event-publishing.md) berbutir halus, pilih kombinasi dimensi yang Anda tentukan saat [menyiapkan](event-publishing-add-event-destination-cloudwatch.md) tujuan acara. CloudWatch Untuk mempelajari selengkapnya tentang melihat metrik dengan CloudWatch, lihat [Menggunakan CloudWatch metrik Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
**Untuk melihat metrik menggunakan AWS CLI**
+ Pada prompt perintah, gunakan perintah berikut:
```
1. aws cloudwatch list-metrics --namespace "AWS/SES"
```
# Mengambil data peristiwa Amazon SES dari Firehose
Amazon SES menerbitkan acara pengiriman email ke Firehose sebagai catatan JSON. Firehose kemudian menerbitkan catatan ke tujuan AWS layanan yang Anda pilih saat mengatur aliran pengiriman di Firehose. Untuk informasi tentang menyiapkan aliran pengiriman Firehose, lihat Membuat Aliran Pengiriman [Firehose di Panduan Pengembang Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) *Data* Amazon.
**Topics**
+ [Isi data peristiwa yang diterbitkan Amazon SES ke Firehose](event-publishing-retrieving-firehose-contents.md)
+ [Contoh data peristiwa yang diterbitkan Amazon SES ke Firehose](event-publishing-retrieving-firehose-examples.md)
# 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](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
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
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
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
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](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
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
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
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
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
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 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
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
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: [\[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
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 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
`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` |
# Contoh data peristiwa yang diterbitkan Amazon SES ke Firehose
Bagian ini memberikan contoh jenis catatan peristiwa pengiriman email yang diterbitkan Amazon SES ke Firehose.
**Topics**
+ [Rekaman pentalan](#event-publishing-retrieving-firehose-bounce)
+ [Catatan aduan](#event-publishing-retrieving-firehose-complaint)
+ [Catatan penyampaian](#event-publishing-retrieving-firehose-delivery)
+ [Catatan pengiriman](#event-publishing-retrieving-firehose-send)
+ [Tolak catatan](#event-publishing-retrieving-firehose-reject)
+ [Buka catatan](#event-publishing-retrieving-firehose-open)
+ [Klik catatan](#event-publishing-retrieving-firehose-click)
+ [Catatan Kegagalan Rendering](#event-publishing-retrieving-firehose-failure)
+ [DeliveryDelay rekor](#event-publishing-retrieving-firehose-delayed-delivery)
+ [Catatan berlangganan](#event-publishing-retrieving-firehose-subscription)
**catatan**
Dalam contoh berikut di mana `tag` bidang digunakan, ia menggunakan penerbitan acara melalui set konfigurasi yang SES mendukung penerbitan tag untuk semua jenis acara. Jika menggunakan pemberitahuan umpan balik langsung pada identitas, SES tidak mempublikasikan tag. Baca tentang menambahkan tag saat [membuat set konfigurasi](creating-configuration-sets.md) atau [memodifikasi set konfigurasi](managing-configuration-sets.md#console-detail-configuration-sets).
## Rekaman pentalan
Berikut ini adalah contoh catatan `Bounce` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## Catatan aduan
Berikut ini adalah contoh catatan `Complaint` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## Catatan penyampaian
Berikut ini adalah contoh catatan `Delivery` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## Catatan pengiriman
Berikut ini adalah contoh catatan `Send` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## Tolak catatan
Berikut ini adalah contoh catatan `Reject` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## Buka catatan
Berikut ini adalah contoh catatan `Open` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## Klik catatan
Berikut ini adalah contoh catatan `Click` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## Catatan Kegagalan Rendering
Berikut ini adalah contoh catatan `Rendering Failure` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay rekor
Berikut ini adalah contoh catatan `DeliveryDelay` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Catatan berlangganan
Berikut ini adalah contoh catatan `Subscription` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```
# Menafsirkan data peristiwa Amazon SES dari Amazon SNS
Amazon SES menerbitkan peristiwa pengiriman email ke Amazon Simple Notification Service (Amazon SNS) sebagai catatan JSON. Amazon SNS kemudian menyampaikan notifikasi ke titik akhir yang berlangganan ke topik Amazon SNS yang terkait dengan tujuan peristiwa. Untuk informasi tentang penyiapan topik dan berlangganan di Amazon SNS, lihat [Memulai](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) dalam *Panduan Developer Amazon Simple Notification Service*.
Untuk deskripsi konten catatan dan sebagai contoh catatan, lihat bagian berikut ini.
+ [Isi catatan peristiwa](event-publishing-retrieving-sns-contents.md)
+ [Contoh rekaman peristiwa](event-publishing-retrieving-sns-examples.md)
# Isi data peristiwa yang diterbitkan Amazon SES ke Amazon SNS
Amazon SES menerbitkan catatan peristiwa pengiriman email ke Amazon Simple Notification Service dalam format JSON.
Anda dapat menemukan contoh catatan untuk semua tipe notifikasi ini di [Contoh data peristiwa yang diterbitkan Amazon SES ke Amazon SNS](event-publishing-retrieving-sns-examples.md).
**Topics**
+ [Objek JSON tingkat atas](#event-publishing-retrieving-sns-contents-top-level-json-object)
+ [Objek surat](#event-publishing-retrieving-sns-contents-mail-object)
+ [Objek pentalan](#event-publishing-retrieving-sns-contents-bounce-object)
+ [Objek aduan](#event-publishing-retrieving-sns-contents-complaint-object)
+ [Objek penyampaian](#event-publishing-retrieving-sns-contents-delivery-object)
+ [Kirim objek](#event-publishing-retrieving-sns-contents-send-object)
+ [Tolak objek](#event-publishing-retrieving-sns-contents-reject-object)
+ [Buka objek](#event-publishing-retrieving-sns-contents-open-object)
+ [Klik objek](#event-publishing-retrieving-sns-contents-click-object)
+ [Objek Kegagalan Rendering](#event-publishing-retrieving-sns-contents-failure-object)
+ [DeliveryDelay objek](#event-publishing-retrieving-sns-contents-delivery-delay-object)
+ [Objek berlangganan](#event-publishing-retrieving-sns-contents-subscription-object)
## Objek JSON tingkat atas
Objek JSON tingkat-atas dalam catatan peristiwa pengiriman email berisi bidang-bidang berikut. Jenis acara menentukan objek lain mana yang hadir.
| 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
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
Objek JSON yang berisi informasi tentang peristiwa `Bounce` 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
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 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 adalah salah satu tipe yang ditunjukkan dalam 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
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
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.
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](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. |
### Subtipe aduan
Nilai bidang `complaintSubType` bisa jadi tidak ada ataupun `OnAccountSuppressionList`. Jika nilai adalah `OnAccountSuppressionList`, maka Amazon SES menerima pesan tersebut, namun tidak berusaha mengirimnya karena pesan tersebut ada dalam [daftar penahanan tingkat akun](sending-email-suppression-list.md).
## Objek penyampaian
Objek JSON yang berisi informasi tentang peristiwa `Delivery` 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
Objek JSON yang berisi informasi tentang peristiwa `send` selalu kosong.
## Tolak objek
Objek JSON yang berisi informasi tentang peristiwa `Reject` 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` memiliki 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
Objek JSON yang berisi informasi tentang peristiwa `Click` memiliki 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
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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ses/latest/dg/event-publishing-retrieving-sns-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
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 ISO8601 format *(YYYY-MM-:MM: DDThh 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
`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` |
# Contoh data peristiwa yang diterbitkan Amazon SES ke Amazon SNS
Bagian ini menyediakan contoh tipe catatan peristiwa pengiriman email yang diterbitkan Amazon SES ke Amazon SNS.
**Topics**
+ [Rekaman pentalan](#event-publishing-retrieving-sns-bounce)
+ [Catatan aduan](#event-publishing-retrieving-sns-complaint)
+ [Catatan penyampaian](#event-publishing-retrieving-sns-delivery)
+ [Catatan pengiriman](#event-publishing-retrieving-sns-send)
+ [Tolak catatan](#event-publishing-retrieving-sns-reject)
+ [Buka catatan](#event-publishing-retrieving-sns-open)
+ [Klik catatan](#event-publishing-retrieving-sns-click)
+ [Catatan Kegagalan Rendering](#event-publishing-retrieving-sns-failure)
+ [DeliveryDelay rekor](#event-publishing-retrieving-sns-delayed-delivery)
+ [Catatan berlangganan](#event-publishing-retrieving-sns-subscription)
**catatan**
Dalam contoh berikut di mana `tag` bidang digunakan, ia menggunakan penerbitan acara melalui set konfigurasi yang SES mendukung penerbitan tag untuk semua jenis acara. Jika menggunakan pemberitahuan umpan balik langsung pada identitas, SES tidak mempublikasikan tag. Baca tentang menambahkan tag saat [membuat set konfigurasi](creating-configuration-sets.md) atau [memodifikasi set konfigurasi](managing-configuration-sets.md#console-detail-configuration-sets).
## Rekaman pentalan
Berikut ini adalah contoh rekaman peristiwa `Bounce` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## Catatan aduan
Berikut ini adalah contoh rekaman peristiwa `Complaint` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## Catatan penyampaian
Berikut ini adalah contoh rekaman peristiwa `Delivery` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## Catatan pengiriman
Berikut ini adalah contoh rekaman peristiwa `Send` yang diterbitkan Amazon SES ke Amazon SNS. Beberapa bidang tidak selalu ada. Misalnya, dengan email template, subjek dirender kemudian dan disertakan dalam acara berikutnya.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## Tolak catatan
Berikut ini adalah contoh rekaman peristiwa `Reject` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## Buka catatan
Berikut ini adalah contoh rekaman peristiwa `Open` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## Klik catatan
Berikut ini adalah contoh rekaman peristiwa `Click` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## Catatan Kegagalan Rendering
Berikut ini adalah contoh rekaman peristiwa `Rendering Failure` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay rekor
Berikut ini adalah contoh rekaman peristiwa `DeliveryDelay` yang diterbitkan Amazon SES ke Amazon SNS.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Catatan berlangganan
Berikut ini adalah contoh catatan `Subscription` acara yang diterbitkan Amazon SES ke Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```