Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
GetActionRecommendations
Mengembalikan daftar tindakan yang direkomendasikan diurutkan dalam urutan menurun berdasarkan skor prediksi. Gunakan GetActionRecommendations API jika Anda memiliki kampanye khusus yang menerapkan versi solusi yang dilatih dengan resep PERSONALIZED_ACTIONS.
Untuk informasi selengkapnya tentang resep PERSONALIZED_ACTIONS, lihat resep PERSONALIZED_ACTIONS. Untuk informasi selengkapnya tentang mendapatkan rekomendasi tindakan, lihat Mendapatkan rekomendasi tindakan.
Minta Sintaks
POST /action-recommendations HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"numResults": number,
"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 mendapatkan rekomendasi tindakan. Kampanye ini harus menerapkan versi solusi yang dilatih dengan resep PERSONALIZED_ACTIONS.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+Diperlukan: Tidak
- filterArn
-
ARN filter untuk diterapkan pada rekomendasi yang dikembalikan. Untuk informasi selengkapnya, lihat Memfilter Rekomendasi.
Saat menggunakan parameter ini, pastikan sumber daya filternya
ACTIVE.Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+Diperlukan: Tidak
- filterValues
-
Nilai yang 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
INCLUDEelemen untuk menyertakan tindakan, Anda harus memberikan nilai untuk semua parameter yang ditentukan dalam ekspresi. Untuk filter dengan ekspresi yang menggunakanEXCLUDEelemen untuk mengecualikan tindakan, Anda dapat menghilangkan.filter-valuesDalam kasus ini, Amazon Personalize tidak menggunakan bagian ekspresi tersebut untuk memfilter rekomendasi.Untuk informasi selengkapnya, lihat Memfilter rekomendasi dan segmen pengguna.
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.
Diperlukan: Tidak
- numResults
-
Jumlah hasil yang akan dikembalikan. Default-nya adalah 5. Maksimal adalah 100.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 0.
Diperlukan: Tidak
- userId
-
ID pengguna pengguna untuk memberikan rekomendasi tindakan untuk.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Diperlukan: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"actionList": [
{
"actionId": "string",
"score": number
}
],
"recommendationId": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- actionList
-
Daftar rekomendasi tindakan yang diurutkan dalam urutan menurun berdasarkan skor prediksi. Bisa ada maksimal 100 tindakan dalam daftar. Untuk informasi tentang skor aksi, lihat Cara kerja penilaian rekomendasi tindakan.
Tipe: Array objek PredictedAction
- 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:
