기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

홍보에 대한 정보가 들어 있습니다. 홍보는 추천 항목의 구성 가능한 하위 집합에 적용되는 추가 비즈니스 규칙을 정의합니다.

## 내용
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
홍보에 사용되는 필터의 리소스 이름(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`를 생략할 수 있습니다. 이 경우 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [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)