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

# Promotion
<a name="API_RS_Promotion"></a>

Berisi informasi tentang promosi. Promosi mendefinisikan aturan bisnis tambahan yang berlaku untuk subset item yang direkomendasikan yang dapat dikonfigurasi.

## Daftar Isi
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
Nama Sumber Daya Amazon (ARN) dari filter yang digunakan oleh promosi. Filter ini mendefinisikan kriteria untuk item yang dipromosikan. Untuk informasi selengkapnya, lihat [Filter promosi](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters).  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
Nilai yang digunakan saat mempromosikan item. Untuk setiap parameter placeholder dalam ekspresi filter promosi 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 tentang membuat filter, lihat [Memfilter rekomendasi dan segmen pengguna](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
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

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
Nama promosi.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Wajib: Tidak

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
Persentase item yang direkomendasikan untuk menerapkan promosi.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.  
Wajib: Tidak

## Lihat Juga
<a name="API_RS_Promotion_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)