> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modulo ricompense a livelli - impostazioni generali

> Configurazione delle impostazioni di design e funzionali del modulo Ricompense

Il modulo Ricompense è una funzionalità chiave di Upcart che mostra una barra di avanzamento visiva nel cart drawer, incoraggiando i clienti a spendere di più tenendo traccia dei loro progressi verso ricompense come spedizione gratuita, sconti o prodotti in omaggio.

Questa è la prima di tre guide che coprono le impostazioni delle Ricompense:

* **Impostazioni generali** (questo documento)
* **[Impostazioni delle ricompense](/it/upcart/tiered_rewards_module_rewards_settings)**
* **[Impostazioni avanzate](/it/upcart/tiered_rewards_module_advanced_settings)**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-progress-bar-free-shipping.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=3065be916fd829d905d4c2dc91755668" alt="Barra di avanzamento delle ricompense Upcart con icone di spedizione gratuita e traguardi prodotto" width="1134" height="354" data-path="images/upcart/tiered-rewards-general-progress-bar-free-shipping.png" />

⚠️ *Questo modulo è puramente visivo e non applica sconti né logiche di spedizione. Per rendere le ricompense funzionali, consulta il documento [Impostazioni delle ricompense](/it/upcart/tiered_rewards_module_rewards_settings).*

<div id="general-settings">
  # Impostazioni generali
</div>

<div id="show-rewards-on-empty-cart">
  ## Mostra le ricompense a carrello vuoto
</div>

Attiva questa opzione per mostrare la barra delle ricompense anche quando il carrello è vuoto.

<div id="colors">
  ## Colori
</div>

Personalizza l'aspetto visivo della barra:

* **Bar background color**: rappresenta ciò che resta da ottenere
* **Bar foreground color**: indica il progresso verso una ricompensa
* **Complete reward tier icon color**: le icone dei livelli che un cliente ha già sbloccato. **Solo Versione 2.**
* **Incomplete reward tier icon color**: le icone dei livelli ancora da sbloccare. **Solo Versione 2.**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-bar-preview-colors.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=61991e26fa74b74d0146ecb91b8bc1cd" alt="Anteprima della barra delle ricompense sopra i campi colore di sfondo e primo piano della barra" width="1136" height="646" data-path="images/upcart/tiered-rewards-general-bar-preview-colors.png" />

<div id="text-after-completing-full-rewards-bar">
  ## Testo dopo il completamento dell'intera barra delle ricompense
</div>

Aggiungi un messaggio personalizzato che appare una volta raggiunti tutti i livelli di ricompensa. Usa gli strumenti di formattazione (grassetto, corsivo, sottolineato, colore) per dare stile al messaggio secondo le tue esigenze.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-completion-message-editor-formatting.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=f09c117f9c5d93924d4f33162c37e3a2" alt="Editor del messaggio di completamento delle ricompense con barra degli strumenti di formattazione e testo di esempio sbloccato" width="1082" height="400" data-path="images/upcart/tiered-rewards-general-completion-message-editor-formatting.png" />

***

<div id="rewards-calculation">
  ## Calcolo delle ricompense
</div>

Questa è una scheda a sé, sotto **General settings**. Scegli come viene calcolato il progresso:

* **Cart total (\$)**\
  Tiene traccia in base al valore totale del carrello (es. ricompensa a \$100).
* **Cart quantity (#)**\
  Tiene traccia in base al numero di articoli (es. ricompensa a 5 articoli).

  * La base selezionata si applica all'intera barra delle ricompense e non può variare per livello.

<div id="use-pre-discounted-prices-for-cart-total">
  ## Usa i prezzi prima degli sconti per il totale del carrello
</div>

Nella stessa scheda **Rewards calculation**, mostrata solo quando la base è **Cart total (\$)**. Quando è attiva, le ricompense vengono calcolate usando il totale del carrello prima di qualsiasi sconto. Questo evita che i clienti perdano il diritto a una ricompensa a causa del proprio coupon. Consulta [Come escludere gli sconti dall'obiettivo della ricompensa](/it/upcart/how_to_exclude_discounts_in_reward_goal).

***

<div id="filter-which-products-count-toward-rewards">
  ## Filtra quali prodotti contano per le ricompense
</div>

Con i **Product Filters** puoi controllare quali articoli nel carrello sono idonei a contribuire al progresso verso le ricompense. Questo consente maggiore precisione e flessibilità nei casi d'uso, come escludere le carte regalo o mirare solo a specifici gruppi di prodotti.

<Note>
  Questi filtri richiedono il modulo Ricompense **Versione 2**. Nella Versione 1 la sezione dei filtri non appare affatto.
</Note>

Puoi applicare filtri per **prodotto**, **collezione**, **proprietà dell'articolo** o **stato di abbonamento**. Ogni filtro può essere impostato su **includi** (solo gli articoli selezionati contribuiscono) o **escludi** (tutto contribuisce tranne gli articoli selezionati). È possibile combinare più filtri per una logica a più livelli.

<div id="product-filter">
  ## **Filtro prodotto**
</div>

Questo filtro ti consente di includere o escludere singoli prodotti dalla barra delle ricompense.

* **Includi**: solo i prodotti selezionati conteranno per la ricompensa.
* **Escludi**: tutti i prodotti contano tranne quelli che hai escluso.

Usalo per isolare gli SKU ad alto margine, escludere articoli promozionali o rimuovere prodotti di basso valore come le carte regalo dal calcolo delle ricompense.

<div id="collection-filter">
  ## **Filtro collezione**
</div>

Questo filtro applica la stessa logica del filtro prodotto, ma a **livello di collezione**.

* Puoi includere un'intera collezione Shopify (es. "Holiday Collection") perché conti per le ricompense.
* Oppure escludere una collezione come "Sale Items" se non vuoi che i prodotti scontati contribuiscano.

Ottimo per un controllo in blocco senza dover selezionare i prodotti uno per uno.

<div id="item-property-filter">
  ## **Filtro proprietà dell'articolo**
</div>

Usa questo filtro per includere o escludere articoli in base alle **line item properties** — metadati spesso aggiunti da altre app, opzioni prodotto personalizzate o tagging interno.

* Aggiungi filtri usando **coppie chiave-valore** (es. `upsell: true`, `__upcartRecommendation: [ID]`)
* Puoi lasciare vuoto il campo valore per filtrare solo per chiave (es. escludere tutti gli articoli con la chiave `upsell`, indipendentemente dal valore)

È ideale per escludere articoli di upsell, abbonamenti, ordini personalizzati o qualsiasi cosa taggata dinamicamente tramite il tuo storefront o le tue automazioni.

<div id="subscription-status-filter">
  ## **Filtro stato di abbonamento**
</div>

Questo filtro ti consente di includere o escludere articoli a seconda che siano articoli in abbonamento o acquisti una tantum.

* **Articoli in abbonamento**: solo gli articoli con un piano di abbonamento attivo conteranno per la ricompensa
* **Articoli una tantum**: solo gli articoli acquistati una tantum (senza abbonamento) conteranno per la ricompensa

Usalo per creare ricompense specifiche per gli acquisti in abbonamento (es. "Aggiungi 3 articoli in abbonamento e ottieni la spedizione gratuita") o per escludere gli abbonamenti da determinati livelli di ricompensa.

***

<div id="advanced-settings">
  ## Impostazioni avanzate
</div>

Apre il menu delle impostazioni avanzate delle ricompense. Per funzionalità come le ricompense specifiche per valuta e le condizioni avanzate, consulta la guida **[Impostazioni avanzate](/it/upcart/tiered_rewards_module_advanced_settings)**.