Filters

Interfaccia dei filtri #

I filtri possono essere utilizzati per ciascun Contenuto per restringere i risultati in base agli attributi del prodotto.

Troverai questa opzione in ogni Contenuto che crei per Recommendations, Search o Email, sotto Content type > Product filters.

Ogni parte del filtro è composta da quanto segue:

• Un attributo su cui filtrare
• Un confronto che decide come l’attributo deve essere confrontato con il valore
• Un valore che decide con cosa deve essere confrontato l’attributo

Puoi creare filtri basati su qualsiasi attributo dei prodotti che invii a Clerk. Gli operatori di confronto disponibili dipendono dal tipo di attributo su cui filtri.

Ad esempio, price contiene un numero, il che significa che puoi utilizzare confronti sia maggiore di, minore di e altri confronti numerici, mentre attributi di testo/stringa come name consentono solo confronti booleani come è o non è.

Durante la creazione dei filtri, l’interfaccia mostrerà quanti prodotti corrispondono al filtro e la stringa di filtro generata.

Filtri Semplici #

Questi contengono solo un singolo attributo e un confronto. Un esempio è mostrare solo prodotti sotto €400:

Set di Filtri #

Questi ti permettono di restringere la selezione dei prodotti aggiungendo più filtri all’interno dello stesso set. Puoi farlo cliccando sull’icona "+" all’interno di un filtro esistente e aggiungendone uno nuovo.

All’interno di un set, puoi scegliere tra due logiche di filtro:

• AND mostra solo i prodotti che corrispondono a tutti i filtri del set.
• OR mostra i prodotti che corrispondono ad almeno uno dei filtri del set.

Esempio: Vuoi mostrare solo prodotti che costano meno di €400 e sono anche in promozione.

Combinare i Set #

Puoi combinare set di filtri permettendo loro di funzionare insieme in base a condizioni diverse. Invece di aggiungere filtri all’interno di un set esistente, clicca su "+ Add filter" per iniziarne uno nuovo.

Ogni set di filtri funziona separatamente, e puoi scegliere come interagiscono tra loro:

• AND mostra solo i prodotti che corrispondono a tutti i set.
• OR mostra prodotti che corrispondono ad almeno uno dei set.

Esempio: Vuoi mostrare prodotti che siano sotto €400 E in promozione, ma anche provenienti da Vendor A O da una categoria specifica.

• Il primo set assicura che i prodotti soddisfino le condizioni di prezzo e promozione.
• Il secondo set consente flessibilità includendo prodotti da un determinato venditore o categoria.

Stringa di filtro #

L’Interfaccia dei Filtri crea automaticamente la corretta sintassi in base ai dati disponibili nei tuoi attributi. Ad esempio, se i tuoi SKU sono formattati come stringhe tipo “GT-1234”, le virgolette vengono aggiunte automaticamente alla stringa di filtro.

sku = "GT-1234"

Se un attributo è un numero, viene aggiunto senza virgolette.

price < 300

Se riscontri problemi con il filtraggio, controlla la stringa di filtro per assicurarti che venga utilizzata la sintassi corretta ed effettua le modifiche necessarie.

In caso di dubbi, puoi vedere che tipo di dato ha un dato attributo (stringa, numero, lista, booleano) andando su Data > Products e consultando qualsiasi prodotto.

Puoi sempre regolare manualmente la stringa di filtro secondo le tue esigenze cliccando l’icona matita accanto a Filter expression.

Valori Dinamici degli Attributi #

Quando crei filtri per le campagne di Merchandising o per il Contenuto che utilizza logiche basate sui prodotti, puoi utilizzare gli attributi del prodotto visualizzato come valori dinamici scrivendo {{ attribute_name }}.

Al momento della valutazione, il segnaposto viene sostituito con il valore reale del prodotto visualizzato. Ad esempio, un filtro come type = {{ type }} assicura che i risultati includano solo prodotti con lo stesso type di quello che il visitatore sta visualizzando.

Questo è particolarmente utile quando vuoi che i filtri si adattino automaticamente senza inserire a mano valori specifici. Puoi combinare valori dinamici con altri filtri, ad esempio type = {{ type }} insieme a price < 500 per mostrare solo prodotti dello stesso tipo sotto i €500.

I valori dinamici degli attributi funzionano solo quando la richiesta include uno o più product ID, come Best Cross-Sell e Best Alternatives in Recommendations.

Filtraggio Dinamico #

I filtri possono essere aggiunti direttamente ai codici di integrazione usando l’attributo data-filter. Questo permette di rendere i filtri dinamici modificando i valori in base alla logica frontend.

Di seguito alcuni esempi comuni su come usare il filtraggio dinamico.

Soglia per la Spedizione Gratuita #

Definisci una variabile, ad esempio $free_shipping_limit, che contenga l’importo rimanente necessario al cliente per raggiungere la soglia della spedizione gratuita. Usa questa variabile come filtro dinamico per mostrare solo i prodotti al di sopra di questa soglia di prezzo:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Corrispondenza del Genere #

Se i tuoi prodotti hanno un attributo come gender che contiene i valori female, male, kids, unisex e così via, puoi forzare gli elementi Clerk a mostrare prodotti per lo stesso genere.

Definisci una variabile, ad esempio $product_gender, che contiene il genere del prodotto attualmente visualizzato e usala per mostrare prodotti dello stesso genere:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Categoria Specifica #

In questo caso, ti serve una lista nel tuo store contenente le categorie dei prodotti, che potrebbero essere definite come $available_categories = [1,2,3,4,5]. Usala per filtrare gli slider e mostrare solo prodotti all’interno di quelle categorie:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>