Skip to main content

Panoramica

Questa guida ti aiuta a risolvere le situazioni in cui Upcart non si apre o i clienti vengono reindirizzati alla pagina del carrello invece di vedere il drawer di Upcart. La maggior parte di questi problemi è causata dalle impostazioni del tipo di carrello del tema, dalla configurazione di Enhanced AJAX API Compatibility, dai reindirizzamenti di app di terze parti o dall’instradamento del pulsante di checkout.
Se Upcart non si apre affatto o reindirizza alla pagina del carrello, consulta Risoluzione dei problemi: Upcart non si apre o reindirizza alla pagina del carrello per una guida alla risoluzione dei problemi più completa.

Quale tipo di carrello scegliere

Prima di addentrarti nella risoluzione dei problemi, controlla per prima cosa l’impostazione del tipo di carrello del tuo tema, poiché è la causa più comune.
  • Page - Di solito è l’opzione migliore, poiché Upcart intercetta le richieste alla pagina /cart.
  • Drawer - Selezionalo se Upcart non si avvia e viene invece attivata la pagina /cart.
  • Confirmation Popup - Usalo se il tuo tema lo supporta e le altre opzioni non risolvono il problema.
Testare entrambe le opzioni richiede solo pochi minuti, ma Page è in genere la scelta più efficace.

Come cambiare il tipo di carrello nel tuo tema

  1. Vai su Online Store > Themes > Customize nel tuo admin Shopify.
  2. Apri Theme Settings > Cart > Cart Type.
  3. Scegli Page o Drawer in base al comportamento che stai analizzando.
  4. Salva le modifiche e testa il carrello sul tuo storefront.
Impostazioni del carrello nell'editor del tema Shopify che mostrano l'opzione del tipo di carrello
Se non riesci a trovare questa impostazione, contatta lo sviluppatore del tuo tema. Questa impostazione è controllata dal tuo tema e Upcart non può modificarla direttamente.

Passaggi per la risoluzione dei problemi

Se cambiare il tipo di carrello non risolve il problema, procedi con i seguenti passaggi in ordine.

1. Controlla Enhanced AJAX API Compatibility

Questa impostazione controlla come Upcart gestisce gli eventi Add to Cart ed è una delle cause più comuni dei problemi di reindirizzamento.
  1. Vai su Upcart > Cart Editor > Settings > Cart settings, quindi espandi Advanced Settings.
  2. Individua Enhanced Ajax API compatibility.
  3. Questa impostazione è disabilitata per impostazione predefinita per la maggior parte dei negozi. Quando è disabilitata, Upcart intercetta le chiamate Add to Cart e previene i reindirizzamenti.
  4. Se è abilitata, altre app possono prendere il controllo del comportamento del carrello e reindirizzare i clienti alla pagina del carrello. Prova a disabilitarla e testa.
  5. Se disabilitarla causa altri problemi, riabilitala e usa invece l’API manuale di Upcart (upcartRegisterAddToCart).
Per indicazioni complete su questa impostazione, consulta Enhanced AJAX API Compatibility.

2. Verifica i reindirizzamenti di app di terze parti

Molte app di terze parti sovrascrivono il comportamento del carrello e possono reindirizzare i clienti lontano dal drawer di Upcart. Se il tuo pulsante Add to Cart manda specificamente i clienti alla pagina del carrello, consulta Perché ‘Add to Cart’ porta alla pagina del carrello invece che a Upcart? per maggiori dettagli. Apri le impostazioni di tutte le app legate al carrello e cerca opzioni come:
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
Cambiale in Stay on page o Do nothing. Soluzioni comuni per app specifiche:
  • PageFly - Disabilita le regole di reindirizzamento nelle impostazioni dell’app PageFly.
  • Globo Product Options - Disattiva il reindirizzamento automatico al carrello di Shopify.
  • Replo - Regola le impostazioni “go to page” per abilitare il cart drawer.
  • Zepto Product Personalizer - Vai su Zepto > Settings > Add to Cart Settings e cambia “Action after a product is added to the cart” in “Stay on the product page and show a success message.”
Se non sai quale app stia causando il conflitto, disabilita le app legate al carrello una alla volta e testa dopo ciascuna finché Upcart non inizia a funzionare correttamente.

3. Controlla l’instradamento del pulsante di checkout

Se i clienti cliccano sul pulsante di checkout all’interno di Upcart e vengono reindirizzati alla pagina del carrello invece che al checkout:
  1. Vai su Upcart > Cart Editor > Settings > Cart settings.
  2. Individua “Go to cart page when pressing checkout button”.
  3. Impostalo su OFF.
  4. Salva e testa.
Il reindirizzamento a una pagina di checkout personalizzata richiede programmazione avanzata e non è supportato direttamente da Upcart. Se hai bisogno di instradare i clienti verso una pagina di checkout personalizzata, dovrai lavorare con uno sviluppatore.

4. Controlla le impostazioni di reindirizzamento del carrello del tema

Alcuni temi reindirizzano automaticamente i clienti dopo l’aggiunta di un prodotto, bypassando completamente Upcart.
  1. Vai su Online Store > Themes > Customize.
  2. Apri Theme Settings > Products (o Cart).
  3. Cerca impostazioni come:
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. Impostale su OFF.
  5. Salva e testa.

5. Svuota la cache del browser

I vecchi script memorizzati nella cache possono mantenere il comportamento precedente del carrello e impedire il corretto caricamento di Upcart.
  1. Apri le impostazioni del tuo browser.
  2. Vai su Privacy e sicurezza.
  3. Seleziona Cancella dati di navigazione.
  4. Cancella immagini e file memorizzati nella cache e i cookie.
  5. Aggiorna il tuo negozio e testa.

6. Testa con un tema Shopify predefinito

Se il problema persiste, passa temporaneamente a un tema Shopify predefinito come Dawn per escludere un conflitto specifico del tema.
  1. Vai su Shopify Admin > Online Store > Themes.
  2. Aggiungi e abilita un tema gratuito come Dawn.
  3. Testa Upcart sul tema predefinito.
Se Upcart funziona correttamente su Dawn, il problema riguarda il tuo tema personalizzato. Contatta lo sviluppatore del tuo tema per assistenza.

Misure preventive

  • Rivedi le configurazioni dopo gli aggiornamenti - Gli aggiornamenti di tema e app possono azzerare o sovrascrivere le impostazioni del carrello. Controlla il tipo di carrello e le configurazioni delle app dopo ogni aggiornamento importante.
  • Testa la compatibilità delle app prima di installarle - Prima di aggiungere nuove app di terze parti, verifica che siano compatibili con Upcart.
  • Usa un tema Draft per i test - Testa le modifiche su un tema Draft prima di pubblicare, per evitare di interrompere il tuo negozio live. Consulta Abilitare Upcart solo in un tema Draft per le istruzioni.

Domande frequenti

No, il reindirizzamento a una pagina di checkout personalizzata richiede programmazione avanzata e non è supportato direttamente da Upcart. Se ne hai bisogno, dovrai lavorare con uno sviluppatore.
Assicurati che Upcart sia attivo e pubblicato nel Cart Editor. Svuota anche la cache del browser per assicurarti che il comportamento aggiornato abbia effetto. Se il problema persiste, verifica i conflitti con app di terze parti seguendo i passaggi sopra.
Apri le impostazioni dell’app di add-on e cerca eventuali configurazioni di reindirizzamento automatico o “go to cart”. Disabilitale se entrano in conflitto con Upcart. Vedi il Passaggio 2 sopra per esempi specifici per app.

Hai bisogno di aiuto? Se hai seguito tutti i passaggi sopra e il problema persiste, contatta il nostro team di supporto tramite la chat in-app o via email a support@upcart.app.