Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan pengelolaan daftar
Amazon SES menawarkan kemampuan pengelolaan daftar, yang berarti pelanggan dapat mengelola milis mereka sendiri, yang dikenal sebagai daftar kontak. *Daftar kontak* adalah daftar yang mengizinkan Anda menyimpan semua kontak yang telah berlangganan topik tertentu atau banyak topik. *Kontak* adalah pengguna akhir yang menerima email Anda. *Topik* adalah grup minat, tema, atau label dalam daftar. Daftar dapat memiliki beberapa topik.
Dengan menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)operasi di Amazon SES API v2, Anda dapat mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, kepada siapa Anda dapat mengirim email menggunakan 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)
Untuk informasi tentang pengelolaan langganan, lihat [Menggunakan manajemen berlangganan](sending-email-subscription-management.md).
## Gambaran umum manajemen daftar
Anda harus mempertimbangkan faktor-faktor berikut ketika Anda menggunakan pengelolaan daftar:
+ Anda dapat menentukan daftar topik sekaligus membuat daftar.
+ Hanya satu daftar kontak yang diizinkan per Akun AWS.
+ Daftar dapat memiliki maksimum 20 topik.
+ Anda dapat memperbarui daftar kontak yang sudah ada, termasuk menambahkan topik baru ke daftar, menambahkan atau menghapus kontak dari daftar, dan memperbarui preferensi kontak untuk daftar atau topik.
+ Anda dapat memperbarui metadata topik, seperti nama tampilan topik atau deskripsi.
+ Anda bisa mendapatkan daftar kontak di daftar kontak, kontak yang berlangganan dari topik, kontak yang berhenti berlangganan dari topik, dan kontak yang berhenti berlangganan dari semua topik di daftar.
+ Anda dapat mengimpor daftar kontak yang ada ke SES menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)API.
+ SES akan mengeluarkan peristiwa bouncing untuk pesan yang dikirim ke kontak yang berhenti berlangganan di daftar kontak Anda. Untuk informasi selengkapnya, lihat [Menggunakan manajemen berlangganan](sending-email-subscription-management.md).
+ Setiap kontak dapat memiliki atribut terkait yang dapat Anda gunakan untuk menyimpan informasi tentang kontak tersebut.
## Mengonfigurasi pengelolaan daftar
Anda dapat menggunakan operasi berikut untuk mengonfigurasi kemampuan manajemen daftar. Untuk daftar lengkap kontak dan operasi kontak, lihat [Referensi Amazon SES API v2](https://docs.aws.amazon.com/ses/latest/APIReference-V2/Welcome.html).
### Buat daftar kontak
Anda dapat menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html)operasi di SES API v2 untuk membuat daftar kontak. Anda dapat mengonfigurasi pengaturan ini dengan cepat dan mudah menggunakan AWS CLI. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
**Untuk membuat daftar kontak dengan menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
aws sesv2 create-contact-list --cli-input-json file://{{CONTACT-LIST-JSON}}
```
Pada perintah sebelumnya, ganti {{CONTACT-LIST-JSON}} dengan path ke file JSON Anda untuk permintaan Anda. [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html)
Contoh `CreateContactList` input file JSON untuk permintaan adalah sebagai berikut:
```
{
"ContactListName": "ExampleContactListName",
"Description": "Creating a contact list example",
"Topics": [
{
"TopicName": "Sports",
"DisplayName": "Sports Newsletter",
"Description": "Sign up for our free newsletter to receive updates on all sports.",
"DefaultSubscriptionStatus": "OPT_OUT"
},
{
"TopicName": "Cycling",
"DisplayName": "Cycling newsletter",
"Description": "Never miss a cycling update by subscribing to our newsletter.",
"DefaultSubscriptionStatus": "OPT_IN"
},
{
"TopicName": "NewProducts",
"DisplayName": "New products",
"Description": "Hear about new products by subscribing to this mailing list.",
"DefaultSubscriptionStatus": "OPT_IN"
},
{
"TopicName": "DailyUpdates",
"DisplayName": "Daily updates",
"Description": "Start your day with sport updates, Monday through Friday.",
"DefaultSubscriptionStatus": "OPT_OUT"
}
]
}
```
### Buat kontak
Anda dapat menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html)operasi di SES API v2 untuk membuat kontak. Anda dapat mengonfigurasi pengaturan ini dengan cepat dan mudah menggunakan AWS CLI. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
**Untuk membuat kontak dengan menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
aws sesv2 create-contact --cli-input-json file://{{CONTACT-JSON}}
```
Pada perintah sebelumnya, ganti {{CONTACT-JSON}} dengan path ke file JSON Anda untuk permintaan Anda. [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html)
Contoh `CreateContact` input file JSON untuk permintaan adalah sebagai berikut:
```
{
"ContactListName": "ExampleContactListName",
"EmailAddress": "example@amazon.com",
"UnsubscribeAll": false,
"TopicPreferences": [
{
"TopicName": "Sports",
"SubscriptionStatus": "OPT_IN"
}
],
"AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}"
}
```
Dalam contoh di atas, `UnsubscribeAll` nilai `false` menunjukkan bahwa kontak belum berhenti berlangganan dari semua topik, di mana nilai `true` berarti kontak telah berhenti berlangganan dari semua topik.
`TopicPreferences`mencakup informasi tentang status langganan kontak ke topik. Dalam contoh sebelumnya, kontak telah memilih topik "*Olahraga*" dan akan menerima semua email ke topik "*Olahraga*”.
`AttributesData`Ini adalah bidang JSON tempat Anda dapat meletakkan metadata apa pun tentang kontak kami. Ini harus menjadi objek JSON valid.
### Mengimpor kontak dalam jumlah besar ke daftar kontak Anda
Anda dapat menambahkan alamat secara massal secara manual dengan terlebih dahulu mengunggah kontak Anda ke objek Amazon S3 diikuti dengan menggunakan operasi [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)di SES API v2 atau dengan menggunakan konsol SES. Untuk mengetahui informasi selengkapnya, lihat [Menambahkan alamat email secara massal ke daftar penekanan tingkat akun Anda](sending-email-suppression-list.md#sending-email-suppression-list-manual-add-bulk).
Anda harus membuat daftar kontak sebelum mengimpor kontak Anda.
**catatan**
Anda dapat menambahkan hingga 1 juta kontak ke daftar kontak per ImportJob.
Untuk menambahkan kontak dalam jumlah besar ke daftar kontak Anda, selesaikan langkah berikut.
+ Unggah kontak Anda ke objek Amazon S3 baik dalam format CSV atau JSON.
**Format CSV**
Baris pertama dari file yang diunggah ke Amazon S3 harus menjadi baris header.
`topicPreferences`Objek perlu diratakan untuk format CSV. Setiap topik di dalamnya `topicPreferences` akan memiliki bidang header yang terpisah.
Contoh format CSV untuk menambahkan kontak dalam jumlah besar ke daftar kontak:
```
emailAddress,unsubscribeAll,attributesData,topicPreferences.Sports,topicPreferences.Cycling
example1@amazon.com,false,{"Name": "John"},OPT_IN,OPT_OUT
example2@amazon.com,true,,OPT_OUT,OPT_OUT
```
**Format JSON**
Hanya file JSON yang dibatasi baris baru yang didukung. Di format ini, setiap baris adalah objek JSON lengkap yang berisi informasi satu kontak.
Contoh format JSON untuk menambahkan kontak dalam jumlah besar ke daftar kontak:
```
{
"emailAddress": "example1@amazon.com",
"unsubscribeAll": false,
"attributesData": "{\"Name\":\"John\"}",
"topicPreferences": [
{
"topicName": "Sports",
"subscriptionStatus": "OPT_IN"
},
{
"topicName": "Cycling",
"subscriptionStatus": "OPT_OUT"
}
]
}
{
"emailAddress": "example2@amazon.com",
"unsubscribeAll": true,
"topicPreferences": [
{
"topicName": "Sports",
"subscriptionStatus": "OPT_OUT"
},
{
"topicName": "Cycling",
"subscriptionStatus": "OPT_OUT"
}
]
}
```
Dalam contoh sebelumnya, ganti {{example1@amazon.com}} dan {{example2@amazon.com}} dengan alamat email yang ingin Anda tambahkan ke daftar kontak. Ganti `attributesData` nilai dengan nilai khusus untuk kontak. Selain itu, ganti {{Sports}} dan {{Cycling}} dengan `topicName` yang berlaku untuk kontak Anda. Yang dapat diterima `topicPreferences` adalah {{OPT\_IN}} dan{{OPT\_OUT}}.
Atribut berikut didukung ketika mengunggah kontak Anda ke objek Amazon S3 baik dalam format CSV atau JSON:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/ses/latest/dg/sending-email-list-management.html)
+ Berikan izin SES untuk membaca objek Amazon S3.
Saat diterapkan ke bucket Amazon S3, kebijakan berikut memberikan izin SES untuk membaca bucket tersebut. Untuk informasi selengkapnya tentang melampirkan kebijakan ke bucket Amazon S3, [lihat Menggunakan Kebijakan Bucket dan Kebijakan Pengguna di Panduan Pengguna](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) Layanan *Penyimpanan Sederhana Amazon*.
+ Berikan izin SES untuk menggunakan AWS KMS kunci Anda.
Jika objek Amazon S3 dienkripsi dengan AWS KMS kunci, Anda harus memberikan izin Amazon SES untuk menggunakan kunci KMS. SES hanya dapat memperoleh izin dari kunci yang dikelola pelanggan, bukan kunci KMS default. Anda harus memberikan izin SES untuk menggunakan kunci yang dikelola pelanggan dengan menambahkan pernyataan ke kebijakan kunci.
Tempelkan pernyataan kebijakan berikut ke dalam kebijakan utama untuk mengizinkan SES menggunakan kunci yang dikelola pelanggan Anda.
```
{
"Sid": "AllowSESToDecrypt",
"Effect": "Allow",
"Principal": {
"Service":"ses.amazonaws.com"
},
"Action": [
"kms:Decrypt",
],
"Resource": "*"
}
```
+ Gunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operasi di SES API v2.
**catatan**
Contoh berikut mengasumsikan bahwa Anda telah menginstal file. AWS CLI Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
Di baris perintah, masukkan perintah berikut. {{s3bucket}}Ganti dengannama bucket Amazon S3 {{s3object}} dan dengan nama nama objek Amazon S3.
```
aws sesv2 create-import-job --import-destination ContactListDestination={ContactListName=ExampleContactListName,ContactListImportAction=PUT} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV
```
## Daftar panduan manajemen dengan contoh
Panduan berikut memberikan contoh bagaimana Anda dapat menggunakan manajemen daftar untuk membuat daftar kontak Anda, memanfaatkan `ListManagementOptions` untuk menentukan daftar kontak dan nama topik di email Anda, dan cara menyisipkan tautan berhenti berlangganan.
1. **Daftar kontak dengan menggunakan AWS CLI** — Anda dapat menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)operasi untuk mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, dalam hubungannya dengan [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, yang memungkinkan Anda untuk mengirim mereka email.
Di baris perintah, masukkan perintah berikut:
```
aws sesv2 list-contacts --cli-input-json file://{{LIST-CONTACTS-JSON}}
```
Pada perintah sebelumnya, ganti {{LIST-CONTACTS-JSON}} dengan path ke file JSON Anda untuk permintaan Anda. [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)
Contoh `ListContacts` input file JSON untuk permintaan adalah sebagai berikut:
```
{
"ContactListName": "ExampleContactListName",
"Filter": {
"FilteredStatus": "OPT_IN",
"TopicFilter": {
"TopicName": "Cycling",
"UseDefaultIfPreferenceUnavailable": true
}
},
"PageSize": 50
}
```
Ini `FilteredStatus` menunjukkan status langganan yang ingin Anda filter, yaitu salah satu `OPT_IN` atau`OPT_OUT`.
`TopicFilter`Ini adalah filter opsional yang menentukan topik mana yang Anda inginkan hasilnya, dan dalam contoh di atas, yaitu "*Bersepeda*.”
`UseDefaultIfPreferenceUnavailable`dapat memiliki nilai `true` atau`false`. Jika `true`, preferensi default topik akan digunakan jika kontak tidak memiliki preferensi eksplisit untuk topik. Jika `false`, hanya kontak dengan preferensi yang diatur secara eksplisit dipertimbangkan untuk pemfilteran.
1. **Kirim email dengan `ListManagementOptions` diaktifkan** - Setelah daftar kontak dalam daftar Anda menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)operasi di atas, Anda dapat menggunakan [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 untuk mengirim email ke setiap kontak Anda dengan memanfaatkan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)header untuk menentukan daftar kontak dan nama topik Anda.
Untuk digunakan `ListManagementOptions` dengan `SendEmail` operasi, sertakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)dan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)yang menjadi milik email (opsional): `topicName`
```
ListManagementOptions:
String contactListName
String topicName
```
Jika Anda memasukkan `ListManagementOptions` dalam `SendEmail` permintaan Anda ke alamat email penerima yang tidak ada dalam daftar kontak Anda, maka kontak akan dibuat di daftar Anda secara otomatis.
SES akan mengeluarkan peristiwa bouncing untuk pesan yang dikirim ke kontak yang berhenti berlangganan pada daftar kontak Anda, yang berarti Anda tidak perlu memperbarui `SendEmail` permintaan Anda untuk menghindari pengiriman ke kontak yang telah berhenti berlangganan.
1. **Tunjukkan lokasi untuk tautan berhenti berlangganan Anda** - Saat menggunakan, [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)Anda memiliki opsi untuk mengaktifkan SES untuk menambahkan tautan footer berhenti berlangganan di email Anda menggunakan `{{amazonSESUnsubscribeUrl}}` placeholder untuk menentukan di mana SES perlu memasukkan URL berhenti berlangganan. Penggantian placeholder didukung hanya untuk tipe konten HTML dan TEXT. Anda dapat menyertakan placeholder maksimum dua kali. Jika digunakan lebih dari dua kali, hanya dua kejadian pertama yang diganti. Untuk informasi selengkapnya, lihat [Menggunakan manajemen berlangganan](sending-email-subscription-management.md).
Atau, jika Anda menggunakan antarmuka SMTP untuk mengirim email, Anda dapat menggunakan `X-SES-LIST-MANAGEMENT-OPTIONS` header untuk menentukan daftar dan nama topik.
Untuk menentukan daftar dan nama topik saat mengirim email menggunakan antarmuka SMTP, tambahkan header email berikut pada pesan Anda:
`X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}`