

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de expresiones de filtro
<a name="filter-expression-examples"></a>

 Use las expresiones de filtro de las siguientes secciones para aprender a crear sus propias expresiones de filtro. 

**Topics**
+ [Ejemplos de expresiones de filtro de recomendaciones de elementos](item-recommendation-filter-examples.md)
+ [Expresiones de filtro de segmentos de usuarios](user-segment-filter-examples.md)
+ [Ejemplos de expresiones de filtro de recomendaciones de acciones](action-recommendation-filter-examples.md)
+ [Combinación de varias expresiones](multiple-expression-example.md)

# Ejemplos de expresiones de filtro de recomendaciones de elementos
<a name="item-recommendation-filter-examples"></a>

Las siguientes expresiones de filtro muestran cómo filtrar las recomendaciones de elementos en función de las interacciones y los metadatos de los elementos, así como los metadatos de usuarios. Están organizados por tipo de datos.

**Topics**
+ [Datos de interacciones de elementos](#item-interaction-filter-examples)
+ [Datos de elementos](#item-filter-examples)
+ [Datos de usuario](#user-filter-examples)

## Datos de interacciones de elementos
<a name="item-interaction-filter-examples"></a>

La siguiente expresión excluye elementos en función de un tipo de evento (como hacer clic) o de los tipos de eventos que se especifican al recibir recomendaciones mediante el parámetro `$EVENT_TYPE`.

```
EXCLUDE ItemID WHERE Interactions.EVENT_TYPE IN ($EVENT_TYPE)
```

 La siguiente expresión excluye los elementos en los que un usuario ha hecho clic o ha transmitido en streaming.

```
EXCLUDE ItemID WHERE Interactions.EVENT_TYPE IN ("click", "stream")
```

La siguiente expresión solo incluye los elementos en los que el usuario ha hecho clic.

```
INCLUDE ItemID WHERE Interactions.EVENT_TYPE IN ("click")
```

## Datos de elementos
<a name="item-filter-examples"></a>

La siguiente expresión excluye los elementos en función de una o varias categorías que especifique al obtener recomendaciones mediante el parámetro `$CATEGORY`.

```
EXCLUDE ItemID WHERE Items.CATEGORY IN ($CATEGORY)
```

La siguiente expresión incluye solo los elementos que son más baratos que el elemento actual (el elemento que especifica en la solicitud para recomendaciones de elementos relacionados) y que se han creado por el mismo estudio que el elemento actual. Puedes aplicar un filtro con el CurrentItem elemento solo si el caso de uso de tu dominio o tu receta personalizada generan recomendaciones de artículos relacionados.

```
INCLUDE ItemID WHERE Items.PRICE < CurrentItem.PRICE AND Items.GENRE IN CurrentItem.GENRE
```

 La siguiente expresión excluye elementos basados en varios niveles de campos categóricos. Excluye los elementos con un valor de CATEGORY\$1L1 `shoe` que *no* tienen un valor de CATEGORY\$1L2 de `boot`. 

```
EXCLUDE ItemID WHERE Items.CATEGORY_L1 IN ("shoe") AND Items.CATEGORY_L2 NOT IN ("boot")
```

La siguiente expresión incluye solo los elementos con un precio inferior o igual que el precio que especifica al recibir recomendaciones mediante el parámetro `$PRICE`.

```
INCLUDE ItemID WHERE Items.PRICE <= $PRICE
```

La siguiente expresión solo incluye elementos que se han creado antes de una marca de tiempo (en tiempo Unix) que especifica al recibir recomendaciones.

```
INCLUDE ItemID WHERE Items.CREATION_TIMESTAMP < $DATE
```

La siguiente expresión solo incluye elementos con un género o géneros que especifica al recibir recomendaciones con el parámetro `$GENRE`.

```
INCLUDE ItemID WHERE Items.GENRE IN ($GENRE)
```

La siguiente expresión solo incluye elementos que son más caros que el elemento actual *y* que se han creado más recientemente que la marca temporal (en tiempo Unix) que especifique. Puede utilizar este filtro si recibe recomendaciones de elementos relacionados y desea aplicar algunas reglas empresariales específicas basadas en el precio y en una fecha de creación variable.

```
INCLUDE ItemID WHERE Items.PRICE < CurrentItem.PRICE AND Items.CREATION_TIMESTAMP > $DATE
```

## Datos de usuario
<a name="user-filter-examples"></a>

La siguiente expresión excluye los elementos de un género o géneros que especifique al recibir recomendaciones mediante el parámetro `$GENRE`, pero solo si la edad del usuario actual es igual al valor que especifique al obtener recomendaciones mediante el parámetro `$AGE`. 

```
EXCLUDE ItemID WHERE Items.GENRE IN ($GENRE) IF CurrentUser.AGE = $AGE
```

La siguiente expresión solo incluye elementos con `watch` para CATEGORY\$1L1 y `luxury` para CATEGORY\$1L2, si la edad del usuario actual es mayor que `18`.

```
INCLUDE ItemID WHERE Items.CATEGORY_L1 IN ("watch") AND Items.CATEGORY_L2 IN ("luxury") IF CurrentUser.AGE > 18
```

# Expresiones de filtro de segmentos de usuarios
<a name="user-segment-filter-examples"></a>

Las siguientes expresiones de filtro muestran cómo filtrar los segmentos de usuarios en función de los datos de interacciones de elementos y los metadatos de usuarios. Están organizados por tipo de datos.

 **Datos de usuario** 

La siguiente expresión de filtro incluye solo los usuarios con un estado de pertenencia igual al valor que especifique al obtener los segmentos de usuarios.

```
INCLUDE UserID WHERE Users.MEMBERSHIP_STATUS IN ($MEMBERSHIP)
```

La siguiente expresión de filtro excluye a los usuarios con un valor `AGE` inferior al que especifique al obtener segmentos de usuarios.

```
EXCLUDE UserID WHERE Users.AGE < $AGE
```

 **Datos de interacciones de elementos** 

La siguiente expresión de filtro solo incluye a los usuarios que han hecho clic en los elementos o los han valorado.

```
INCLUDE UserID WHERE Interactions.EVENT_TYPE IN ("click", "rating")
```

La siguiente expresión de filtro excluye usuarios de los segmentos de usuarios que tienen interacciones de elementos con un tipo de evento que especifique al obtener segmentos de usuarios.

```
EXCLUDE UserID WHERE Interactions.EVENT_TYPE IN ($EVENT_TYPE)
```

# Ejemplos de expresiones de filtro de recomendaciones de acciones
<a name="action-recommendation-filter-examples"></a>

Los siguientes ejemplos de expresiones de filtro muestran cómo filtrar las acciones en función de los datos de interacciones de las acciones, los datos de las acciones y los datos de los usuarios. Están organizados por tipo de datos.

**Topics**
+ [Datos de interacciones de acción](#action-interaction-filter-examples)
+ [Datos de acciones](#action-filter-examples)
+ [Datos de usuario](#user-action-filter-examples)

## Datos de interacciones de acción
<a name="action-interaction-filter-examples"></a>

La siguiente expresión de filtro incluye solo las acciones de las recomendaciones con las que el usuario ha interactuado, cuando estas interacciones tengan un tipo de evento que especifique al recibir recomendaciones. 

```
INCLUDE ActionID WHERE Action_Interactions.EVENT_TYPE IN ($EVENT_TYPE)
```

La siguiente expresión de filtro excluye las acciones que el usuario no haya realizado en función del tipo de evento.

```
EXCLUDE ActionID WHERE Action_Interactions.EVENT_TYPE IN ("NOT_TAKEN")
```

## Datos de acciones
<a name="action-filter-examples"></a>

La siguiente expresión excluye acciones en función de una o varias categorías que especifique al obtener recomendaciones mediante el parámetro `$CATEGORY`.

```
EXCLUDE ActionID WHERE Actions.CATEGORY IN ($CATEGORY)
```

La siguiente expresión solo incluye las acciones con un valor superior al que se especifica al recibir recomendaciones.

```
INCLUDE ActionID WHERE Actions.VALUE > ($VALUE)
```

## Datos de usuario
<a name="user-action-filter-examples"></a>

La siguiente expresión solo incluye acciones de los miembros premium si el usuario actual tiene una suscripción premium. 

```
INCLUDE ActionID WHERE Action.MEMBERSHIP_LEVEL IN ("Premium") IF CurrentUser.MEMBERSHIP = $PREMIUM
```

La siguiente expresión excluye acciones con un valor `VALUE` inferior al que especifica al recibir recomendaciones si el usuario actual es un miembro premium.

```
EXCLUDE ActionID WHERE Actions.VALUE < ($VALUE) IF CurrentUser.MEMBERSHIP = $PREMIUM
```

# Combinación de varias expresiones
<a name="multiple-expression-example"></a>

Para combinar varias expresiones juntas, utilice un separador vertical (`|`). Use una combinación de expresiones cuando quiera usar un solo filtro y filtrar los conjuntos de datos de elementos y de interacciones de elementos, o bien los conjuntos de datos de acciones e interacciones de acción. Cada expresión se evalúa primero de manera independiente y el resultado es la unión o la intersección de los dos resultados. Los siguientes ejemplos muestran cómo crear expresiones para conjuntos de datos de elementos y de interacciones de elementos, si bien se aplican las mismas reglas al trabajar con acciones e interacciones de acción. 

**Ejemplo de expresiones coincidentes**

 Si ambas expresiones utilizan `EXCLUDE` o `INCLUDE`, el resultado es la unión de los dos resultados de la siguiente manera (A y B son expresiones diferentes): 
+ `Exclude A | Exclude B` es igual a `Exclude result from A or result from B`
+ `Include A | Include B` es igual a `Include result from A or result from B`

En el ejemplo siguiente se muestra cómo utilizar dos expresiones que usan `INCLUDE`. La primera expresión solo incluye los elementos con una o varias categorías que especifica al obtener recomendaciones mediante el parámetro `$CATEGORY`. La segunda expresión incluye los elementos que el usuario ha marcado como `favorite`. Las recomendaciones solo incluirán los elementos con la categoría que especifique, junto con los elementos que el usuario haya marcado como favoritos.

```
INCLUDE ItemID WHERE Items.CATEGORY IN ($CATEGORY) | INCLUDE ItemID WHERE Interactions.EVENT_TYPE IN ("favorite")
```

**Ejemplo de INCLUDE y EXCLUDE**

 Si una o más expresiones utilizan `INCLUDE` y una expresión utiliza `EXCLUDE`, el resultado es la resta del resultado de la expresión `EXCLUDE` del resultado de la expresión `INCLUDE` de la siguiente manera (A, B, C y D son expresiones diferentes).
+ `Include A | Exclude B` es igual a `Include result from A - result from B`
+  `Include A | Include B | Exclude C | Exclude D` es igual a `Include (A or B) - (C or D)` 

El orden de las expresiones no importa: si la expresión EXCLUDE se encuentra antes que la expresión INCLUDE, el resultado es el mismo.

El siguiente ejemplo muestra cómo combinar una expresión `INCLUDE` y una expresión `EXCLUDE`. La primera expresión incluye solo los elementos de un género o géneros que especifica al recibir recomendaciones mediante el parámetro `$GENRE`. La segunda expresión excluye los elementos en los que el usuario ha hecho clic o ha transmitido en streaming. Las recomendaciones incluirán solo los elementos con un género que especifique y que no hayan recibido clics ni se hayan reproducido en streaming.

```
INCLUDE ItemID WHERE Items.GENRE IN ($GENRE) | EXCLUDE ItemID WHERE Interactions.EVENT_TYPE IN ("click", "stream")
```