本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

包含有关推广的信息。推广定义了其他业务规则，这些规则适用于可配置的建议物品子集。

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

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
推广使用的筛选器的 Amazon 资源名称 (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 SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)