**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.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging. 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](event-streams-setup.md). 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 dalam[Atribut acara email](#event-streams-data-email-attributes). 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](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) 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](event-streams-setup.md). 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\$1type | Jenis peristiwa. Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-email.html) | | event\$1timestamp | Waktu ketika pesan dikirim, ditampilkan sebagai waktu Unix dalam milidetik. Nilai ini biasanya sama untuk semua peristiwa yang dihasilkan untuk pesan. | | arrival\$1timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | | event\$1version | Versi skema acara JSON. Periksa 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\$1context | Untuk acara email, objek ini berisi custom objek, yang berisi legacy\$1identifier atribut. Nilai untuk legacy\$1identifier 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\$1id | 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 `_email.click` peristiwa, nilai untuk atribut ini adalah URL tautan yang diklik penerima dalam pesan untuk menghasilkan acara. Untuk acara lain, nilai ini mewakili jenis acara, seperti`received`,`opened`, atau`clicked`. | | treatment\$1id | Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk kampanye standar dan pesan email transaksional, nilai ini adalah. `0` | | campaign\$1activity\$1id | ID unik yang dihasilkan Amazon Pinpoint saat peristiwa terjadi. | | campaign\$1id | ID unik kampanye yang mengirim pesan. | #### Perjalanan Termasuk informasi tentang perjalanan yang menghasilkan acara tersebut. | Atribut | Deskripsi | | --- | --- | | journey\$1run\$1id | ID unik dari perjalanan lari yang mengirim pesan. Amazon Pinpoint menghasilkan dan menetapkan ID ini secara otomatis ke setiap perjalanan baru. | | feedback | Untuk `_email.click` peristiwa, nilai untuk atribut ini adalah URL tautan yang diklik penerima dalam pesan untuk menghasilkan acara. Untuk acara lain, nilai ini mewakili jenis acara, seperti`received`,`delivered`, atau`opened`. | | journey\$1id | ID unik dari perjalanan yang mengirim pesan. | | journey\$1activity\$1id | ID unik dari aktivitas perjalanan yang mengirim pesan. | ### Klien Pengenal unik klien yang ditargetkan oleh kampanye atau perjalanan. | Atribut | Deskripsi | | --- | --- | | client\$1id | 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\$1channel | Berisi `mail_event` objek, yang berisi dua objek:`mail`, dan objek yang sesuai dengan jenis acara. | ### Mail Termasuk informasi tentang konten pesan email, dan metadata tentang pesan. | Atribut | Deskripsi | | --- | --- | | message\$1id | ID unik dari pesan. Amazon Pinpoint secara otomatis menghasilkan ID ini saat menerima pesan. | | message\$1send\$1timestamp | Tanggal dan waktu ketika pesan dikirim, dalam format yang ditentukan dalam [RFC 822](https://datatracker.ietf.org/doc/html/rfc822). | | from\$1address | Alamat email tempat pesan itu dikirim. | | destination | Array yang berisi alamat email tempat pesan dikirim. | | headers\$1truncated | 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-email.html) | | common\$1headers | Berisi informasi tentang beberapa header umum untuk pesan email. Informasi dapat mencakup tanggal ketika pesan dikirim, dan baris ke, dari, dan subjek pesan. |