As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Contém informações sobre uma promoção. Uma promoção define regras de negócios adicionais que se aplicam a um subconjunto configurável de itens recomendados.

## Conteúdo
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
O nome do recurso da Amazon (ARN) do filtro usado pela promoção. Esse filtro define os critérios para itens promovidos. Para obter mais informações, consulte [Promoção de filtros](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters).  
Tipo: String  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obrigatório: Não

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
Os valores a serem usados ao promover itens. Para cada parâmetro de espaço reservado na expressão de filtro da sua promoção, forneça o nome do parâmetro (em maiúsculas e minúsculas correspondendo) como uma chave e os valores do filtro como o valor correspondente. Separe vários valores para um parâmetro com uma vírgula.   
Para expressões de filtro que usam um elemento `INCLUDE` para incluir itens, você deve fornecer valores para todos os parâmetros definidos na expressão. Para filtros com expressões que usam um elemento `EXCLUDE` para excluir itens, você pode omitir `filter-values`. Nesse caso, o Amazon Personalize não usa essa parte da expressão para filtrar recomendações.  
Para obter mais informações sobre como criar filtros, consulte [Recomendações de filtragem e segmentos de usuários](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mapa de string para string  
Entradas do mapa: número máximo de 25 itens.  
Restrições de tamanhos de chave: tamanho máximo de 50.  
Padrão da chave: `[A-Za-z0-9_]+`   
Restrições de tamanho de valor: tamanho máximo de 1.000.  
Obrigatório: Não

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
O nome da promoção.  
Tipo: String  
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.  
Padrão: : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obrigatório: Não

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
A porcentagem de itens recomendados aos quais aplicar a promoção.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 100.  
Obrigatório: Não

## Consulte também
<a name="API_RS_Promotion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para 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 para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)