翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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)。このフィルターはプロモーション対象アイテムの条件を定義します。フィルターを使用する方法については、「プロモーションフィルター」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 256 です。  
パターン: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
必須: いいえ

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
アイテムをプロモーションするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。  
`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 を使用する方法の詳細については、以下を参照してください。
+  [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)