本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

包含提升的相關資訊。提升定義適用於建議項目可設定子集的其他業務規則。

## 目錄
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
提升所使用的篩選條件 Amazon Resource Name (ARN)。此篩選條件定義提升項目的條件。如需詳細資訊，請參閱[提升篩選條件](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
提升項目時要使用的值。針對提升篩選條件表達式中的每個預留位置參數，提供參數名稱 （在相符的情況下） 做為索引鍵，並提供篩選條件值 （做為對應值）。以逗號分隔一個參數的多個值。  
對於使用 `INCLUDE`元素包含項目的篩選條件表達式，您必須為表達式中定義的所有參數提供值。對於具有使用 `EXCLUDE`元素排除項目之表達式的篩選條件，您可以省略 `filter-values`。在此情況下，Amazon Personalize 不會使用表達式的該部分來篩選建議。  
如需建立篩選條件的詳細資訊，請參閱[篩選建議和使用者客群](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)。  
類型：字串到字串映射  
映射項目：最多 25 個項目。  
金鑰長度限制：長度上限為 50。  
金鑰模式：`[A-Za-z0-9_]+`  
值長度限制：長度上限為 1000。  
必要：否

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
提升的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
要套用提升的建議項目百分比。  
類型：整數  
有效範圍：最小值為 1。最大值為 100。  
必要：否

## 另請參閱
<a name="API_RS_Promotion_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)