Menyiapkan domain untuk menangani pengalihan tautan buka dan klik Menentukan domain dan kebijakan pengalihan kustom Anda HTTPS Menentukan jenis acara terbuka dan klik

Mengonfigurasi domain kustom untuk menangani pelacakan buka dan klik

Saat Anda menggunakan penerbitan acara untuk menangkap peristiwa terbuka dan klik, Amazon SES membuat perubahan kecil pada email yang Anda kirim. Untuk menangkap peristiwa terbuka, SES tambahkan GIF gambar transparan 1 piksel kali 1 piksel di setiap email yang dikirim SES yang menyertakan nama file unik untuk setiap email, dan di-host di server yang dioperasikan olehSES; ketika gambar diunduh, SES dapat mengetahui dengan tepat pesan mana yang dibuka dan oleh siapa.

Secara default, piksel ini disisipkan di bagian bawah email; namun, beberapa aplikasi penyedia email memotong pratinjau email ketika melebihi ukuran tertentu dan dapat memberikan tautan untuk melihat sisa pesan. Dalam skenario ini, gambar pelacakan SES piksel tidak dimuat dan akan membuang tarif terbuka yang Anda coba lacak. Untuk menyiasatinya, Anda dapat secara opsional menempatkan piksel di awal email, atau di mana pun, dengan memasukkan {{ses:openTracker}} placeholder ke dalam badan email. Setelah SES menerima pesan dengan placeholder, itu akan diganti dengan gambar piksel pelacakan terbuka.

penting

Setiap {{ses:openTracker}} placeholder lebih dari satu akan dihapus saat dikirim oleh. SES
Hanya tambahkan satu {{ses:openTracker}} placeholder jika Anda menggunakannya dalam template email, karena lebih dari satu akan menghasilkan kode 400 BadRequestException kesalahan dikembalikan.

Untuk menangkap peristiwa klik tautan, SES ganti tautan di email Anda dengan tautan ke server yang dioperasikan olehSES. Tindakn ini segera mengalihkan penerima ke tujuan yang dimaksudkan. Ukuran total header, termasuk cookie, permintaan yang dibuat ke server ini tidak boleh melebihi 8192 byte, jika tidak kode 400 BadRequestException kesalahan dikembalikan.

Anda juga memiliki opsi untuk menggunakan domain Anda sendiri, bukan domain yang dimiliki dan dioperasikan olehSES, untuk menciptakan pengalaman yang lebih kohesif bagi penerima Anda, yang berarti semua indikator dihapus. SES Anda dapat mengonfigurasi beberapa domain kustom untuk menangani peristiwa pelacakan buka dan klik. Domain kustom ini terkait dengan set konfigurasi. Ketika Anda mengirim email menggunakan set konfigurasi, jika set konfigurasi tersebut dikonfigurasi untuk menggunakan domain kustom, maka tautan buka dan klik di email tersebut secara otomatis menggunakan domain kustom yang ditentukan di set konfigurasi.

Bagian ini berisi prosedur untuk menyiapkan subdomain di server yang Anda miliki untuk secara otomatis mengarahkan pengguna ke server pelacakan terbuka dan klik yang dioperasikan oleh. SES Ada tiga langkah yang terlibat dalam pengaturan domain ini. Pertama, Anda mengonfigurasi subdomain itu sendiri, lalu mengatur konfigurasi yang ditetapkan untuk menggunakan domain kustom, dan kemudian mengatur tujuan acara untuk mempublikasikan peristiwa terbuka dan klik. Topik ini berisi prosedur untuk menyelesaikan semua langkah ini.

Namun, jika Anda hanya ingin mengaktifkan pelacakan terbuka atau klik tanpa menyiapkan domain khusus, Anda dapat melanjutkan langsung ke menentukan tujuan acara untuk set konfigurasi Anda yang memungkinkan penerbitan acara yang dipicu pada jenis acara yang Anda tentukan, termasuk acara buka dan klik. Set konfigurasi dapat memiliki beberapa tujuan acara dengan beberapa jenis acara yang ditentukan. Lihat Membuat tujuan SES acara Amazon.

Bagian 1: Menyiapkan domain untuk menangani pengalihan tautan buka dan klik

Prosedur khusus untuk menyiapkan domain pengalihan bervariasi tergantung pada penyedia hosting web Anda (dan Jaringan Pengiriman Konten Anda, jika Anda menggunakan HTTPS server). Prosedur di bagian berikut menyediakan panduan umum bukannya langkah-langkah tertentu.

Opsi 1: Mengkonfigurasi domain HTTP

Jika Anda berencana untuk menggunakan HTTP domain untuk menangani tautan terbuka dan klik (sebagai lawan dari HTTPS domain), proses untuk mengonfigurasi subdomain hanya melibatkan beberapa langkah.

catatan

Jika Anda menyiapkan domain khusus yang menggunakan HTTP protokol, dan Anda mengirim email yang berisi tautan yang menggunakan HTTPS protokol, pelanggan Anda mungkin akan melihat pesan peringatan ketika mereka mengklik tautan di email Anda. Jika Anda berencana untuk mengirim email yang berisi tautan yang menggunakan HTTPS protokol, Anda harus menggunakan HTTPS domain untuk menangani peristiwa pelacakan klik.

Untuk menyiapkan HTTP subdomain untuk menangani tautan terbuka dan klik

Buat subdomain yang akan digunakan untuk membuka dan mengklik tautan pelacakan. SESmerekomendasikan bahwa subdomain ini secara khusus didedikasikan untuk menangani tautan ini, dan subdomain dibuat untuk setiap Wilayah AWS Anda mengirim email yang ingin Anda lacak.
Verifikasi subdomain untuk digunakan denganSES. Untuk informasi selengkapnya, lihat Membuat identitas domain.

Tambahkan CNAME catatan baru ke DNS pengaturan subdomain Anda yang mengalihkan permintaan ke domain pelacakan. SES Alamat yang Anda alihkan harus sama Wilayah AWS dengan subdomain kustom Anda.

Tabel berikut berisi daftar domain pelacakan Wilayah AWS tempat SES tersedia—pilih domain yang berada di wilayah yang sama dengan domain kustom Anda:

AWS Wilayah	AWS domain pelacakan
AS Timur (Ohio)	`r.us-east-2.awstrack.me`
AS Timur (Virginia Utara)	`r.us-east-1.awstrack.me`
AS Barat (California Utara)	`r.us-west-1.awstrack.me`
AS Barat (Oregon)	`r.us-west-2.awstrack.me`
Afrika (Cape Town)	`r.af-south-1.awstrack.me`
Asia Pasifik (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asia Pasifik (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pasifik (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pasifik (Seoul)	`r.ap-northeast-2.awstrack.me`
Asia Pasifik (Singapura)	`r.ap-southeast-1.awstrack.me`
Asia Pasifik (Sydney)	`r.ap-southeast-2.awstrack.me`
Asia Pasifik (Jakarta)	r.ap-tenggara 3.awstrack.me
Asia Pasifik (Jakarta)	r.ap-tenggara 3.awstrack.me
Asia Pasifik (Tokyo)	`r.ap-northeast-1.awstrack.me`
Kanada (Pusat)	`r.ca-central-1.awstrack.me`
Eropa (Frankfurt)	`r.eu-central-1.awstrack.me`
Eropa (Irlandia)	`r.eu-west-1.awstrack.me`
Eropa (London)	`r.eu-west-2.awstrack.me`
Eropa (Milan)	`r.eu-south-1.awstrack.me`
Eropa (Stockholm)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Timur Tengah (Bahrain)	`r.me-south-1.awstrack.me`
Amerika Selatan (Sao Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (AS-Barat)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (AS-Timur)	`r.us-gov-east-1.awstrack.me`

catatan

Bergantung pada penyedia hosting web Anda, mungkin diperlukan beberapa menit agar perubahan yang Anda buat pada DNS catatan subdomain berlaku. Penyedia hosting web atau organisasi IT Anda dapat memberikan informasi tambahan tentang penundaan ini.

Opsi 2: Mengkonfigurasi domain HTTPS

Anda juga dapat menggunakan HTTPS domain untuk melacak klik terbuka dan tautan. Untuk menyiapkan HTTPS domain untuk melacak klik terbuka dan tautan, Anda harus melakukan beberapa langkah tambahan, di luar yang diperlukan untuk menyiapkan HTTP domain.

Untuk menyiapkan HTTPS subdomain untuk menangani tautan terbuka dan klik

Buat subdomain yang akan digunakan untuk membuka dan mengklik tautan pelacakan. SESmerekomendasikan bahwa subdomain ini secara khusus didedikasikan untuk menangani tautan ini, dan subdomain dibuat untuk setiap Wilayah AWS Anda mengirim email yang ingin Anda lacak.
Verifikasi subdomain untuk digunakan denganSES. Untuk informasi selengkapnya, lihat Membuat identitas domain.
Membuat akun baru dengan Jaringan Pengiriman Konten (CDN), seperti Amazon CloudFront, lihat Memulai CloudFront distribusi dasar.

Konfigurasikan CDN ke asal yang merupakan domain SES pelacakan, seperti r.us-east-1.awstrack.me misalnya. CDNHarus menunjuk ke domain AWS pelacakan yang berada di wilayah yang sama dengan domain kustom Anda. CDNHarus meneruskan Host header yang disediakan oleh pemohon ke asal, lihat artikel AWS re:Post ini untuk informasi lebih lanjut.

Tabel berikut berisi daftar domain pelacakan Wilayah AWS tempat SES tersedia—pilih domain yang berada di wilayah yang sama dengan domain kustom Anda:

AWS Wilayah	AWS domain pelacakan
AS Timur (Ohio)	`r.us-east-2.awstrack.me`
AS Timur (Virginia Utara)	`r.us-east-1.awstrack.me`
AS Barat (California Utara)	`r.us-west-1.awstrack.me`
AS Barat (Oregon)	`r.us-west-2.awstrack.me`
Afrika (Cape Town)	`r.af-south-1.awstrack.me`
Asia Pasifik (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asia Pasifik (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pasifik (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pasifik (Seoul)	`r.ap-northeast-2.awstrack.me`
Asia Pasifik (Singapura)	`r.ap-southeast-1.awstrack.me`
Asia Pasifik (Sydney)	`r.ap-southeast-2.awstrack.me`
Asia Pasifik (Tokyo)	`r.ap-northeast-1.awstrack.me`
Kanada (Pusat)	`r.ca-central-1.awstrack.me`
Eropa (Frankfurt)	`r.eu-central-1.awstrack.me`
Eropa (Irlandia)	`r.eu-west-1.awstrack.me`
Eropa (London)	`r.eu-west-2.awstrack.me`
Eropa (Milan)	`r.eu-south-1.awstrack.me`
Eropa (Stockholm)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Timur Tengah (Bahrain)	`r.me-south-1.awstrack.me`
Amerika Selatan (Sao Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (AS-Barat)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (AS-Timur)	`r.us-gov-east-1.awstrack.me`

Jika Anda menggunakan Route 53 untuk mengelola DNS konfigurasi domain Anda dan CloudFront sebagai milik AndaCDN, buat catatan Alias di Route 53 yang merujuk ke CloudFront distribusi Anda (seperti d111111abcdef8.cloudfront.net). Untuk informasi lebih lanjut, lihat Membuat Catatan Menggunakan Konsol Amazon Route 53 di Panduan Developer Amazon Route 53.

Jika tidak, dalam DNS konfigurasi untuk subdomain Anda, tambahkan CNAME catatan yang merujuk ke alamat AndaCDN.
Memperoleh SSL sertifikat dari Otoritas Sertifikat tepercaya. Sertifikat harus mencakup subdomain yang Anda buat di langkah 1 serta yang CDN Anda konfigurasikan dalam langkah 3—5. Unggah sertifikat keCDN.
Anda dapat menggunakan perintah curl berikut untuk memvalidasi bahwa domain kustom Anda yang baru dibuat menggunakan wilayah dan HTTPS protokol yang benar. Dalam contoh berikut, semuanya adalah literal kecuali untuk nama domain Anda:
```
curl --head https://custom.domain.com/favicon.ico
```
Respons dikembalikan seperti pada contoh berikut:
```
(python-sdk-test) jdoe@12a34567b89c BaconRedirectService % curl --head https://custom.domain.com/favicon.ico
HTTPS/1.1 200 OK
x-amz-ses-region: us-east-1
x-amz-ses-request-protocol: https
Content-Type: image/x-icon
Transfer-Encoding: chunked
Date: Fri, 30 Aug 2024 13:50:14 GMT
```
Tanggapan ini berisi properti berikut:
- Nilai x-amz-request-region header adalah SES wilayah yang menerima permintaan.
- Nilai x-amz-request-protocol header adalah protokol yang digunakan untuk permintaan antara CDN dan SES di header.
Jika pengaturan Anda benar, wilayah tersebut harus mencerminkan wilayah tempat domain Anda dibuat dan protokolnya seharusnyaHTTPS.

Bagian 2: Menentukan domain dan HTTPS kebijakan pengalihan kustom Anda melalui set konfigurasi

Setelah mengonfigurasi domain untuk menangani pengalihan pelacakan terbuka dan klik, Anda harus menentukan domain dan HTTPS kebijakan kustom Anda dalam set konfigurasi.

Saat Anda mengirim email menggunakan set konfigurasi, jika set konfigurasi tersebut dikonfigurasi untuk menggunakan domain pengalihan kustom, tautan buka dan klik di email tersebut secara otomatis menggunakan opsi domain dan HTTPS kebijakan khusus yang ditentukan dalam set konfigurasi.

Anda dapat menyelesaikan ini menggunakan SES konsol atau API operasi CreateConfigurationSetv2.

Untuk menentukan domain dan HTTPS kebijakan pengalihan kustom menggunakan konsol

Saat membuat atau mengedit set konfigurasi, gunakan opsi Pelacakan di Langkah 4 Buat set konfigurasi untuk menentukan opsi domain dan HTTPS kebijakan pengalihan kustom Anda.

Untuk menentukan domain dan HTTPS kebijakan pengalihan kustom menggunakan AWS CLI

Anda dapat menggunakan CreateConfigurationSetoperasi di SES API v2 dan menggunakan TrackingOptions properti untuk menentukan domain pengalihan kustom dan HTTPS kebijakan. Anda dapat memanggil operasi ini dari AWS CLI seperti yang ditunjukkan pada contoh berikut.

Buat konfigurasi yang diatur di Wilayah AWS tempat Anda ingin mengirim dan melacak email:
```
aws sesv2 create-configuration-set --cli-input-json file://create.json
```
Dalam contoh ini, file input menggunakan parameter TrackingOptionsproperti— CustomRedirectDomain menentukan domain kustom yang akan digunakan untuk melacak tautan terbuka dan klik, dan HttpsPolicy menentukan opsi HTTPS kebijakan:
```
{
    "ConfigurationSetName": "my-config-set",
    "TrackingOptions": {
        "CustomRedirectDomain": "marketing.example.com",
        "HttpsPolicy": "REQUIRE"
    },
    "SendingOptions": {
        "SendingEnabled": true
    }
}
```
Untuk HttpsPolicy parameter, nilai berikut dapat ditentukan untuk mengatur protokol tautan pelacakan terbuka dan klik untuk domain pengalihan khusus Anda:
- OPTIONAL— (Perilaku default) Buka tautan pelacakan akan dibungkus menggunakanHTTP. Klik tautan pelacakan akan dibungkus menggunakan protokol asli tautan.
- REQUIRE— Buka dan Klik tautan pelacakan keduanya akan dibungkus menggunakanHTTPS.
- REQUIRE_OPEN_ONLY— Tautan pelacakan terbuka akan dibungkus menggunakanHTTPS. Klik tautan pelacakan akan dibungkus menggunakan protokol asli tautan.

Bagian 3: Menentukan jenis acara terbuka dan klik melalui set konfigurasi

Setelah menentukan domain dan HTTPS kebijakan kustom Anda dalam konfigurasi yang ditetapkan pada langkah sebelumnya, Anda harus menentukan jenis peristiwa terbuka dan/atau klik untuk melacak tujuan peristiwa melalui set konfigurasi.

Anda dapat menyelesaikan ini menggunakan SES konsol atau API operasi CreateConfigurationSetEventDestinationv2.

Untuk memilih jenis acara terbuka dan/atau klik menggunakan konsol

Saat membuat atau memodifikasi tujuan acara, gunakan Buka dan klik pelacakan di Langkah 6 Membuat tujuan acara untuk menentukan jenis acara.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Tetapkan kolam IP

Tentukan set konfigurasi dalam email