Skip to main content
Questo articolo spiega come risolvere i problemi di compatibilità delle app con Upcart e fornisce le best practice per prestazioni ottimali.

​
Panoramica

Upcart è progettato per integrarsi senza problemi con la maggior parte delle app Shopify. Tuttavia, alcune app di terze parti possono causare problemi di funzionalità a seconda di come modificano la logica di carrello, checkout, prezzi o valuta di Shopify.
​ Upcart funziona come un overlay del cart drawer, migliorando l’esperienza del carrello senza sostituire completamente il carrello o il checkout nativi di Shopify.
​ Le app che sovrascrivono il comportamento del carrello di Shopify, intercettano le azioni Add to Cart o sostituiscono il sistema nativo di prezzi o valuta di Shopify possono entrare in conflitto con Upcart. Consigliamo di usare le funzionalità native di Shopify ove possibile (come Shopify Markets per la conversione di valuta). Il nostro team ha un ambito di supporto limitato per le app di terze parti che alterano in modo significativo la struttura predefinita del carrello di Shopify. Anche se un’app è disponibile nello Shopify App Store, potrebbe comunque essere classificata come app di terze parti e presentare alcune limitazioni quando usata con Upcart.

​
App incompatibili

Le seguenti app causano sistematicamente problemi con Upcart e non sono supportate: BUCKS (app convertitore di valuta)
Upcart non è compatibile con le app di conversione valuta di terze parti. Upcart usa la conversione di valuta nativa di Shopify tramite Shopify Markets. Le app di conversione valuta come BUCKS cambiano i prezzi solo visivamente sullo storefront e non modificano la valuta effettiva del carrello. Per questo motivo, non influiranno sulla visualizzazione della valuta all’interno di Upcart e possono causare incoerenze. Se hai bisogno di funzionalità multi-valuta, ti consigliamo di usare Shopify Markets. CloudFox Checkout
Le app di sostituzione del checkout di terze parti non sono compatibili con Upcart. CartPanda
I sistemi di checkout di terze parti non sono supportati.

​
App che possono causare problemi

Le seguenti app sono state segnalate come causa di conflitti o potrebbero non funzionare completamente come previsto con Upcart:
  • qikify Quick View Popups
  • Vitals
  • Bundle Bear
Anche se queste app possono funzionare in alcuni casi, alcuni elementi o funzionalità di Upcart potrebbero non essere visualizzati o funzionare come previsto. Se riscontri problemi usando una di queste app, ti consigliamo di abilitare l’impostazione di compatibilità descritta di seguito.
​ Gli sviluppatori possono anche utilizzare la Upcart Public API per lavorare a una soluzione.

​
Enhanced AJAX API Compatibility

Se riscontri conflitti con un’altra app, ti consigliamo di abilitare: Enhanced AJAX API Compatibility Per abilitare questa impostazione: Vai su Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility. Non esiste una destinazione Settings di primo livello nell’admin di Upcart — l’impostazione si trova all’interno del cart editor, sotto la sezione a scomparsa Advanced Settings. Questa impostazione dice a Upcart di smettere di intercettare le chiamate Add to Cart. Fa anche una seconda cosa che il nome non suggerisce: fa sì che Upcart metta in coda le chiamate all’API Ajax del carrello di Shopify (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js) in modo che vengano eseguite una alla volta, evitando che aggiornamenti simultanei da script diversi si sovrascrivano a vicenda. Poiché questo accodamento applica una patch a tutte le richieste di rete del carrello sulla pagina, attiva l’impostazione solo quando ti serve e testa lo storefront subito dopo. Questo consente ad altre app, come app di bundle, page builder, app di personalizzazione e app di opzioni prodotto, di funzionare senza interferenze.

​
Importante:

Questa impostazione comporta un compromesso. Poiché Upcart non intercetterà più le chiamate Add to Cart, non potrà impedire ad altre app di reindirizzare i clienti alla pagina del carrello nativa. Se i clienti vengono reindirizzati fuori dal cart drawer dopo aver abilitato questa impostazione:
  1. Controlla le impostazioni dell’app in conflitto.
  2. Cerca opzioni come:
    • Disable redirect to cart
    • Stay on page after add to cart
    • Enable AJAX add to cart
  3. Regola quelle impostazioni per evitare i reindirizzamenti forzati alla pagina del carrello.
È fortemente consigliato eseguire test dopo aver abilitato questa impostazione. Le app elencate sopra sono esempi di quelle che hanno mostrato problemi di compatibilità con Upcart. Potrebbero esserci altre app non ancora identificate. Questo elenco verrà aggiornato man mano che vengono segnalati nuovi casi.

​
Se Upcart non si apre o reindirizza

Se Upcart non si apre correttamente o reindirizza invece alla pagina del carrello, consulta la nostra guida alla risoluzione dei problemi: Risoluzione dei problemi: Upcart non si apre o reindirizza alla pagina del carrello Questa guida illustra le cause comuni e le soluzioni passo dopo passo, tra cui:
  • Conflitti con il tema o con codice personalizzato
  • Problemi con le impostazioni del carrello AJAX
  • Verifiche di compatibilità delle app
  • Passaggi di risoluzione dei problemi legati a browser e cache
Se il problema persiste dopo aver seguito la guida, contatta il supporto indicando l’URL del tuo negozio e una breve descrizione del problema.

​
Consiglio per i test

Prima di pubblicare qualsiasi modifica, ti consigliamo di testare Upcart su una versione duplicata del tuo tema. Per farlo:
  • Nell’admin Shopify, vai su Online Store > Themes
  • Clicca su Actions accanto al tuo tema live, quindi seleziona Duplicate
  • Apri il tema duplicato e clicca su Preview
  • Testa le interazioni con il carrello, i bundle, gli sconti, la visualizzazione della valuta e gli upsell
  • Una volta verificato tutto, pubblica il tema aggiornato
Testare in anticipo aiuta a prevenire problemi di visualizzazione o di prestazioni prima che colpiscano i clienti.