Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengonfigurasi domain kustom untuk menangani pelacakan buka dan klik
Saat Anda menggunakan publikasi peristiwa untuk menangkap peristiwa buka dan klik, Amazon SES membuat perubahan kecil pada email yang Anda kirim. Untuk menangkap acara terbuka, SES menambahkan gambar GIF transparan 1 piksel kali 1 piksel di setiap email yang dikirim melalui SES yang menyertakan nama file unik untuk setiap email, dan dihosting di server yang dioperasikan oleh SES; ketika gambar diunduh, SES dapat mengetahui dengan tepat pesan mana yang dibuka dan oleh siapa.
Secara default, piksel ini dimasukkan di bagian bawah email; Namun, beberapa aplikasi penyedia email memotong pratinjau email ketika melebihi ukuran tertentu dan dapat menyediakan tautan untuk melihat sisa pesan. Dalam skenario ini, gambar pelacakan piksel SES tidak dimuat dan akan membuang tarif terbuka yang Anda coba lacak. Untuk menyiasatinya, Anda dapat menempatkan piksel secara opsional di awal email, atau di tempat lain, dengan memasukkan {{ses:openTracker}} placeholder ke dalam badan email. Setelah SES menerima pesan dengan placeholder, pesan tersebut akan diganti dengan gambar piksel pelacakan terbuka.
penting
-
Setiap
{{ses:openTracker}}placeholder yang 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 kode400 BadRequestExceptionkesalahan yang dikembalikan.
Untuk menangkap peristiwa klik tautan, SES mengganti tautan di email Anda dengan tautan ke server yang dioperasikan oleh SES. Tindakn ini segera mengalihkan penerima ke tujuan yang dimaksudkan. Ukuran total header, termasuk cookie, dari 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 oleh SES, untuk menciptakan pengalaman yang lebih kohesif bagi penerima Anda, yang berarti semua indikator SES dihapus. 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 pada 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 menetapkan set konfigurasi untuk menggunakan domain kustom, dan kemudian mengatur tujuan acaranya untuk menerbitkan acara terbuka dan klik. Topik ini berisi prosedur untuk menyelesaikan semua langkah ini.
Namun, jika Anda hanya ingin mengaktifkan pelacakan buka atau klik tanpa menyiapkan domain khusus, Anda dapat melanjutkan langsung ke menentukan tujuan acara untuk kumpulan konfigurasi Anda yang memungkinkan penerbitan peristiwa yang dipicu pada jenis peristiwa yang Anda tentukan, termasuk acara buka dan klik. Kumpulan konfigurasi dapat memiliki beberapa tujuan acara dengan beberapa jenis peristiwa yang ditentukan. Lihat Membuat tujuan acara Amazon SES.
Bagian 1: Menyiapkan domain untuk menangani pengalihan tautan buka dan klik
Prosedur khusus untuk menyiapkan domain pengalihan berbeda-beda tergantung pada penyedia hosting web Anda (dan Jaringan Pengiriman Konten Anda, jika Anda menggunakan server HTTPS). Prosedur di bagian berikut menyediakan panduan umum bukannya langkah-langkah tertentu.
Opsi 1: Mengonfigurasi domain HTTP
Jika Anda berencana untuk menggunakan domain HTTP untuk menangani tautan buka dan klik (sebagai lawan domain HTTPS), proses untuk mengonfigurasi subdomain hanya melibatkan beberapa langkah.
catatan
Jika Anda menyiapkan domain kustom yang menggunakan protokol HTTP, dan Anda mengirim email yang berisi tautan yang menggunakan protokol HTTPS, pelanggan Anda mungkin melihat pesan peringatan ketika mereka mengeklik tautan di email Anda. Jika Anda berencana mengirim email yang berisi tautan yang menggunakan protokol HTTPS, Anda harus menggunakan domain HTTPS untuk menangani peristiwa pelacakan klik.
Untuk menyiapkan subdomain HTTP untuk menangani tautan buka dan klik
-
Buat subdomain untuk digunakan untuk membuka dan mengklik tautan pelacakan. SES merekomendasikan bahwa subdomain ini secara khusus didedikasikan untuk menangani tautan ini, dan bahwa subdomain dibuat untuk setiap Wilayah AWS Anda mengirim email yang ingin Anda lacak.
-
Verifikasi subdomain untuk digunakan dengan SES. Untuk informasi selengkapnya, lihat Membuat identitas domain.
-
Tambahkan catatan CNAME baru ke pengaturan DNS subdomain Anda yang mengalihkan permintaan ke domain pelacakan SES. Alamat yang Anda alihkan harus Wilayah AWS sama dengan subdomain kustom Anda.
-
Gunakan tabel Tracking domain di Referensi Umum AWS untuk memilih domain pelacakan yang berada di wilayah yang sama dengan domain kustom Anda.
catatan
Tergantung pada penyedia hosting web Anda, diperlukan beberapa menit agar perubahan yang Anda buat pada catatan DNS subdomain diterapkan. Penyedia hosting web atau organisasi IT Anda dapat memberikan informasi tambahan tentang penundaan ini.
-
Opsi 2: Mengonfigurasi domain HTTPS
Anda juga dapat menggunakan domain HTTPS untuk melacak klik terbuka dan tautan. Untuk mengatur domain HTTPS untuk melacak klik terbuka dan tautan, Anda harus melakukan beberapa langkah tambahan, di luar yang diperlukan untuk menyiapkan domain HTTP.
Untuk mengatur subdomain HTTPS untuk menangani tautan buka dan klik
-
Buat subdomain untuk digunakan untuk membuka dan mengklik tautan pelacakan. SES merekomendasikan bahwa subdomain ini secara khusus didedikasikan untuk menangani tautan ini, dan bahwa subdomain dibuat untuk setiap Wilayah AWS Anda mengirim email yang ingin Anda lacak.
-
Verifikasi subdomain untuk digunakan dengan SES. Untuk informasi selengkapnya, lihat Membuat identitas domain.
-
Buat akun baru dengan Jaringan Pengiriman Konten (CDN), seperti Amazon CloudFront
, lihat Memulai dengan CloudFront distribusi dasar. -
Konfigurasikan CDN ke asal yang merupakan domain pelacakan SES, seperti
r.us-east-1.awstrack.memisalnya. CDN harus menunjuk ke domain pel AWS acakan yang berada di wilayah yang sama dengan domain kustom Anda. CDN harus meneruskanHostheader yang diberikan oleh pemohon ke asal, lihat artikel AWSre:Post ini untuk informasi lebih lanjut. -
Gunakan tabel Tracking domain di Referensi Umum AWS untuk memilih domain pelacakan yang berada di wilayah yang sama dengan domain kustom Anda.
-
-
Jika Anda menggunakan Route 53 untuk mengelola konfigurasi DNS untuk domain Anda dan CloudFront sebagai CDN Anda, buat catatan Alias di Route 53 yang merujuk ke CloudFront distribusi Anda (seperti d111111 abcdef8.cloudfront.net). Untuk informasi lebih lanjut, lihat Membuat Catatan Menggunakan Konsol Amazon Route 53 di Panduan Developer Amazon Route 53.
Jika tidak, di konfigurasi DNS untuk subdomain Anda, tambahkan catatan CNAME yang mengacu ke alamat CDN Anda.
-
Peroleh sertifikat SSL dari Certicate Authority terpercaya. Sertifikat harus mencakup kedua subdomain yang Anda buat pada langkah 1 serta CDN yang Anda konfigurasikan pada langkah 3-5. Unggah sertifikat ke CDN.
-
Anda dapat menggunakan perintah curl berikut untuk memvalidasi bahwa domain kustom yang baru dibuat menggunakan wilayah yang benar dan protokol HTTPS. Dalam contoh berikut, semuanya literal kecuali nama domain Anda:
curl --head https://custom.domain.com/favicon.icoRespons dikembalikan seperti dalam 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 GMTRespons ini berisi properti berikut:
-
Nilai
x-amz-ses-regionheader adalah wilayah SES yang menerima permintaan. -
Nilai
x-amz-ses-request-protocolheader 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 harus HTTPS.
-
Bagian 2: Menentukan domain pengalihan kustom dan kebijakan HTTPS melalui kumpulan konfigurasi
Setelah mengonfigurasi domain untuk menangani pengalihan pelacakan terbuka dan klik, Anda harus menentukan domain kustom dan kebijakan HTTPS dalam kumpulan konfigurasi.
Saat Anda mengirim email menggunakan kumpulan konfigurasi, jika kumpulan konfigurasi tersebut dikonfigurasi untuk menggunakan domain pengalihan kustom, tautan buka dan klik di email tersebut secara otomatis menggunakan domain kustom dan opsi kebijakan HTTPS yang ditentukan dalam kumpulan konfigurasi.
Anda dapat menyelesaikan ini menggunakan konsol SES atau operasi API CreateConfigurationSet v2.
Untuk menentukan domain pengalihan kustom dan kebijakan HTTPS menggunakan konsol
-
Saat membuat atau mengedit kumpulan konfigurasi, gunakan opsi Pelacakan di Langkah 4 Buat set konfigurasi untuk menentukan domain pengalihan kustom dan opsi kebijakan HTTPS.
Untuk menentukan domain pengalihan kustom dan kebijakan HTTPS menggunakan AWS CLI
Anda dapat menggunakan CreateConfigurationSet operasi di SES API v2 dan menggunakan TrackingOptions properti untuk menentukan domain pengalihan kustom dan kebijakan HTTPS. Anda dapat memanggil operasi ini dari AWS CLI seperti yang ditunjukkan pada contoh berikut.
-
Buat set konfigurasi 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—CustomRedirectDomainmenentukan domain khusus yang akan digunakan untuk melacak tautan terbuka dan klik, danHttpsPolicymenentukan opsi kebijakan HTTPS:{ "ConfigurationSetName": "my-config-set", "TrackingOptions": { "CustomRedirectDomain": "marketing.example.com", "HttpsPolicy": "REQUIRE" }, "SendingOptions": { "SendingEnabled": true } }Untuk
HttpsPolicyparameter, nilai-nilai berikut dapat ditentukan untuk mengatur protokol tautan pelacakan buka dan klik untuk domain pengalihan kustom Anda:-
OPTIONAL— (Perilaku default) Tautan pelacakan terbuka akan dibungkus menggunakan HTTP. Tautan pelacakan klik akan dibungkus menggunakan protokol asli tautan. -
REQUIRE— Tautan pelacakan Buka dan Klik keduanya akan dibungkus menggunakan HTTPS. -
REQUIRE_OPEN_ONLY— Tautan pelacakan terbuka akan dibungkus menggunakan HTTPS. Tautan pelacakan klik akan dibungkus menggunakan protokol asli tautan.
-
Bagian 3: Menentukan jenis acara terbuka dan klik melalui kumpulan konfigurasi
Setelah menentukan domain kustom dan kebijakan HTTPS dalam konfigurasi yang ditetapkan pada langkah sebelumnya, Anda harus menentukan jenis acara and/or klik terbuka untuk dilacak di tujuan acara melalui kumpulan konfigurasi.
Anda dapat menyelesaikan ini menggunakan konsol SES atau operasi API CreateConfigurationSetEventDestination v2.
Untuk memilih jenis acara and/or klik terbuka menggunakan konsol
-
Saat membuat atau memodifikasi tujuan acara, gunakan Buka dan klik pelacakan di Langkah 6 Membuat tujuan acara untuk menentukan jenis acara.
Bagian 4 (Opsional): Mengkonfigurasi segmen jalur khusus untuk Tautan Universal dan Tautan Aplikasi
Bagian ini opsional. Selesaikan hanya jika Anda memiliki aplikasi seluler dan ingin Tautan Universal iOS atau Tautan Aplikasi Android membuka aplikasi Anda secara langsung saat penerima mengklik tautan pelacakan. Lengkapi subbagian untuk setiap platform seluler yang didukung aplikasi Anda—iOS, Android, atau keduanya. Sebelum Anda mulai, selesaikan Bagian 1 untuk menyiapkan domain pengalihan khusus dan Bagian 2 untuk mengonfigurasi set konfigurasi Anda untuk menggunakan domain tersebut.
Jika Anda menggunakan Tautan Universal iOS atau Tautan Aplikasi Android, sistem operasi memeriksa file verifikasi yang dihosting di domain pelacakan klik untuk memutuskan aplikasi mana yang harus membuka tautan. Jika aplikasi diinstal, tautan terbuka langsung di aplikasi. Jika aplikasi tidak diinstal, tautan akan kembali ke browser web. Karena file verifikasi ini menggunakan pencocokan awalan jalur, Anda perlu mengontrol segmen jalur di URL pelacakan Anda.
Gunakan ses:custom-path atribut pada <a> tag individual di HTML email Anda untuk menambahkan segmen jalur tetap ke URL pelacakan:
<a href="https://example.com/product/123" ses:custom-path="myapp">View product</a>
Contoh berikut menunjukkan perbedaan antara URL pelacakan tanpa dan denganses:custom-path:
-
Tanpa
ses:custom-path(default):https://{your-custom-redirect-domain}/CL0/{encodedUrl}/{index}/{messageId}/{hmac} -
Dengan
ses:custom-path="myapp":https://{your-custom-redirect-domain}/CL1/myapp/{encodedUrl}/{index}/{messageId}/{hmac}
ses:custom-pathNilai harus memenuhi persyaratan berikut:
-
Huruf (A—Z, a—z), digit (0—9), tanda hubung (-), titik (.), atau garis bawah (_) saja
-
1—32 karakter, peka huruf besar/kecil
-
SES menghapus atribut ini dari email sebelum pengiriman
-
Kembali ke format default jika nilainya tidak valid (sama seperti menghilangkan)
ses:custom-path
ses:custom-pathNilai tidak muncul dalam data peristiwa klik. Untuk mengidentifikasi tautan mana yang diklik dalam acara, gunakanses:tags.
Tautan Universal iOS
Untuk mengotorisasi aplikasi iOS Anda untuk menangani Tautan Universal di domain pengalihan kustom Anda, host file berikut di: https://{your-custom-redirect-domain}/.well-known/apple-app-site-association
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.myapp",
"paths": ["/CL1/myapp/*"]
}
]
}
}
GantiTEAMID. com.example.myappdengan ID Tim Apple dan pengenal bundel aplikasi Anda, dan myapp dengan nilai yang Anda tentukanses:custom-path.
Tautan Aplikasi Android
Untuk mengotorisasi aplikasi Android Anda untuk menangani Tautan Aplikasi di domain pengalihan kustom Anda, host file berikut di: https://{your-custom-redirect-domain}/.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.myapp",
"sha256_cert_fingerprints": ["certificate-fingerprint"]
}
}]
Ganti com.example.myapp dengan nama paket aplikasi Anda dan certificate-fingerprint dengan sidik jari sertifikat penandatanganan aplikasi Anda.
catatan
Android menangani pencocokan path-prefix secara berbeda dari iOS. Alih-alih menentukan awalan jalur dalam assetlinks.json file, konfigurasikan filter maksud di aplikasi Anda AndroidManifest.xml denganandroid:pathPrefix="/CL1/, di mana nilai myapp/"myapp yang Anda tentukan. ses:custom-path Untuk informasi selengkapnya, lihat dokumentasi Android App Links di situs web Android Developers