GetPersonalizedRanking - Amazon Personalize
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

GetPersonalizedRanking

Memberi peringkat ulang daftar item yang direkomendasikan untuk pengguna yang diberikan. Item pertama dalam daftar dianggap sebagai item yang paling mungkin menarik bagi pengguna.

catatan

Solusi yang mendukung kampanye harus dibuat menggunakan resep tipe PERSONALIZED_RANKING.

Minta Sintaks

POST /personalize-ranking HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "inputList": [ "string" ],
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "userId": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

campaignArn

Nama Sumber Daya Amazon (ARN) kampanye yang akan digunakan untuk menghasilkan peringkat yang dipersonalisasi.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Ya

context

Metadata kontekstual yang digunakan saat mendapatkan rekomendasi. Metadata kontekstual mencakup informasi interaksi apa pun yang mungkin relevan saat mendapatkan rekomendasi pengguna, seperti lokasi pengguna saat ini atau jenis perangkat.

Tipe: Peta string ke string

Entri Peta: Jumlah maksimum 150 item.

Kendala Panjang Kunci: Panjang maksimum 150.

Pola Kunci: [A-Za-z\d_]+

Kendala Panjang Nilai: Panjang maksimum 1000.

Wajib: Tidak

filterArn

Nama Sumber Daya Amazon (ARN) dari filter yang Anda buat untuk menyertakan item atau mengecualikan item dari rekomendasi untuk pengguna tertentu. Untuk informasi selengkapnya, lihat Memfilter Rekomendasi.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Tidak

filterValues

Nilai yang akan digunakan saat memfilter rekomendasi. Untuk setiap parameter placeholder dalam ekspresi filter Anda, berikan nama parameter (dalam kasus yang cocok) sebagai kunci dan nilai filter sebagai nilai yang sesuai. Pisahkan beberapa nilai untuk satu parameter dengan koma.

Untuk ekspresi filter yang menggunakan INCLUDE elemen untuk menyertakan item, Anda harus memberikan nilai untuk semua parameter yang ditentukan dalam ekspresi. Untuk filter dengan ekspresi yang menggunakan EXCLUDE elemen untuk mengecualikan item, Anda dapat menghilangkan filter-values .Dalam kasus ini, Amazon Personalize tidak menggunakan bagian ekspresi tersebut untuk memfilter rekomendasi.

Untuk informasi selengkapnya, lihat Memfilter Rekomendasi.

Tipe: Peta string ke string

Entri Peta: Jumlah maksimum 25 item.

Kendala Panjang Kunci: Panjang maksimum 50.

Pola Kunci: [A-Za-z0-9_]+

Kendala Panjang Nilai: Panjang maksimum 1000.

Wajib: Tidak

inputList

Daftar item (olehitemId) ke peringkat. Jika item tidak termasuk dalam kumpulan data pelatihan, item tersebut ditambahkan ke akhir daftar yang di-reanked. Jika Anda memasukkan metadata dalam rekomendasi, maksimumnya adalah 50. Kalau tidak, maksimumnya adalah 500.

Tipe: Array string

Batasan Panjang: Panjang maksimum 256.

Wajib: Ya

metadataColumns

Jika Anda mengaktifkan metadata dalam rekomendasi saat membuat atau memperbarui kampanye, tentukan kolom metadata dari kumpulan data Item untuk disertakan dalam peringkat yang dipersonalisasi. Kunci peta adalah ITEMS dan nilainya adalah daftar nama kolom dari kumpulan data Item Anda. Jumlah maksimum kolom yang dapat Anda berikan adalah 10.

Untuk informasi tentang mengaktifkan metadata untuk kampanye, lihat Mengaktifkan metadata dalam rekomendasi untuk kampanye.

Tipe: Peta string ke array string

Entri Peta: Jumlah maksimum 1 item.

Kendala Panjang Kunci: Panjang maksimum 256.

Anggota Array: Jumlah maksimum 99 item.

Kendala Panjang: Panjang maksimum 150.

Wajib: Tidak

userId

Pengguna yang Anda inginkan kampanyenya memberikan peringkat yang dipersonalisasi.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Wajib: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

personalizedRanking

Daftar item dalam urutan yang paling mungkin menarik bagi pengguna. Maksimumnya adalah 500.

Tipe: Array objek PredictedItem

recommendationId

ID rekomendasi.

Jenis: String

Kesalahan

InvalidInputException

Berikan nilai yang valid untuk bidang atau parameter.

Kode Status HTTP: 400

ResourceNotFoundException

Sumber daya yang ditentukan tidak ada.

Kode Status HTTP: 404

Lihat Juga

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