Filtra la struttura e gli elementi delle espressioni

Questa sezione include informazioni sulla struttura delle espressioni di filtro e dei relativi elementi.

Struttura delle espressioni di filtro

La struttura generale di un'espressione di filtro è la seguente:

EXCLUDE/INCLUDE ItemID/ActionID/UserID WHERE dataset type.field IN/NOT IN (value/parameter)
        

È possibile creare manualmente espressioni di filtro o ottenere assistenza sulla sintassi e sulla struttura delle espressioni utilizzando il generatore di espressioni nella console.

Filtrare gli elementi di espressione

Utilizzate i seguenti elementi per creare espressioni di filtro:

INCLUDE o ESCLUDE

INCLUDEUtilizzalo per limitare i consigli ai soli elementi che soddisfano i criteri di filtro OPPURE EXCLUDE per rimuovere tutti gli elementi che soddisfano i criteri di filtro.

ItemID/ActionID/UserID

Utilizzate uno di questi elementi dopo l'elemento or. INCLUDE EXCLUDE L'elemento utilizzato dipende dal fatto che stiate filtrando gli elementi (per i consigli sugli articoli), le azioni (per i consigli sulle azioni) o gli utenti (per i segmenti di utenti).

WHERE

WHEREDa utilizzare per verificare le condizioni relative a elementi, azioni o utenti. È necessario utilizzare l'WHEREelemento dopo ItemIDActionID, oUserID.

E/O

Per concatenare più condizioni all'interno della stessa espressione di filtro, usa AND oOR. Condizioni concatenate utilizzando AND o OR possono influire solo sui campi del set di dati utilizzato nella prima condizione.

Dataset.field

Fornisci il set di dati e il campo di metadati in base ai quali desideri filtrare i consigli. dataset fieldformato. Ad esempio, per filtrare i consigli sugli articoli in base al campo genres nel set di dati Items, dovresti utilizzare items.genres nell'espressione di filtro.

Condizione IF

Usa una IF condizione solo per controllare le condizioni per CurrentUser e solo una volta alla fine di un'espressione. Tuttavia, è possibile estendere una IF condizione utilizzandoAND.

CurrentUser.attributo

Per filtrare i consigli sugli articoli in base all'utente per cui li ricevi, utilizza CurrentUser e fornisci il campo utente solo in una condizione IF. Ad esempio, CurrentUser.AGE.

CurrentItem.attributo

Solo per articoli correlati, ricette e casi d'uso, usaCurrentItem. attributeper filtrare gli articoli in base a un attributo dell'articolo specificato nella richiesta di consigli sugli articoli correlati. Ad esempio CurrentItem.GENRE o CurrentItem.PRICE.

Puoi applicare un filtro con l' CurrentItem elemento solo se il caso d'uso del dominio o la ricetta personalizzata genera consigli sugli articoli correlati, come la ricetta Similar-Items o il caso d'uso del dominio More Like X. La prima volta che crei un filtro con un CurrentItem elemento, la creazione del filtro può richiedere alcuni minuti. Se si utilizza AWS KMS per la crittografia, la creazione del filtro può richiedere fino a 15 minuti.

ENTRATA/NON DENTRO

Usa IN or NOT IN come operatori di confronto per filtrare in base alla corrispondenza (o alla mancata corrispondenza) di uno o più valori di stringa. Amazon Personalize filtra solo su stringhe esatte.

Operatori di confronto

Usa =, <, <=, >, >= e! = operatori per verificare l'uguaglianza dei dati numerici, inclusi i dati passati in un parametro segnaposto.

Carattere asterisco (*)

*Da utilizzare per includere o escludere interazioni di tutti i tipi. Utilizzare * solo per le espressioni di filtro che utilizzano il EVENT_TYPE campo di un Interactions set di dati.

Separatore di tubi

Utilizzate il pipe separator (|) per concatenare più espressioni. Per ulteriori informazioni, consulta Combinazione di più espressioni.

Parametri

Per le espressioni che utilizzano operatori di confronto o l'INoperatore, utilizzate il simbolo del dollaro ($) e il nome di un parametro per aggiungere un parametro segnaposto come valore. Ad esempio, $GENRES. In questo esempio, quando ricevi consigli, fornisci il genere o i generi in base ai quali filtrare.

Nota

Il nome di un parametro viene definito quando lo si aggiunge a un'espressione. Il nome del parametro non deve necessariamente corrispondere al nome del campo. Si consiglia di utilizzare un nome di parametro simile al nome del campo e facile da ricordare. Si utilizza il nome del parametro (con distinzione tra maiuscole e minuscole) quando si applica il filtro alle richieste di consigli. Per un esempio che mostra come applicare un filtro con parametri segnaposto quando si utilizza l' AWS SDKS, consulta. Applicazione di un filtro (AWS SDK)