Pemberitahuan akhir dukungan: Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat Amazon Pinpoint akhir dukungan. Catatan: APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh Pesan Pengguna AWS Akhir.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Aliran data acara email dari Amazon Pinpoint
Jika Anda menggunakan Amazon Pinpoint untuk mengirim email, Amazon Pinpoint dapat mengalirkan data acara tentang email tersebut. Setelah mengatur streaming acara, Amazon Pinpoint mengambil data peristiwa dari tujuan yang Anda tentukan selama penyiapan untuk dilihat. Untuk informasi tentang cara mengatur streaming acara, lihat Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose . Amazon Pinpoint mengalirkan data tentang jenis peristiwa berikut untuk pesan email:
-
Mengirim
-
Pengiriman
-
Pentalan
-
Aduan
-
Membuka
-
Klik
-
Penolakan
-
Berhenti berlangganan
-
Kegagalan rendering
Jenis acara ini dijelaskan secara rinci dalamAtribut acara email.
Bergantung pada API dan pengaturan yang Anda gunakan untuk mengirim pesan email, Anda mungkin melihat jenis peristiwa tambahan atau data yang berbeda. Misalnya, jika Anda mengirim pesan menggunakan set konfigurasi yang mempublikasikan data peristiwa ke Amazon Kinesis, seperti yang disediakan oleh Amazon Simple Email Service (Amazon SES), data juga dapat menyertakan peristiwa untuk kegagalan rendering template. Untuk informasi tentang data tersebut, lihat Pemantauan menggunakan penerbitan acara Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon. Sebelum Anda dapat melihat acara Anda, Anda harus mengatur streaming acara, lihat Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose . Saat menyiapkan streaming acara, Anda menentukan tujuan untuk data acara Anda untuk disimpan dan kemudian Anda dapat menggunakan tujuan untuk mengambil data acara Anda untuk dilihat.
Contoh acara email
Kirim email
Objek JSON untuk acara pengiriman email berisi data yang ditunjukkan dalam contoh berikut.
{ "event_type": "_email.send", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622025, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "received" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "send": {} } } } }
Email terkirim
Objek JSON untuk acara yang dikirim email berisi data yang ditunjukkan dalam contoh berikut.
{ "event_type": "_email.delivered", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622690, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "delivered" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "delivery": { "smtp_response": "250 ok: Message 82080542 accepted", "reporting_mta": "a8-53.smtp-out.amazonses.com", "recipients": ["recipient@example.com"], "processing_time_millis": 1310 } } } } }
Klik email
Objek JSON untuk acara klik email berisi data yang ditunjukkan dalam contoh berikut.
{ "event_type": "_email.click", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618713751, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "https://aws.amazon.com/pinpoint/" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "click": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15", "link": "https://aws.amazon.com/pinpoint/" } } } } }
Email terbuka
Objek JSON untuk acara terbuka email berisi data yang ditunjukkan dalam contoh berikut.
{ "event_type": "_email.open", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618712316, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "opened" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "open": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)" } } } } }
Atribut acara email
Bagian ini mendefinisikan atribut yang disertakan dalam contoh data aliran peristiwa sebelumnya yang dihasilkan Amazon Pinpoint saat Anda mengirim pesan email.
Atribut | Deskripsi |
---|---|
event_type |
Jenis peristiwa. Kemungkinan nilainya adalah:
|
event_timestamp |
Waktu ketika pesan dikirim, ditampilkan sebagai waktu Unix dalam milidetik. Nilai ini biasanya sama untuk semua peristiwa yang dihasilkan untuk pesan. |
arrival_timestamp |
Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. |
event_version |
Versi skema acara JSON. TipPeriksa versi ini di aplikasi pemrosesan acara Anda sehingga Anda tahu kapan harus memperbarui aplikasi sebagai respons terhadap pembaruan skema. |
application |
Informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut. Lihat tabel Aplikasi untuk informasi selengkapnya. |
client |
Informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel Klien. |
device |
Informasi tentang perangkat yang melaporkan acara tersebut. Untuk informasi selengkapnya, lihat tabel Perangkat. Untuk acara email, objek ini kosong. |
session |
Untuk acara email, objek ini kosong. |
attributes |
Atribut yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel Atribut. Untuk peristiwa yang dilaporkan oleh salah satu aplikasi Anda, objek ini dapat menyertakan atribut khusus yang ditentukan oleh aplikasi. Untuk acara yang dibuat saat Anda mengirim pesan dari kampanye atau perjalanan, objek ini berisi atribut yang terkait dengan kampanye atau perjalanan. Untuk peristiwa yang dihasilkan saat Anda mengirim pesan transaksional, objek ini berisi informasi yang terkait dengan pesan itu sendiri. |
client_context |
Untuk acara email, objek ini berisi custom objek, yang berisi legacy_identifier atribut. Nilai untuk legacy_identifier atribut adalah ID proyek tempat pesan dikirim. |
facets |
Informasi tambahan tentang pesan, seperti header email. Lihat tabel Facets untuk informasi lebih lanjut. |
awsAccountId |
ID AWS akun yang digunakan untuk mengirim pesan. |
Aplikasi
Termasuk informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut.
Atribut | Deskripsi |
---|---|
app_id |
ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut. |
sdk |
SDK yang digunakan untuk melaporkan peristiwa tersebut. Jika Anda mengirim pesan email transaksional dengan memanggil Amazon Pinpoint API secara langsung atau menggunakan konsol Amazon Pinpoint, objek ini kosong. |
Atribut
Termasuk informasi tentang kampanye atau perjalanan yang menghasilkan acara.
Kampanye
Termasuk informasi tentang kampanye yang menghasilkan acara tersebut.
Atribut | Deskripsi |
---|---|
feedback |
Untuk |
treatment_id |
Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk kampanye standar dan pesan email transaksional, nilai ini adalah. |
campaign_activity_id |
ID unik yang dihasilkan Amazon Pinpoint saat peristiwa terjadi. |
campaign_id |
ID unik kampanye yang mengirim pesan. |
Perjalanan
Termasuk informasi tentang perjalanan yang menghasilkan acara tersebut.
Atribut | Deskripsi |
---|---|
journey_run_id |
ID unik dari perjalanan lari yang mengirim pesan. Amazon Pinpoint menghasilkan dan menetapkan ID ini secara otomatis ke setiap perjalanan baru. |
feedback |
Untuk |
journey_id |
ID unik dari perjalanan yang mengirim pesan. |
journey_activity_id |
ID unik dari aktivitas perjalanan yang mengirim pesan. |
Klien
Pengenal unik klien yang ditargetkan oleh kampanye atau perjalanan.
Atribut | Deskripsi |
---|---|
client_id |
ID klien. Nilai adalah Endpoint ID untuk kampanye dan perjalanan, dan untuk pengiriman Transaksional, itu adalah UUID. |
Faset
Termasuk informasi tentang pesan dan jenis acara.
Atribut | Deskripsi |
---|---|
email_channel |
Berisi |
Termasuk informasi tentang konten pesan email, dan metadata tentang pesan.
Atribut | Deskripsi |
---|---|
message_id |
ID unik dari pesan. Amazon Pinpoint secara otomatis menghasilkan ID ini saat menerima pesan. |
message_send_timestamp |
Tanggal dan waktu ketika pesan dikirim, dalam format yang ditentukan dalam RFC 822 |
from_address |
Alamat email tempat pesan itu dikirim. |
destination |
Array yang berisi alamat email tempat pesan dikirim. |
headers_truncated |
Nilai Boolean yang menunjukkan apakah header email terpotong. |
headers |
Objek yang berisi beberapa pasangan nama-nilai yang sesuai dengan header dalam pesan. Objek ini biasanya berisi informasi tentang header berikut:
|
common_headers |
Berisi informasi tentang beberapa header umum untuk pesan email. Informasi dapat mencakup tanggal ketika pesan dikirim, dan baris ke, dari, dan subjek pesan. |