Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Contiene informazioni su una promozione. Una promozione definisce regole aziendali aggiuntive che si applicano a un sottoinsieme configurabile di articoli consigliati.

## Indice
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
L'Amazon Resource Name (ARN) del filtro utilizzato dalla promozione. Questo filtro definisce i criteri per gli articoli promossi. Per ulteriori informazioni, consulta [Filtri promozionali](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters).  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Campo obbligatorio: no

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
I valori da utilizzare per promuovere gli articoli. Per ogni parametro segnaposto nell'espressione di filtro della promozione, fornisci il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, è possibile omettere il`filter-values`. In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni sulla creazione di filtri, consulta [Consigli di filtraggio e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Campo obbligatorio: no

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
Il nome della promozione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Campo obbligatorio: no

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
La percentuale di articoli consigliati a cui applicare la promozione.  
Tipo: integer  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Campo obbligatorio: no

## Vedi anche
<a name="API_RS_Promotion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)