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

# Perché il mio upsell del checkout non viene visualizzato?

> Un'analisi completa di tutti i motivi per cui il tuo upsell del checkout potrebbe non essere visualizzato, inclusi problemi di configurazione, posizionamento, trigger e prodotto/offerta.

Gli upsell del checkout possono non essere visualizzati per diversi motivi. Segui i passaggi qui sotto in ordine per identificare la causa.

<Note>
  Gli upsell del checkout sono disponibili solo per i merchant Shopify Plus, perché l'API Checkout Extensibility di Shopify è riservata a Plus. Se non sei su Shopify Plus, gli upsell del checkout non appariranno indipendentemente dalla tua configurazione. Vedi [Perché non vedo la scheda checkout?](/it/aftersell/why_cant_i_see_the_checkout_tab)
</Note>

<Tip>
  Se un upsell non viene visualizzato, l'esperienza di checkout del cliente non ne risente — nulla si rompe dal lato del cliente.
</Tip>

***

<div id="where-to-start">
  ## Da dove iniziare
</div>

La maggior parte dei problemi di visualizzazione dipende da una di queste quattro cose: il widget non è attivo, il blocco app non è stato aggiunto/salvato in Shopify, il posizionamento non corrisponde o le condizioni di trigger non sono soddisfatte. Verifica prima le basi:

* Sei su un piano **Shopify Plus**
* Il widget è **attivo** nell'editor Checkout di Aftersell (l'interruttore **Enable** in alto a destra nelle impostazioni del widget è acceso)
* Il blocco app è stato **aggiunto e salvato** nello Shopify Checkout Editor
* Il posizionamento selezionato in Shopify **corrisponde** a quello impostato in Aftersell

Se tutto questo è a posto e l'upsell continua a non apparire, esamina le cause dettagliate qui sotto.

* [Il widget non è attivo o non è stato aggiunto al checkout](#widget-is-not-enabled-or-not-added-to-checkout)
* [Posizionamento non corrispondente tra Aftersell e Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Le condizioni di trigger non sono soddisfatte](#trigger-conditions-are-not-being-met)
* [C'è un problema con il prodotto o con l'offerta](#there-is-a-product-or-offer-issue)
* [I widget di Shop Pay non appaiono](#shop-pay-widgets-not-showing)
* [Test nell'anteprima di Shopify](#testing-in-the-shopify-preview)
* [Nessuno dei casi precedenti si applica](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## Il widget non è attivo o non è stato aggiunto al checkout
</div>

Perché un upsell del checkout venga visualizzato, devono essere vere due condizioni contemporaneamente:

1. Il widget deve essere **attivo** nell'editor Checkout di Aftersell
2. Il blocco app deve essere **aggiunto e salvato** nello Shopify Checkout Editor

Se manca una delle due, il widget non apparirà.

**Per attivare il widget in Aftersell:**

1. Vai su **Apps → Aftersell → Checkout**
2. Apri il widget di upsell che vuoi mostrare
3. Verifica che il widget sia acceso — l'intestazione mostra un interruttore accanto a un badge **Active** / **Inactive**. (Nella versione precedente dell'editor Checkout si tratta di una coppia di pulsanti **Enable** / **Disable** nell'intestazione della scheda del widget.)

**Per aggiungere il blocco app in Shopify:**

1. Vai su **Settings → Checkout** nel tuo Shopify Admin
2. Clicca **Customize** accanto al tuo profilo di checkout
3. Clicca **Add app block** e seleziona il widget di upsell di Aftersell
4. Posizionalo dove vuoi che appaia
5. Clicca **Save** — le modifiche non vengono applicate finché non salvi

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## Posizionamento non corrispondente tra Aftersell e Shopify
</div>

Un posizionamento non corrispondente è uno dei motivi più comuni per cui un upsell del checkout non viene visualizzato.

Aftersell supporta più posizionamenti, così puoi eseguire più di un widget dello stesso tipo sulla stessa pagina di checkout. Ogni posizionamento corrisponde a un **blocco app separato** nello Shopify Checkout Editor, e il posizionamento selezionato in Shopify deve corrispondere a quello configurato in Aftersell.

Il menu a tendina **Placement** del blocco app Upsell Widget offre otto valori: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)** e cinque slot di widget di pagina da **page-upsell-001** a **page-upsell-005**.

Se i posizionamenti non corrispondono, il widget non apparirà o potrebbe essere visualizzato nella posizione sbagliata.

**Per correggere un posizionamento non corrispondente:**

1. Nell'editor Checkout di Aftersell, apri il widget di upsell e annota quale posizionamento è selezionato (ad esempio, **Additional placement 1**)
2. Nello Shopify Checkout Editor, rimuovi il blocco app esistente per questo widget
3. Clicca **Add app block**, seleziona il widget di upsell di Aftersell e scegli lo **stesso posizionamento** configurato in Aftersell
4. Salva le modifiche

[Scopri di più su come far corrispondere i posizionamenti →](/it/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## Le condizioni di trigger non sono soddisfatte
</div>

Se il tuo widget di upsell ha dei trigger configurati, verrà visualizzato solo quando quelle condizioni sono soddisfatte dal carrello. Se il carrello non soddisfa le condizioni di trigger, il widget non apparirà — questo è il comportamento previsto.

I tipi di trigger disponibili includono:

* **Prodotti / collezioni specifici:** un prodotto, una variante o una collezione scelti sono (o non sono) nel carrello
* **Quantità di un prodotto specifico:** ad es. 2 o più unità di un prodotto
* **Tag prodotto / tipo di prodotto / nome variante:** un articolo nel carrello corrisponde a un tag Shopify, a un tipo di prodotto o a un titolo di variante (senza distinzione tra maiuscole e minuscole)
* **Metafield prodotto / metafield variante:** un prodotto o una variante nel carrello ha un valore di metafield corrispondente
* **Subtotale del carrello:** il subtotale raggiunge una soglia (vedi la nota qui sotto su come viene calcolato il subtotale)
* **Quantità nel carrello:** numero totale di articoli nel carrello
* **Abbonamento nel carrello:** se un articolo nel carrello è un abbonamento
* **Attributo del carrello:** una coppia chiave/valore di attributo a livello di carrello corrisponde (utile per i dati impostati da altre app)
* **Sconto applicato / valore dello sconto:** un codice sconto specifico è applicato, oppure lo sconto totale raggiunge una soglia
* **Paese di spedizione:** il paese di spedizione del cliente (e facoltativamente la provincia) corrisponde
* **Lingua del cliente:** la lingua del checkout corrisponde (ad esempio, mostrare contenuti in francese solo ai checkout in francese)
* **Tag cliente:** il cliente connesso ha i tag richiesti
* **Tipo di dispositivo:** il cliente usa il dispositivo configurato (desktop o mobile)

<Note>
  Il **subtotale del carrello** usato per la valutazione dei trigger esclude gli articoli già aggiunti da upsell accettati (quelli contrassegnati con l'attributo di carrello `__as_offer_id`). Quindi accettare un upsell non farà, da solo, superare al subtotale una soglia che controlla un altro widget.
</Note>

**Combinare le condizioni:** quando un widget ha più condizioni, queste vengono unite con **AND** oppure **OR** (a tua scelta), e le condizioni possono essere annidate in gruppi per logiche più complesse. Con un'unione **AND**, ogni condizione deve essere soddisfatta — una sola condizione non corrispondente blocca silenziosamente il widget. Con un'unione **OR**, basta una sola corrispondenza. Rivedi ogni condizione singolarmente rispetto al tuo carrello di prova.

**Per risolvere i problemi con i trigger:**

1. Apri il widget nell'editor Checkout di Aftersell e rivedi le sue condizioni di trigger
2. Imposta temporaneamente il trigger su **Show for all customers** per verificare che il widget in sé funzioni, poi riattiva i tuoi trigger specifici
3. Assicurati che almeno un widget usi un trigger **Show for all customers** alla priorità più bassa come opzione generica, così un'offerta viene sempre mostrata anche quando nessun widget mirato corrisponde

[Scopri di più sui trigger del checkout →](/it/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## C'è un problema con il prodotto o con l'offerta
</div>

Anche quando il widget è attivo, posizionato correttamente e i suoi trigger corrispondono, l'offerta stessa può essere filtrata prima di essere visualizzata.

<AccordionGroup>
  <Accordion title="Il prodotto di upsell è esaurito">
    Se l'inventario del prodotto è tracciato e nessuna variante è disponibile alla vendita, l'offerta non verrà visualizzata. Assicurati che almeno una variante del prodotto di upsell abbia inventario disponibile, oppure usa un prodotto che non traccia l'inventario.
  </Accordion>

  <Accordion title="Il prodotto di upsell è in stato Draft o Archived">
    Il prodotto di upsell deve essere un prodotto attivo e vendibile. I prodotti in stato **Draft** o **Archived** in Shopify vengono filtrati e non appariranno come offerte. Apri il prodotto nello Shopify Admin e verifica che il suo stato sia **Active**.
  </Accordion>

  <Accordion title="Il prodotto di upsell è già nel carrello e 'hide if already in cart' è attivo">
    L'impostazione **Hide offer if product already in cart** nasconde l'offerta quando quel prodotto è già nel carrello del cliente. È attiva per impostazione predefinita per le offerte di prodotto standard. Se vuoi che l'upsell venga mostrato comunque, disattiva questa impostazione nella configurazione dell'offerta.
  </Accordion>

  <Accordion title="Il prodotto di upsell è un abbonamento ma non ha selling plan">
    Se **Subscription purchase option** è impostato su **Subscription** ma il prodotto non ha selling plan configurati in Shopify, l'offerta viene filtrata. Verifica che il prodotto abbia almeno un selling plan attivo, oppure cambia **Subscription purchase option** in **One-time product** (le altre opzioni sono **Subscription** e **Subscription and a one-time product**).
  </Accordion>

  <Accordion title="Il prodotto target dell'upsell sostitutivo non è nel carrello">
    Se l'offerta è configurata come upsell sostitutivo, viene visualizzata solo quando il prodotto che deve sostituire è presente nel carrello. Verifica che il prodotto target corretto sia selezionato nella configurazione dell'upsell sostitutivo.

    Un'offerta sostitutiva viene inoltre saltata quando la riga target **ha già uno sconto applicato** — a meno che tu non spunti **Allow replacement if product has discount applied** — oppure quando la **quantità della riga target è superiore a uno**, a meno che tu non spunti **Allow replacement if product quantity greater than 1**.
  </Accordion>

  <Accordion title="È stato raggiunto il numero massimo di offerte accettate">
    Se **Max number of accepted offers** è impostato sul widget, l'upsell smette di essere visualizzato una volta che il cliente ha accettato quel numero di offerte dal widget nel checkout corrente. È intenzionale — una volta raggiunto il limite, il widget si nasconde. Il campo si applica solo agli upsell Single product e Multi product; gli upsell Checkmark non hanno questo limite.
  </Accordion>

  <Accordion title="L'offerta è già stata aggiunta al carrello da questo widget">
    Per gli upsell **single** e **multi-product**, una volta che il cliente aggiunge il prodotto dell'offerta al carrello, l'offerta viene nascosta (il prodotto è già nel carrello). Gli upsell **Checkmark** si comportano diversamente — rimangono visibili con la casella spuntata dopo essere stati accettati.
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## I widget di Shop Pay non appaiono
</div>

I widget del checkout non vengono visualizzati in Shop Pay per impostazione predefinita. Per mostrare il tuo upsell in Shop Pay, devi attivarlo esplicitamente:

1. Apri il blocco app di upsell di Aftersell nello Shopify Checkout Editor
2. Nelle impostazioni del blocco, trova la sezione **Checkout behaviour**
3. Spunta l'opzione **Include app block in Shop Pay**
4. Salva le modifiche

[Scopri di più sui widget di Shop Pay →](/it/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## Test nell'anteprima di Shopify
</div>

L'anteprima dello Shopify Checkout Editor non renderizza i widget in modo affidabile. Un widget può essere configurato correttamente e comunque non apparire nell'anteprima dell'editor, perché l'anteprima non può simulare il tagging delle pagine e le condizioni di trigger. Non affidarti all'anteprima dell'editor per verificare se un widget funziona.

**Per testare il tuo upsell in modo accurato:**

1. Imposta temporaneamente il trigger del widget su **Show for all customers**
2. Effettua un vero ordine di prova usando il gateway di pagamento di test di Shopify (o un codice sconto che renda l'ordine gratuito)
3. Verifica che il widget appaia durante il flusso di checkout reale
4. Ripristina i tuoi trigger dopo il test

***

<div id="nothing-above-applies">
  ## Nessuno dei casi precedenti si applica
</div>

Se hai esaminato tutto quanto sopra e l'upsell continua a non essere visualizzato, verifica quanto segue:

* Il widget è **attivo** in Aftersell e il blocco app è **aggiunto e salvato** nello Shopify Checkout Editor
* Il **posizionamento** in Aftersell corrisponde a quello selezionato in Shopify
* Le condizioni di trigger corrispondono al tuo carrello di prova — ricorda che con un'unione **AND**, ogni condizione deve essere soddisfatta
* Esiste almeno un widget con un trigger **Show for all customers** alla priorità più bassa come opzione generica
* Il prodotto di upsell è **Active**, disponibile a magazzino e (per le offerte in abbonamento) ha selling plan attivi
* Stai testando con un **flusso di checkout reale**, non con l'anteprima dell'editor di Shopify
* Prova a svuotare la cache del browser o a testare in una finestra in incognito — le modifiche possono richiedere alcuni minuti per propagarsi

Ancora non risolto? Contattaci via chat o scrivici a [support@aftersell.app](mailto:support@aftersell.app) e includi una descrizione della configurazione del tuo widget e i dettagli dell'ordine di prova.
