Menggunakan pengelolaan daftar - Amazon Simple Email Service
Gambaran umum manajemen daftarMengonfigurasi pengelolaan daftarDaftar panduan manajemen dengan contoh-contoh

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 menggunakanListContactsoperasi di Amazon SES API v2, Anda dapat mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, kepada siapa Anda dapat mengirim email menggunakanSendEmailoperasi.

Anda dapat secara manual menambahkan atau menghapus alamat individu atau dalam jumlah besar dari daftar penekanan tingkat akun dengan menggunakan Amazon SES API v2 atau konsol. Untuk informasi selengkapnya, lihat:

catatan

Untuk menambah atau menghapus alamat dalam jumlah besar, Anda harus memiliki akses produksi. Untuk mempelajari selengkapnya tentang sandbox, lihat Keluar dari sandbox Amazon SES.

Untuk informasi tentang pengelolaan langganan, lihat Menggunakan manajemen berlangganan.

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 Amazon SES menggunakanCreateImportJobAPI.

  • Amazon SES akan mementalkan email jika dikirim ke kontak yang tidak berlangganan di daftar kontak Anda. Untuk informasi lebih lanjut, lihat Menggunakan manajemen berlangganan.

  • 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.

Buat daftar kontak

Anda dapat menggunakanCreateContactListoperasi di Amazon 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 Pengguna AWS Command Line Interface.

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

    Di perintah sebelumnya, gantiKONTAK-DAFTAR-JSONdengan jalur ke file JSON Anda untukCreateContactListpermintaan.

    ContohCreateContactListfile JSON masukan 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 menggunakanCreateContactoperasi di Amazon 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 Pengguna AWS Command Line Interface.

Untuk membuat kontak dengan menggunakan AWS CLI

  • Di baris perintah, masukkan perintah berikut:

    aws sesv2 create-contact --cli-input-json file://CONTACT-JSON

    Di perintah sebelumnya, gantiKONTAK-JSONdengan jalur ke file JSON Anda untukCreateContactpermintaan.

    ContohCreateContactfile JSON masukan 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,UnsubscribeAllnilaifalsemenunjukkan bahwa kontak belum berhenti berlangganan dari semua topik, di mana nilaitrueberarti kontak telah berhenti berlangganan dari semua topik.

    TopicPreferencesmencakup informasi tentang status langganan kontak ke topik. Dalam contoh sebelumnya, kontak telah memilih untuk”Olahraga“Topik dan akan menerima semua email ke”OlahragaTopik.

    ParameterAttributesDataadalah bidang JSON tempat Anda dapat menempatkan metadata apa pun tentang kontak kami. Ini harus menjadi objek JSON valid.

Mengimpor kontak dalam jumlah besar ke daftar kontak Anda

Anda dapat secara manual menambahkan alamat dalam jumlah besar dengan terlebih dahulu mengunggah kontak Anda ke objek Amazon S3 diikuti dengan menggunakanCreateImportJoboperasi di Amazon SES API v2 atau dengan menggunakan konsol SES. Untuk informasi selengkapnya, lihatMenambahkan alamat email dalam jumlah besar ke daftar penekanan tingkat akun.

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.

    ParametertopicPreferencesobjek perlu diratakan untuk format CSV. Setiap topik dalamtopicPreferencesakan memiliki bidang header 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"
      }
     ]
}

    Di contoh sebelumnya, ganti contoh1@amazon.com dan contoh2@amazon.com dengan alamat email yang ingin Anda tambahkan ke daftar kontak. GantiattributesDatadengan nilai-nilai khusus untuk kontak. Selain itu, gantiOlahragadanBersepedadengantopicNameyang berlaku untuk kontak Anda. Dapat diterimatopicPreferencesadalahOPT_INdanOPT_OUT.

    Atribut berikut didukung ketika mengunggah kontak Anda ke objek Amazon S3 baik dalam format CSV atau JSON:

    Atribut Deskripsi
    emailAddress Alamat email kontak. Ini adalah bidang wajib.
    unsubscribeAll Status nilai boolean mencatat jika kontak berhenti berlangganan dari semua topik daftar kontak.
    topicPreferences Preferensi kontak untuk memilih atau memilih keluar dari topik.
    attributesData Data atribut terlampir pada kontak.

  • Berikan Amazon SES izin untuk membaca objek Amazon S3.

    Saat diterapkan ke bucket Amazon S3, kebijakan tersebut memberikan Amazon SES izin untuk membaca ke bucket tersebut. Untuk informasi selengkapnya tentang melampirkan kebijakan ke bucket Amazon S3, lihatMenggunakan Kebijakan ember dan Kebijakan PenggunadiPanduan Pengguna Amazon Simple Storage Service.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowSESGet",
            "Effect": "Allow",
            "Principal": {
                "Service": "ses.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME",
            "Condition": {
                "StringEquals": {
                    "aws:Referer": "AWSACCOUNTID"
                }
            }
        }
    ]
}

  • Memberi Amazon SES izin untuk menggunakanAWS KMSkunci.

    Jika objek Amazon S3 dienkripsi denganAWS KMSKunci, Anda perlu memberikan Amazon SES izin untuk menggunakan kunci KMS. Amazon SES hanya mendapat izin dari kunci yang dikelola pelanggan, bukan kunci KMS default. Anda harus memberikan Amazon SES izin untuk menggunakan kunci yang dikelola pelanggan dengan menambahkan pernyataan ke kebijakan kunci.

    Tempelkan pernyataan kebijakan berikut ke kebijakan kunci untuk mengizinkan Amazon SES menggunakan kunci yang dikelola pelanggan Anda.

    {
   "Sid": "AllowSESToDecrypt", 
   "Effect": "Allow",
   "Principal": {
       "Service":"ses.amazonaws.com"
   },
   "Action": [
       "kms:Decrypt", 
   ],
   "Resource": "*"
}

  • GunakanCreateImportJoboperasi di Amazon SES API v2.

catatan

Contoh berikut mengasumsikan Anda telah menginstalAWS CLI. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat Panduan Pengguna AWS Command Line Interface.

Di baris perintah, masukkan perintah berikut. Gantis3bucketDengan nama bucket Amazon S3 danobjek s3dengan 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-contoh

Walkthrough berikut memberikan contoh bagaimana Anda dapat menggunakan manajemen daftar untuk daftar kontak Anda, memanfaatkanListManagementOptionsuntuk menentukan daftar kontak dan nama topik di email Anda, dan cara memasukkan tautan berhenti berlangganan.

  1. Kontak daftar dengan menggunakanAWS CLI- Anda dapat menggunakanListContactsoperasi untuk mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, sehubungan denganSendEmailoperasi, yang memungkinkan Anda untuk mengirim mereka email.

    Di baris perintah, masukkan perintah berikut:

    aws sesv2 list-contacts --cli-input-json file://LIST-CONTACTS-JSON

    Di perintah sebelumnya, gantiDAFTAR-KONTAK-JSONdengan jalur ke file JSON Anda untukListContactspermintaan.

    ContohListContactsfile JSON masukan untuk permintaan adalah sebagai berikut:

    {
    "ContactListName": "ExampleContactListName",
    "Filter": {
        "FilteredStatus": "OPT_IN",
        "TopicFilter": {
            "TopicName": "Cycling",
            "UseDefaultIfPreferenceUnavailable": true
        }
    },
    "PageSize": 50
}

    ParameterFilteredStatusmenampilkan status langganan yang ingin Anda filter, yang manaOPT_INatauOPT_OUT.

    ParameterTopicFilteradalah filter opsional yang menentukan topik mana yang Anda inginkan hasilnya, dan dalam contoh di atas, yaitu”Bersepeda.”

    UseDefaultIfPreferenceUnavailabledapat memiliki nilaitrueataufalse. 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.

  2. Kirim surat denganListManagementOptionsmemungkinkan— Setelah daftar kontak dalam daftar Anda menggunakan di atasListContactsoperasi, Anda dapat menggunakanSendEmailoperasi untuk mengirim email ke masing-masing kontak Anda dengan memanfaatkanListManagementOptionsheader untuk menentukan daftar kontak Anda dan nama topik.

    Untuk menggunakanListManagementOptionsdenganSendEmailoperasi, termasukcontactListNamedantopicNameyang email milik (topicNameopsional):

    
ListManagementOptions:
    String contactListName
    String topicName

    Jika Anda menyertakanListManagementOptionsdiSendEmailrequest ke alamat email penerima yang tidak ada di daftar kontak Anda, maka kontak akan dibuat di daftar Anda secara otomatis.

    Amazon SES akan mementalkan email jika dikirim ke kontak yang tidak berlangganan di daftar kontak Anda, yang berarti Anda tidak perlu memperbaruiSendEmailpermintaan untuk menghindari pengiriman ke kontak yang telah berhenti berlangganan.

  3. Tunjukkan lokasi untuk tautan berhenti berlangganan— Saat memanfaatkanListManagementOptionsAnda memiliki opsi untuk mengaktifkan Amazon SES menambahkan tautan footer berhenti berlangganan di email Anda menggunakan{{amazonSESUnsubscribeUrl}}placeholder untuk menentukan tempat 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.

    Atau, jika Anda menggunakan antarmuka SMTP untuk mengirim email, Anda dapat menggunakanX-SES-LIST-MANAGEMENT-OPTIONSheader 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}