Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memantau aktivitas pengiriman Amazon SES
Amazon SES menyediakan metode untuk memantau aktivitas pengiriman Anda menggunakan peristiwa, metrik, dan statistik. Peristiwa adalah sesuatu yang terjadi terkait dengan aktivitas pengiriman yang telah ditentukan untuk dilacak sebagai metrik. Metrik mewakili kumpulan titik data yang diurutkan waktu yang mewakili nilai dari jenis peristiwa yang dipantau yang menghasilkan statistik. Statistik adalah agregasi data metrik untuk jangka waktu tertentu termasuk hingga saat ini.
Metode pemantauan ini membantu Anda melacak langkah-langkah penting, seperti tingkat pentalan, keluhan, dan penolakan akun Anda. Tingkat pentalan dan keluhan yang terlalu tinggi dapat membahayakan kemampuan Anda untuk mengirim email menggunakan SES. Metode ini juga dapat digunakan untuk mengukur tingkat di mana pelanggan Anda terlibat dengan email yang Anda kirim dengan membantu Anda mengidentifikasi tarif terbuka dan klik secara keseluruhan menggunakan penerbitan acara dan domain khusus yang terkait dengan set konfigurasi - lihat. [Mengonfigurasi domain kustom untuk menangani pelacakan buka dan klik](configure-custom-open-click-domains.md)
Langkah pertama dalam menyiapkan pemantauan adalah mengidentifikasi jenis peristiwa email yang terkait dengan aktivitas pengiriman Anda yang ingin Anda ukur dan pantau menggunakan SES. Anda dapat memilih jenis acara berikut untuk dipantau di SES:
+ **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.
Anda dapat memantau peristiwa pengiriman email dengan beberapa cara. Metode yang Anda pilih tergantung pada jenis acara yang ingin Anda pantau, perincian dan tingkat detail yang ingin Anda pantau, dan lokasi di mana Anda ingin SES mempublikasikan data. Anda harus menggunakan notifikasi umpan balik atau penerbitan peristiwa untuk melacak peristiwa pentalan dan aduan. Anda juga dapat memilih untuk menggunakan beberapa metode pemantauan. Karakteristik masing-masing metode tercantum dalam tabel berikut.
| Metode Pemantauan | Peristiwa yang Dapat Anda Pantau | Cara Mengakses Data | Tingkat Detail | Granularitas |
| --- | --- | --- | --- | --- |
| Konsol SES | Kesehatan akun, email yang dikirim, kuota yang digunakan, permintaan kirim yang berhasil, penolakan, pantulan & keluhan *(riwayat terbaru* dengan reputasi saat ini) | [Halaman dasbor akun](monitor-sending-activity-console.md) di konsol SES | Jumlah dan persentase | Di seluruh AWS akun |
| Konsol SES | Kesehatan akun, email yang dikirim, pantulan & keluhan *(reputasi saat ini)* | [Halaman metrik reputasi](reputation-dashboard-dg.md) di konsol SES | Hanya tingkat yang dihitung | Di seluruh AWS akun |
| Manajer Pengiriman Virtual | Statistik akun, ISP, identitas pengiriman, set konfigurasi, dikirim, dikirim, keluhan, pantulan sementara & permanen, buka & klik, kemampuan pengiriman, dan reputasi. | [Dasbor Manajer Pengiriman Virtual](vdm-dashboard.md)di konsol SES [Penasihat Manajer Pengiriman Virtual](vdm-advisor.md)di konsol SES | Jumlah dan persentase | Di seluruh AWS akun |
| SES API | Penyampaian, pentalan, aduan, dan penolakan | Operasi API [https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html) | Hanya jumlah | Di seluruh AWS akun |
| CloudWatch Konsol Amazon | Mengirim, mengirimkan, membuka, mengklik, memantul, rasio pentalan, keluhan, tingkat keluhan, penolakan, kegagalan rendering, dan daftar hitam. IPs | CloudWatch konsol Beberapa metrik tidak muncul CloudWatch sampai peristiwa terkait terjadi. [Misalnya, metrik bouncing tidak muncul CloudWatch hingga setidaknya satu email yang Anda kirim memantul, atau hingga Anda menghasilkan peristiwa pantulan simulasi dengan menggunakan simulator kotak pesan.](send-an-email-from-console.md) | Hanya jumlah | Di seluruh AWS akun |
| Notifikasi umpan balik | Penyampaian, pentalan, dan aduan | Notifikasi Amazon SNS (pengiriman, pentalan, dan keluhan) atau email (hanya pantulan dan keluhan). Lihat [Menyiapkan notifikasi peristiwa](monitor-sending-activity-using-notifications.md). | Detail tentang setiap peristiwa | Di seluruh AWS akun |
| Penerbitan peristiwa | Pengiriman, penyampaian, pembukaan, pengeklikan, pentalan, aduan, penolakan, dan kegagalan rendering. | Amazon CloudWatch atau Amazon Data Firehose, atau pemberitahuan Amazon SNS—lihat. [Pantau pengiriman email menggunakan penerbitan acara](monitor-using-event-publishing.md) *(Biaya tambahan berlaku, lihat [Harga per metrik untuk CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Detail tentang setiap peristiwa | Detail (berdasarkan karakteristik email yang dapat ditentukan pengguna) |
| [Penerbitan acara menggunakan domain khusus yang terkait dengan set konfigurasi - info lebih lanjut](configure-custom-open-click-domains.md) | Buka dan klik pelacakan. | Amazon CloudWatch atau Amazon Data Firehose, atau dengan pemberitahuan Amazon SNS. *(Biaya tambahan berlaku, lihat [Harga per metrik untuk CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Detail pada setiap acara. | Detail (berdasarkan karakteristik email yang dapat ditentukan pengguna) |
**catatan**
Metrik yang diukur dengan peristiwa pengiriman email mungkin tidak selaras dengan kuota pengiriman Anda. Perbedaan ini dapat disebabkan oleh pantulan dan penolakan email, atau dengan menggunakan simulator kotak masuk SES. Untuk mengetahui seberapa dekat kuota pengiriman Anda, lihat [Pemantauan kuota pengiriman Anda](manage-sending-quotas-monitor.md).
**Topics**
+ [Pemantauan statistik pengiriman Anda menggunakan konsol Amazon SES](monitor-sending-activity-console.md)
+ [Memantau statistik penggunaan Anda menggunakan API Amazon SES](monitor-sending-activity-api.md)
+ [Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES](monitor-using-event-publishing.md)
# Pemantauan statistik pengiriman Anda menggunakan konsol Amazon SES
Dari **dasbor Akun**, **metrik Reputasi**, dan halaman **pengaturan SMTP** konsol Amazon SES, Anda dapat memantau semua metrik pengiriman email, penggunaan, statistik, pengaturan SMTP, kesehatan akun secara keseluruhan, dan metrik reputasi. Bagian berikut menjelaskan metrik dan statistik yang disediakan di masing-masing halaman konsol ini.
Perlu dicatat bahwa meskipun halaman [Metrik reputasi](#reputation-metrics) konsol [Dasbor akun](#account-dashboard) dan halaman berisi metrik bouncing dan keluhan, ada perbedaan halus antara dua set tingkat bouncing dan keluhan ini seperti yang dijelaskan di bawah ini:
+ **Halaman dasbor akun** — berdasarkan rentang tanggal yang dipilih, Anda dapat melihat tingkat pentalan dan keluhan di masa lalu yang menunjukkan perkembangan metrik perubahan menjelang saat ini.
+ **Halaman metrik reputasi** — tingkat pentalan dan keluhan berdasarkan titik data terbaru yang diterima dari penghitungan rata-rata historis Anda secara keseluruhan pada tingkat tinggi (ini tidak boleh disamakan dengan bounce/complaint tarif reguler Anda, yang sesuai dengan bounce/complaint peristiwa yang tepat seperti yang terjadi secara real-time seperti yang ditunjukkan pada halaman **dasbor Akun**).
Sebagai contoh sederhana untuk membandingkan tingkat bouncing atau keluhan antara halaman **metrik Reputasi** dan halaman **dasbor Akun**, katakanlah tarifnya 2% kemarin dan 1% sekarang, di halaman **metrik Reputasi**, Anda hanya akan melihat tingkat saat ini 1%, tetapi pada halaman **dasbor Akun**, grafik akan memplot perkembangan yang dipetakan yang menunjukkan tingkat 2% untuk kemarin dan 1% untuk hari ini.
## Dasbor akun
Anda dapat memantau jumlah email yang dikirim dari akun Anda, serta persentase kuota pengiriman yang telah digunakan, langsung dari halaman **dasbor Akun** konsol SES di panel *penggunaan email harian*. Tarif pengiriman dan penolakan untuk akun Anda dapat dipantau di panel *Statistik Pengiriman*, serta faktor kunci lainnya yang terkait dengan pengiriman email Anda di panel berikut:
+ **Batas pengiriman** - berisi kuota berikut yang berlaku untuk mengirim email melalui SES:
+ *Kuota pengiriman harian* - jumlah email maksimum yang dapat Anda kirim dalam jangka waktu 24 jam.
+ *Rasio pengiriman maksimum* - jumlah maksimum email yang dapat dikirim dari akun Anda setiap detik.
+ **Kesehatan akun** - status akun SES Anda:
+ `Healthy`- tidak ada masalah terkait reputasi yang saat ini memengaruhi akun Anda.
+ `Under review`- potensi masalah telah diidentifikasi dengan akun SES Anda - akun Anda sedang ditinjau saat Anda bekerja untuk memperbaiki masalah.
+ `Paused`- Kemampuan akun Anda untuk mengirim email saat ini dijeda karena masalah dengan email yang dikirim dari akun Anda. Ketika masalah telah diperbaiki, Anda dapat meminta agar kemampuan akun Anda untuk mengirim email dilanjutkan.
+ **Penggunaan email harian** — untuk memeriksa penggunaan harian Anda untuk memastikan Anda tidak mendekati batas pengiriman Anda:
+ *Email yang dikirim* - jumlah total email yang dikirim dalam periode 24 jam.
+ *Sisa kirim* - jumlah total email yang tersisa yang tersedia untuk dikirim dalam periode 24 jam.
+ *Kuota pengiriman yang digunakan* - persentase kuota pengiriman harian Anda yang digunakan.
+ **Statistik pengiriman** *— terdiri dari grafik yang menunjukkan perkembangan empat metrik penting dalam kumpulan titik data yang diurutkan waktu yang mewakili nilai jenis peristiwa yang dipantau yang menghasilkan statistik untuk rentang tanggal yang dipilih menggunakan periode agregasi 1 jam.* Anda dapat memilih rentang data dengan nilai awal dari `Last 1 day` hingga `Last 14 days` untuk memfilter bagan di bawah ini:
+ *Mengirim* - jumlah permintaan pengiriman email yang berhasil untuk rentang tanggal yang dipilih.
+ *Menolak* - tingkat rata-rata permintaan kirim yang ditolak oleh SES berdasarkan `Rejects/Sends * 100` rentang tanggal yang dipilih.
+ *Bounces* - tingkat rata-rata yang berasal dari metrik reputasi pengirim historis Anda secara keseluruhan yang menunjukkan perkembangan untuk rentang tanggal yang dipilih.
+ *Keluhan* - tingkat rata-rata yang berasal dari metrik reputasi pengirim historis Anda secara keseluruhan yang menunjukkan perkembangan untuk rentang tanggal yang dipilih.
Masing-masing bagan ini berisi CloudWatch tombol **Lihat di** yang akan membuka metrik masing-masing di CloudWatch konsol Amazon yang memungkinkan data terperinci untuk dilihat, matematika metrik yang disesuaikan dilakukan, dan [pembuatan alarm masuk CloudWatch](reputationdashboard-cloudwatch-alarm.md).
## Metrik reputasi
Selain tingkat pentalan dan keluhan, halaman **metrik Reputasi** juga menyediakan visibilitas tingkat tinggi lainnya ke dalam faktor-faktor kunci yang memengaruhi reputasi Anda yang terdiri dari panel berikut:
+ **Ringkasan** — memberikan gambaran umum tentang kesehatan reputasi Anda.
+ *Status* - kesehatan reputasi secara keseluruhan berdasarkan tingkat pentalan dan keluhan historis:
+ `Healthy`- kedua metrik berada dalam level normal.
+ `Under review`- satu atau kedua metrik secara otomatis menyebabkan akun Anda ditempatkan dalam peninjauan.
+ `At risk`- satu atau kedua metrik telah mencapai tingkat yang tidak sehat dan kemampuan akun Anda untuk mengirim email mungkin berisiko.
+ *Email yang dikirim (24 jam terakhir)* — jumlah total email yang dikirim dalam periode 24 jam terakhir.
+ *Sisa kirim* — jumlah total email yang tersisa yang tersedia untuk dikirim dalam periode 24 jam.
+ *Kuota pengiriman yang digunakan* — persentase kuota pengiriman harian Anda yang digunakan.
+ **Isi tab tingkat akun:**
+ Tingkat pentalan
+ *Status* - menunjukkan kesehatan rasio pentalan Anda menggunakan nilai yang sama seperti yang dijelaskan untuk panel Ringkasan.
+ Rasio *pentalan historis - persentase* email dari akun Anda yang menghasilkan pantulan keras yang dihitung dari rata-rata historis Anda secara keseluruhan berdasarkan volume representatif yang mewakili praktik pengiriman khas Anda.
+ Tingkat keluhan
+ *Status* - Menunjukkan kesehatan tingkat keluhan Anda menggunakan nilai yang sama seperti yang dijelaskan untuk panel Ringkasan.
+ Rasio *pentalan historis - persentase* email yang dikirim dari akun Anda yang mengakibatkan penerima melaporkannya sebagai spam yang dihitung dari rata-rata historis Anda secara keseluruhan berdasarkan volume representatif yang mewakili praktik pengiriman khas Anda.
+ **Konfigurasi mengatur isi tab:**
+ Reputasi berdasarkan set konfigurasi
+ *Set konfigurasi* - memungkinkan Anda mengetik atau memilih set konfigurasi yang memiliki metrik reputasi diaktifkan sehingga Anda dapat melihat ringkasan, bouncing, dan data keluhan berdasarkan email yang dikirim menggunakan set konfigurasi yang dipilih. Panel yang dihasilkan yang muncul setelah memilih set konfigurasi sama seperti yang dijelaskan di atas untuk halaman metrik Reputasi kecuali hanya didasarkan pada email yang dikirim dengan konfigurasi yang dipilih ditetapkan sesuai dengan metrik pengiriman tingkat akun Anda secara keseluruhan.
## Pengaturan SMTP
Halaman ini mencantumkan pengaturan SMTP yang diperlukan untuk menggunakan antarmuka SMTP Amazon SES baik melalui SES API atau secara terprogram, dan menyediakan tautan untuk membuat dan mengelola kredensyal SMTP Anda:
+ **Pengaturan SMTP** - jika Anda ingin menggunakan bahasa pemrograman berkemampuan SMTP, server email, atau aplikasi untuk terhubung ke antarmuka SMTP Amazon SES, informasi berikut disediakan:
+ Titik akhir SMTP
+ Pelabuhan STARTTLS
+ Keamanan Lapisan Pengangkutan (TLS)
+ Port Pembungkus TLS
+ Tautan otentikasi disediakan untuk pembuatan dan manajemen kredensi SMTP dan IAM
## Menggunakan konsol untuk memantau metrik pengiriman dan reputasi
Prosedur berikut akan membantu Anda memulai menjelajahi metrik kirim dan reputasi Anda baik menggunakan halaman **dasbor Akun** untuk metrik berdasarkan riwayat terbaru (hingga 14 hari), atau menggunakan halaman metrik **Reputasi untuk metrik** berdasarkan riwayat keseluruhan Anda hingga saat ini.
**Untuk melihat email yang dikirim dan kuota pengiriman yang digunakan**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon SES di [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Di panel navigasi, pilih **Dasbor akun**. Statistik penggunaan Anda ditampilkan di bagian **Penggunaan email harian**.
**Untuk melihat jumlah pengiriman, tingkat penolakan, pantulan, dan keluhan**
1. Di panel navigasi, pilih **Dasbor akun**.
1. Di bagian **Mengirim statistik**, gunakan dropdown **rentang tanggal** untuk memilih nilai awal untuk rentang tanggal untuk memfilter empat grafik langsung di bawah bagian **Mengirim statistik**.
1. Berdasarkan rentang tanggal yang dipilih, Anda dapat melihat jumlah dan tarif di masa lalu yang menunjukkan perkembangan metrik perubahan yang mengarah ke waktu sekarang.
1. Di salah satu bagan, pilih CloudWatch tombol **Lihat di** untuk membuka metrik masing-masing di CloudWatch konsol **Amazon** tempat Anda dapat melihat data terperinci, melakukan matematika metrik yang disesuaikan, dan [membuat alarm pemantauan](reputationdashboard-cloudwatch-alarm.md). CloudWatch
**Untuk melihat tingkat pentalan dan keluhan historis secara keseluruhan**
1. Di panel navigasi, pilih **Metrik reputasi**.
1. Di panel **Rasio pentalan**, Anda dapat melihat persentase email yang dikirim dari akun Anda yang menghasilkan pantulan keras, dan di panel **Tingkat keluhan**, Anda dapat melihat persentase email yang dikirim dari akun Anda yang mengakibatkan penerima melaporkannya sebagai spam; kedua metrik dihitung dari volume email yang representatif berdasarkan praktik pengiriman biasa Anda.
1. Di salah satu panel, pilih CloudWatch tombol **Lihat di** untuk membuka metrik masing-masing di CloudWatch konsol **Amazon** tempat Anda dapat melihat data terperinci, melakukan matematika metrik yang disesuaikan, dan [membuat alarm pemantauan](reputationdashboard-cloudwatch-alarm.md). CloudWatch
**Untuk melihat metrik reputasi berdasarkan set konfigurasi**
1. Di panel navigasi, pilih **Metrik reputasi**.
1. Pada halaman metrik Reputasi, pilih tab **Set konfigurasi**.
1. Di panel **set Reputasi berdasarkan konfigurasi**, klik di dalam bidang **set Konfigurasi** dan mulai mengetik untuk, atau pilih, set konfigurasi yang mengaktifkan metrik reputasi.
1. Setelah memilih set konfigurasi, itu akan memuat panel Ringkasan, Pantulan, dan Keluhan yang menampilkan metrik hanya berdasarkan email yang dikirim dengan set konfigurasi yang dipilih.
# Memantau statistik penggunaan Anda menggunakan API Amazon SES
API Amazon SES menyediakan operasi `GetSendStatistics`, yang mengembalikan informasi tentang penggunaan layanan Anda. Kami merekomendasikan Anda untuk memeriksa statistik pengiriman secara teratur, sehingga Anda dapat melakukan penyesuaian jika diperlukan.
Ketika Anda memanggil operasi `GetSendStatistics`, Anda menerima daftar titik data yang mewakili aktivitas pengiriman Anda selama dua minggu terakhir. Setiap titik data dalam daftar ini mewakili 15 menit aktivitas dan berisi informasi berikut untuk periode tersebut:
+ Jumlah pentalan keras
+ Jumlah aduan
+ Jumlah percobaan pengiriman (sesuai dengan jumlah email yang telah Anda kirim)
+ Jumlah percobaan pengiriman yang ditolak
+ Stempel waktu untuk periode analisis
Untuk deskripsi lengkap tentang operasi `GetSendStatistics`, lihat [Referensi API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).
Pada bagian ini, Anda akan menemukan topik berikut:
+ [Memanggil operasi `GetSendStatistics` API menggunakan AWS CLI](#monitor-sending-activity-api-cli)
+ [Memanggil pemrograman operasi `GetSendStatistics`](#monitor-sending-activity-api-sdk)
## Memanggil operasi `GetSendStatistics` API menggunakan AWS CLI
Cara termudah untuk memanggil operasi API `GetSendStatistics` adalah dengan menggunakan [AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).
**Untuk memanggil operasi `GetSendStatistics` API menggunakan AWS CLI**
1. Jika Anda belum melakukannya, instal AWS CLI. Untuk informasi lebih lanjut, lihat "[Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)" di *Panduan AWS Command Line Interface Pengguna*.
1. Jika Anda belum melakukannya, konfigurasikan AWS CLI untuk menggunakan AWS kredensional Anda. Untuk informasi selengkapnya, lihat "[Mengkonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)" di *Panduan AWS Command Line Interface Pengguna*.
1. Pada baris perintah, jalankan perintah berikut:
```
aws ses get-send-statistics
```
Jika AWS CLI dikonfigurasi dengan benar, Anda melihat daftar statistik pengiriman dalam format JSON. Setiap objek JSON termasuk statistik pengiriman yang digabungkan untuk jangka waktu 15 menit.
## Memanggil pemrograman operasi `GetSendStatistics`
Anda juga dapat memanggil `GetSendStatistics` operasi menggunakan AWS SDKs. Bagian ini mencakup contoh kode AWS SDKs untuk Go, PHP, Python, dan Ruby. Pilih salah satu tautan berikut untuk melihat contoh kode untuk bahasa tersebut:
+ [Contoh kode untuk AWS SDK untuk Go](#code-example-getsendstatistics-golang)
+ [Contoh kode untuk AWS SDK untuk PHP](#code-example-getsendstatistics-php)
+ [Contoh kode untuk AWS SDK for Python (Boto)](#code-example-getsendstatistics-python)
+ [Contoh kode untuk AWS SDK untuk Ruby](#code-example-getsendstatistics-ruby)
**catatan**
Contoh kode ini mengasumsikan bahwa Anda telah membuat file kredensial AWS bersama yang berisi ID kunci AWS akses, kunci akses AWS rahasia, dan Wilayah pilihan AWS Anda. Untuk informasi lebih lanjut, lihat [File kredensial dan konfigurasi berbagi](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).
### Memanggil `GetSendStatistics` menggunakan AWS SDK untuk Go
```
1. package main
2.
3. import (
4. "fmt"
5.
6. //go get github.com/aws/aws-sdk-go/...
7. "github.com/aws/aws-sdk-go/aws"
8. "github.com/aws/aws-sdk-go/aws/session"
9. "github.com/aws/aws-sdk-go/service/ses"
10. "github.com/aws/aws-sdk-go/aws/awserr"
11. )
12.
13. const (
14. // Replace us-west-2 with the AWS Region you're using for Amazon SES.
15. AwsRegion = "us-west-2"
16. )
17.
18. func main() {
19.
20. // Create a new session and specify an AWS Region.
21. sess, err := session.NewSession(&aws.Config{
22. Region:aws.String(AwsRegion)},
23. )
24.
25. // Create an SES client in the session.
26. svc := ses.New(sess)
27. input := &ses.GetSendStatisticsInput{}
28.
29. result, err := svc.GetSendStatistics(input)
30.
31. // Display error messages if they occur.
32. if err != nil {
33. if aerr, ok := err.(awserr.Error); ok {
34. switch aerr.Code() {
35. default:
36. fmt.Println(aerr.Error())
37. }
38. } else {
39. // Print the error, cast err to awserr.Error to get the Code and
40. // Message from an error.
41. fmt.Println(err.Error())
42. }
43. return
44. }
45.
46. fmt.Println(result)
47. }
```
### Memanggil `GetSendStatistics` menggunakan AWS SDK untuk PHP
```
1. 'latest',
16. 'region' => REGION
17. ));
18.
19. try {
20. $result = $client->getSendStatistics([]);
21. echo($result);
22. } catch (Exception $e) {
23. echo($e->getMessage()."\n");
24. }
25.
26. ?>
```
### Memanggil `GetSendStatistics` menggunakan AWS SDK for Python (Boto)
```
1. import boto3 #pip install boto3
2. import json
3. from botocore.exceptions import ClientError
4.
5. client = boto3.client('ses')
6.
7. try:
8. response = client.get_send_statistics(
9. )
10. except ClientError as e:
11. print(e.response['Error']['Message'])
12. else:
13. print(json.dumps(response, indent=4, sort_keys=True, default=str))
```
### Memanggil `GetSendStatistics` menggunakan AWS SDK untuk Ruby
```
1. require 'aws-sdk' # gem install aws-sdk
2. require 'json'
3.
4. # Replace us-west-2 with the AWS Region you're using for Amazon SES.
5. awsregion = "us-west-2"
6.
7. # Create a new SES resource and specify a region
8. ses = Aws::SES::Client.new(region: awsregion)
9.
10. begin
11.
12. resp = ses.get_send_statistics({
13. })
14. puts JSON.pretty_generate(resp.to_h)
15.
16. # If something goes wrong, display an error message.
17. rescue Aws::SES::Errors::ServiceError => error
18. puts error
19.
20. end
```
# 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. }
```