> ## 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.

# Build a Box

> L'offerta post-acquisto Build a Box: gli acquirenti compongono una scatola personalizzata dai prodotti che selezioni, con sconti a volume che aumentano man mano che la scatola si riempie.

**Build a Box** è un tipo di offerta post-acquisto in cui l'acquirente compone la propria scatola da un set di prodotti che selezioni, e acquista l'intera selezione in un'unica transazione. Invece di accettare o rifiutare un singolo prodotto, sceglie cosa metterci e in che quantità, e uno sconto a volume può aumentare man mano che la scatola si riempie.

Si affianca alle offerte post-acquisto a prodotto singolo e multi-prodotto, e si combina con i consueti widget delle offerte, come l'intestazione e il timer.

<Note>
  Build a Box offre diversi prodotti. Per vendere più unità di un singolo prodotto a prezzi scaglionati, usa invece gli [Upsell a quantità](/it/aftersell/quantity-upsells).
</Note>

Per aggiungerne una, apri il funnel, seleziona **Add offer** e scegli **Build a box**.

<div id="setting-up-the-box">
  ## Configurare la scatola
</div>

<div id="choosing-candidate-products">
  ### Scegliere i prodotti candidati
</div>

La sezione **Product selection** controlla tra quali prodotti un acquirente può scegliere. Questi si chiamano *candidati*.

1. Apri l'offerta box nell'editor del funnel post-acquisto.
2. Espandi **Product selection**.
3. Seleziona **Add product** e scegli uno o più prodotti. I prodotti già presenti nell'elenco sono esclusi dal selettore.
4. Salva.

Una scatola supporta fino a **12 candidati**. Trascina la maniglia su una riga per riordinare — quello è l'ordine che vedono gli acquirenti. Usa l'icona di eliminazione per rimuoverne uno; non puoi rimuovere l'ultimo candidato rimasto, dato che una scatola ne richiede almeno uno.

<div id="box-size">
  ### Dimensione della scatola
</div>

**Box size** imposta quanti articoli l'acquirente deve scegliere:

| Impostazione                 | Cosa fa                                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| **Minimum items**            | Il minimo. Contato in articoli, quindi tre unità di un prodotto contano come tre.              |
| **Maximum items (optional)** | Lascia vuoto per nessun limite. Impostalo uguale al minimo per una scatola a dimensione fissa. |

Con una scatola a dimensione fissa, l'editor segnala che gli acquirenti devono scegliere esattamente quel numero di articoli e vedranno un contatore "0 of N selected".

<Warning>
  Se i tuoi candidati non possono collettivamente raggiungere il minimo, l'editor mostra un banner critico intitolato **"This box won't be shown to shoppers"**, indicando il numero massimo di articoli che i tuoi prodotti consentono e il minimo che hai impostato. L'offerta viene saltata del tutto al momento della pubblicazione.

  La soluzione suggerita dipende dalla causa:

  * **Un prodotto ha il selettore di quantità disattivato**, quindi può essere aggiunto una sola volta — riattivane uno, aggiungi altri prodotti o abbassa il minimo.
  * **Altrimenti** — abbassa il minimo, aggiungi altri prodotti o aumenta la quantità massima di un prodotto.
  * **Il massimo della scatola non ammette alcun articolo** — il banner lo dice espressamente e ti chiede di aumentarlo o lasciarlo vuoto.
</Warning>

<div id="discounts">
  ## Sconti
</div>

<div id="discount-tiers">
  ### Livelli di sconto
</div>

La sezione **Box discount** imposta uno sconto che cresce con il numero di articoli nella scatola. Aggiungi un livello con **Add tier**, poi imposta **Minimum items for tier N** e **Discount for tier N**.

Come viene scelta la percentuale:

* L'acquirente ottiene la percentuale **più alta** per cui la sua scatola si qualifica, non semplicemente l'ultima soglia superata. Se configuri 3+ articoli al 30% e 6+ articoli al 20%, un acquirente con 6 articoli ottiene comunque il 30%.
* La percentuale viene valutata sul **conteggio articoli in tempo reale**, non sul minimo della scatola. Una tile si apre a prezzo pieno e si riprezza man mano che la scatola si riempie, quindi la percentuale mostrata all'acquirente è sempre quella che la sua selezione corrente effettivamente merita.
* Una tabella di livelli vuota è valida e significa che la scatola viene venduta a prezzo pieno.

Non c'è un tetto di sconto a livello di scatola — la tabella dei livelli è l'unica cosa che imposta la percentuale.

L'editor mostra avvisi per le configurazioni di livelli che sembrano non intenzionali. Due di esse bloccano il salvataggio; la terza è solo informativa:

| Avviso                                                                                     | Quando appare                                                                                                              | Blocca il salvataggio? |
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| Un livello sconta meno di un livello più piccolo, quindi non si applica mai                | Un livello con un minimo strettamente maggiore ha una percentuale di sconto inferiore a quella di un livello sotto di esso | Sì                     |
| Un livello è sotto il minimo della scatola, quindi ogni scatola acquistabile lo merita già | Il minimo di un livello è sotto il minimo della scatola                                                                    | No                     |
| Due livelli iniziano entrambi allo stesso numero di articoli                               | Minimi di livello duplicati                                                                                                | No                     |

Anche il massimo della scatola deve essere uguale o superiore al minimo. Impostare un massimo inferiore al minimo blocca il salvataggio.

<div id="per-product-discounts">
  ### Sconti per prodotto
</div>

Un candidato può avere un proprio sconto invece di seguire la percentuale della scatola. Apri il candidato, vai su **Discount** e spunta **Give this product its own discount**.

* L'override si applica sulla tile di quel prodotto e nel totale della scatola, al posto della percentuale del livello.
* `0` è un override valido — mantiene un prodotto a prezzo pieno dentro una scatola altrimenti scontata.
* Lascia l'override disattivato per seguire lo sconto della scatola.

<div id="editing-several-products-at-once">
  ### Modificare più prodotti contemporaneamente
</div>

**Edit all products** apre un pannello di modifica in blocco. Deseleziona i candidati che vuoi escludere dalla modifica.

Dove i prodotti selezionati differiscono, un campo mostra **Mixed** — modificarlo scrive il tuo valore su tutti, mentre lasciarlo intatto preserva il valore di ciascun prodotto. L'interruttore di override mostra uno stato indeterminato quando solo alcuni hanno override.

<div id="per-product-settings">
  ## Impostazioni per prodotto
</div>

Ogni candidato ha il proprio pannello, che copre **Badge**, **Product image badge**, **Image**, **Product details** (incluse le valutazioni delle recensioni, con i colori delle stelle predefiniti `#fdcc0d` e `#d1d5db`), **Variant options**, **Box limits**, **Discount** e **Already purchased**.

L'aspetto delle schede non si imposta per singolo candidato. Deriva dall'impostazione [**Layout**](#layout) a livello di offerta, quindi tutte le schede di una scatola hanno la stessa forma.

Due impostazioni sotto **Box limits** meritano attenzione:

* **Show quantity selector** — attiva per impostazione predefinita. Disattivala così ogni aggiunta inserisce esattamente un'unità, senza selettore di quantità per tile.
* **Maximum quantity in a box** — lascia vuoto per nessun limite, o impostalo a 1 per mantenere varia una scatola assortita.

La sezione **Already purchased** controlla cosa succede quando un acquirente ha già questo prodotto — acquistato nell'ordine corrente o accettato in un passaggio precedente del funnel. La corrispondenza avviene per ID prodotto, quindi anche una variante diversa di un prodotto acquistato conta. Scegli uno dei tre trattamenti:

| Opzione                        | Cosa fa                                                                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Show normally**              | Il prodotto appare nella scatola senza trattamento speciale (predefinito).                                                                                                     |
| **Show a "Your choice" badge** | Il prodotto resta nella scatola e un badge a pillola lo contrassegna come già posseduto dall'acquirente.                                                                       |
| **Hide the product**           | Il prodotto viene eliminato del tutto dalla scatola. Non disponibile per i candidati più/meno costosi, che vengono risolti dall'ordine dopo la lettura di questa impostazione. |

Quando è selezionato **Show a "Your choice" badge**, appaiono tre impostazioni aggiuntive:

* **Badge text** — il testo sul badge. Lascia vuoto per usare la traduzione del tuo negozio (impostata in **Settings > Translations** sotto **Already purchased badge**). Il predefinito è "Your choice".
* **Badge color** — il colore di riempimento della pillola del badge (hex, predefinito `#008060`).
* **Badge text color** — il colore del testo dentro la pillola del badge (hex, predefinito `#ffffff`).

Il badge è visibile nell'anteprima dell'editor del funnel, così puoi vedere come appare prima di pubblicare.

<div id="layout">
  ## Layout
</div>

**Layout**, nelle impostazioni di layout della scatola, definisce la forma delle schede e quante schede condividono una riga:

| Layout            | Come appare                                                                                    |
| ----------------- | ---------------------------------------------------------------------------------------------- |
| **Classic**       | Immagine accanto al testo, due prodotti per riga.                                              |
| **Compact grid**  | Immagine sopra il testo, tre per riga, uno per riga su telefono.                               |
| **Spotlight**     | Il primo prodotto apre a metà larghezza, gli altri seguono nella griglia compatta.             |
| **Split columns** | Prodotti a sinistra, con il totale e il pulsante di acquisto in una colonna a sé sulla destra. |

La stessa sezione imposta la spaziatura interna attorno alla scatola.

<div id="progress">
  ## Avanzamento
</div>

**Box progress** controlla l'indicatore di riempimento:

| Impostazione             | Opzioni                                                     | Predefinito      |
| ------------------------ | ----------------------------------------------------------- | ---------------- |
| **Position**             | Sopra i prodotti / Sopra il pulsante di acquisto / Entrambi | Sopra i prodotti |
| **Show progress bar**    | On / off                                                    | On               |
| **Bar color**            | Hex                                                         | `#008060`        |
| **Bar position**         | Sopra il testo / sotto il testo                             | Sopra il testo   |
| **Top / bottom padding** | 0–10, a passi di 2                                          | 0                |

Non esiste una posizione "nascosta". Per eliminare del tutto la riga di avanzamento, svuota il campo del testo di avanzamento.

<div id="progress-text-variables">
  ### Variabili del testo di avanzamento
</div>

Digita `{` in uno qualsiasi dei tre editor dei [testi di avanzamento](#progress-wording) per inserire una variabile.

| Variabile                                             | Cosa mostra                                                                                                                                                                                                                         |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{box-progress}`                                      | L'intera frase di avanzamento predefinita. Cambia struttura tra gli stati della scatola, cosa che nessuna singola frase scritta a mano può fare — vedi [Testi di avanzamento](#progress-wording) per riformulare invece ogni stato. |
| `{items-in-box}`                                      | Quanti articoli ci sono attualmente nella scatola.                                                                                                                                                                                  |
| `{items-to-go}`                                       | Il conteggio grezzo rimanente fino al minimo.                                                                                                                                                                                       |
| `{box-minimum}`                                       | Il minimo della scatola.                                                                                                                                                                                                            |
| `{box-maximum}`                                       | Il massimo della scatola.                                                                                                                                                                                                           |
| `{current-discount}`                                  | La percentuale attualmente in vigore.                                                                                                                                                                                               |
| `{next-discount}`                                     | La percentuale sbloccata aggiungendo altri articoli. Vuota al livello più alto.                                                                                                                                                     |
| `{items-to-next-discount}`                            | Quanti articoli in più servono per raggiungerla. Vuota al livello più alto.                                                                                                                                                         |
| `{subtotal}` / `{total}` / `{discount}` / `{savings}` | I prezzi della scatola, sommati sull'intera selezione. Vuoti finché un prezzo non si risolve.                                                                                                                                       |
| `{first-name}`                                        | Il nome dell'acquirente.                                                                                                                                                                                                            |
| `{timer}` / `{timer-end}`                             | Il conto alla rovescia dell'offerta.                                                                                                                                                                                                |

Le variabili di intestazione dei passaggi disponibili sulle offerte multi-prodotto non hanno un equivalente per la scatola e non sono offerte qui.

<div id="progress-wording">
  ### Testi di avanzamento
</div>

**Progress wording** è composto da tre editor di testo formattato, uno per ogni fase del riempimento della scatola. Digita `{` in uno qualsiasi di essi per inserire una [variabile](#progress-text-variables). Svuota un campo per nascondere la riga di avanzamento in quello stato.

| Editor                               | Quando appare la sua riga                                                                                                                                                        |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Before the minimum items reached** | Finché la scatola non raggiunge il suo minimo. L'acquirente non può ancora completare l'acquisto, quindi questa riga è l'unica cosa che spiega perché il pulsante è disattivato. |
| **Between minimum and maximum**      | Una volta superato il minimo della scatola, mentre uno sconto più alto o il massimo sono ancora da raggiungere.                                                                  |
| **Maximum items hit**                | Quando la scatola ha ottenuto tutto ciò che può: il massimo, oppure lo sconto più alto in una scatola senza massimo.                                                             |

L'editor mostra solo i campi che la tua scatola può effettivamente raggiungere:

* **Before the minimum items reached** appare solo quando la scatola ha un minimo maggiore di zero.
* **Between minimum and maximum** appare solo quando la scatola ha un massimo o almeno un livello di sconto. Senza nessuno dei due, superare il minimo è già lo stato finale.
* **Maximum items hit** appare sempre. Ogni scatola lo raggiunge.

Poiché sono editor di testo formattato, puoi mettere in grassetto, colorare e ridimensionare il testo, non solo cambiarne le parole.

Cambiare la **Language** della scatola ritraduce qualsiasi testo che non hai modificato. Una volta modificato un campo, viene lasciato esattamente come l'hai scritto.

<div id="tile-button-text">
  ## Testo dei pulsanti delle tile
</div>

La sezione **Tile button text** nel pannello Buttons ti permette di personalizzare il testo dei pulsanti Add e Remove che appaiono su ogni tile candidata, solo per questo funnel.

* **Add button text** — l'etichetta mostrata su una tile prima che l'acquirente aggiunga il prodotto alla sua scatola. Predefinito "Add to box".
* **Remove button text** — l'etichetta mostrata su una tile dopo che l'acquirente ha aggiunto il prodotto. Predefinito "Remove".

Lascia uno dei due campi vuoto per usare la traduzione del tuo negozio dalla pagina Translations. Se anche la traduzione del negozio è vuota, viene usato il predefinito inglese.

L'etichetta dello stato non disponibile ("Unavailable") non è influenzata da queste impostazioni.

Per impostare valori predefiniti a livello di negozio per queste etichette invece di un override per funnel, vai su **Translations** nell'admin di Aftersell e aggiorna le voci **Add to box** e **Remove from box**.

<div id="shipping">
  ## Spedizione
</div>

La sezione **Shipping** definisce quanto la scatola addebita per la consegna. La scatola viene spedita gratuitamente oppure aggiunge un costo di spedizione. Se applichi un costo, imposti l'importo e scegli se moltiplicarlo per il numero di articoli nella scatola, così una scatola da sei articoli può costare sei volte una tariffa unitaria oppure un'unica tariffa fissa.

<div id="language-and-order-tagging">
  ## Lingua e tag degli ordini
</div>

* **Language** imposta la lingua usata per i testi e i pulsanti della scatola, e per le traduzioni dei dettagli prodotto.
* **Order tag** applica un tag Shopify a ogni ordine che accetta la scatola. Usalo per instradare l'evasione o per isolare gli ordini delle scatole nei report.

<div id="limitations">
  ## Limitazioni
</div>

* **Un solo pulsante di accettazione condiviso.** La scatola ha un'unica call to action anziché pulsanti per prodotto, perché Shopify limita quante accettazioni una pagina post-acquisto può effettuare.
* **Nessuna offerta sostitutiva.** Una scatola non può essere usata come upsell sostitutivo.
* **Il dettaglio dei prezzi non si comprime.** **Show price breakdown**, sotto **General settings**, lo attiva o disattiva. Quando è attivo è sempre espanso — l'offerta multi-prodotto mette invece il suo dettaglio dietro un link "Show price breakdown".

<div id="subscription-only-products">
  ### Prodotti solo in abbonamento
</div>

I prodotti configurati per essere venduti solo in abbonamento (`requiresSellingPlan: true` in Shopify — nessuna opzione di acquisto una tantum) non possono essere inclusi in un'offerta build-a-box. Ogni articolo in una scatola viene addebitato come acquisto una tantum sull'ordine, quindi Shopify rifiuta i prodotti solo in abbonamento al momento della pubblicazione. Questi candidati vengono eliminati silenziosamente su ogni ordine reale, anche se l'anteprima dell'editor del funnel continua a mostrarli.

L'editor del funnel ti avvisa quando questa situazione viene rilevata:

* **Banner di avviso** — alcuni candidati sono solo in abbonamento ma restano abbastanza candidati non in abbonamento per raggiungere il minimo della scatola. Il banner elenca i prodotti interessati per nome. L'offerta viene comunque mostrata agli acquirenti, ma con meno prodotti di quelli configurati.
* **Banner critico** — tutti i candidati sono solo in abbonamento, o i candidati non in abbonamento rimanenti non possono raggiungere il minimo della scatola. L'offerta viene saltata del tutto per ogni acquirente.

**Se vedi il banner di avviso**, la scatola funziona comunque — semplicemente serve meno prodotti di quelli che hai configurato. Aggiungi altri candidati acquistabili anche una tantum, così la scatola offre l'assortimento che intendevi.

**Se vedi il banner critico**, l'offerta non verrà eseguita affatto finché non lo risolvi. Una qualsiasi di queste azioni lo elimina:

* Aggiungi candidati acquistabili anche una tantum.
* Abbassa il minimo della scatola, così i candidati rimanenti bastano a raggiungerlo.
* Disattiva "solo abbonamento" sui prodotti interessati in Shopify, se devono essere venduti anche come acquisto una tantum.

Puoi anche rimuovere del tutto i candidati solo in abbonamento dalla scatola. Questo non cambia nulla per gli acquirenti — vengono già eliminati su ogni ordine reale — ma silenzia il banner e fa sì che l'anteprima dell'editor corrisponda a ciò che viene effettivamente servito.

I prodotti con abbonamento **abilitato** (quelli che offrono sia l'acquisto una tantum sia l'abbonamento) non vengono eliminati da una scatola. Vengono semplicemente venduti come acquisto una tantum, come ogni altro articolo della scatola — una scatola non porta mai un selling plan.
