Event

Merupakan informasi peristiwa interaksi item yang dikirim menggunakan PutEvents API.

Daftar Isi

eventType

Jenis acara, seperti klik atau unduh. Properti ini sesuai dengan EVENT_TYPE bidang skema kumpulan data interaksi Item Anda dan bergantung pada jenis peristiwa yang Anda lacak.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Diperlukan: Ya

sentAt

Stempel waktu (dalam waktu Unix) di sisi klien saat peristiwa terjadi.

Tipe: Timestamp

Diperlukan: Ya

eventId

ID yang terkait dengan acara tersebut. Jika ID peristiwa tidak disediakan, Amazon Personalize akan menghasilkan ID unik untuk acara tersebut. ID peristiwa tidak digunakan sebagai masukan ke model. Amazon Personalize menggunakan ID peristiwa untuk membedakan peristiwa unik. Setiap peristiwa berikutnya setelah yang pertama dengan ID acara yang sama tidak digunakan dalam pelatihan model.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Diperlukan: Tidak

eventValue

Nilai peristiwa yang sesuai dengan EVENT_VALUE bidang skema interaksi Item.

Tipe: Float

Diperlukan: Tidak

impression

Daftar ID item yang mewakili urutan item yang telah Anda tunjukkan kepada pengguna. Misalnya, ["itemId1", "itemId2", "itemId3"]. Berikan daftar item untuk merekam data tayangan secara manual untuk suatu peristiwa. Untuk informasi selengkapnya tentang merekam data tayangan, lihat Merekam data tayangan.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 25 item.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Diperlukan: Tidak

itemId

Kunci ID item yang sesuai dengan ITEM_ID bidang skema kumpulan data interaksi Item.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Diperlukan: Tidak

metricAttribution

Berisi informasi tentang atribusi metrik yang terkait dengan suatu peristiwa. Untuk informasi selengkapnya tentang atribusi metrik, lihat Mengukur dampak rekomendasi.

Tipe: Objek MetricAttribution

Diperlukan: Tidak

properties

Peta string data khusus peristiwa yang mungkin Anda pilih untuk direkam. Misalnya, jika pengguna menilai film di situs Anda, selain ID film (itemId) dan rating (eventValue), Anda juga dapat mengirimkan jumlah peringkat film yang dibuat oleh pengguna.

Setiap item di peta terdiri dari pasangan kunci-nilai. Misalnya,

{"numberOfRatings": "12"}

Kunci menggunakan nama kasus unta yang cocok dengan bidang dalam skema kumpulan data interaksi Item. Dalam contoh di atas, numberOfRatings akan cocok dengan bidang 'NUMBER_OF_RATINGS' yang ditentukan dalam skema kumpulan data interaksi Item.

Berikut ini tidak dapat dimasukkan sebagai kata kunci untuk properti (case insensitive).

• userId

• sessionId

• eventType

• timestamp

• RecommendationID

• kesan

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Diperlukan: Tidak

recommendationId

ID daftar rekomendasi yang berisi item yang berinteraksi dengan pengguna. Berikan recommendationId agar Amazon Personalisasi secara implisit merekam rekomendasi yang Anda tunjukkan kepada pengguna sebagai data tayangan. Atau berikan recommendationId jika Anda menggunakan atribusi metrik untuk mengukur dampak rekomendasi.

Untuk informasi selengkapnya tentang merekam data tayangan, lihat Merekam data tayangan. Untuk informasi selengkapnya tentang membuat atribusi metrik, lihat Mengukur dampak rekomendasi.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 40.

Diperlukan: Tidak

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

• AWS SDK for C++

• AWS SDK for Java V2

• AWS SDK for Ruby V3