Skip to main content

​
Panoramica

Ecco le risposte ad alcune delle domande più comuni sull’uso dell’API di Upcart.

​
Dove aggiungere gli script API di Upcart?

Puoi aggiungere gli script nelle impostazioni Custom HTML di Upcart o direttamente nel codice del tuo tema Shopify. L’opzione migliore dipende dalle tue esigenze di personalizzazione.

​
Come uso il Custom HTML di Upcart?

  1. Vai su Upcart → Settings → Custom HTML
  2. Usa gli script API per modificare il comportamento del carrello, come i tempi di apertura o la visualizzazione degli upsell
  3. Regola elementi esterni a Upcart, come nascondere i pulsanti della pagina prodotto

​
💡 Esempio: nascondere il pulsante sticky del carrello quando il carrello è vuoto

Nota legacy: le callback window.upcartOnCartLoaded funzionano ancora ma sono deprecate e registrano avvisi in console. Usa upcartSubscribeCartLoaded per tutti i nuovi script. Tieni presente che event.cart non ha una proprietà item_count: usa event.cart.items.reduce((total, item) => total + item.quantity, 0) per calcolare il numero totale di articoli.

​
Devo essere uno sviluppatore per usare l’API di Upcart?

No! L’API di Upcart è facile da usare, anche senza competenze di programmazione. Molte funzionalità sono integrate e la nostra documentazione sulle personalizzazioni include script già pronti che puoi copiare nelle impostazioni Custom HTML di Upcart — nessuna programmazione richiesta! Se vuoi scrivere script personalizzati, una conoscenza base di JavaScript aiuta. Se sei nuovo a JavaScript, non preoccuparti! Queste risorse per principianti — W3Schools e MDN Web Docs — possono aiutarti a iniziare.

​
L’API di Upcart può integrarsi con altre app di terze parti?

Sì! L’API di Upcart funziona con app per traduzioni, analytics, upsell e altro ancora. Alcune si integrano automaticamente, mentre altre potrebbero richiedere un piccolo script. Per esempio, se usi TripleWhale per il tracciamento, dovrai aggiungere il seguente script per assicurarti che registri correttamente l’attività del carrello:
Nota legacy: le callback window.upcartOnAddToCart funzionano ancora ma sono deprecate e registrano avvisi in console. Usa upcartSubscribeAddedToCart per tutti i nuovi script. Tieni presente che le proprietà dell’evento si trovano su event.item (con variantId e quantityAdded), non vengono passate come parametri separati.
Poiché ogni app è diversa, consulta il team di supporto della tua app per verificare se serve codice aggiuntivo. Upcart non offre supporto per gli script di app di terze parti, ma il fornitore della tua app potrebbe avere una guida all’integrazione.

​
Come faccio a verificare se le mie modifiche API funzionano?

Dopo aver aggiunto uno script nelle impostazioni Custom HTML di Upcart, segui questi passaggi per assicurarti che funzioni:
  1. Aggiorna il tuo store e aggiungi un articolo al carrello.
  2. Svuota la cache e riprova per vedere le modifiche più recenti.
  3. Aggiungi un messaggio di test: inserisci console.log("The script works!"); prima di </script> per verificare se il tuo script viene eseguito.
  4. Controlla la console del browser:
    • Apri i Dev Tools (F12 o Ctrl + Shift + J su Windows, Cmd + Option + J su Mac).
    • Vai alla scheda Console e cerca “The script works!”
    • Se vedi il messaggio, il tuo script è in esecuzione! In caso contrario, lo script potrebbe non essere eseguito correttamente.
  5. Testa azioni diverse (es. rimuovere un articolo) per assicurarti del comportamento atteso.
Risolvi i problemi controllando errori di battitura o errori in console e modificando il codice secondo necessità.

​
Cosa devo fare se uno script API non funziona?

Se il tuo script API non funziona, prova questi passaggi di risoluzione dei problemi:
  • Controlla gli errori di battitura – Anche piccoli errori possono rompere uno script. Cerca caratteri mancanti o sintassi errata.
  • Verifica la posizione dello script – Assicurati che lo script sia nella sezione corretta sotto Upcart → Settings → Custom HTML. Upcart ha dieci sezioni per script (nove punti di iniezione HTML più una sezione Scripts-before-load) — Consulta queste sezioni qui.
  • Controlla la console del browser – Segui i passaggi sopra per cercare errori.
  • Prova uno script diverso – Prova un altro script API di Upcart già pronto per capire se il problema è nel tuo codice.
  • Ancora bloccato? – Se stai modificando il tuo tema Shopify o integrando app di terze parti, uno Shopify Expert dalla Shopify Partner Directory può aiutarti.
Questi passaggi dovrebbero aiutarti a identificare e risolvere la maggior parte dei problemi con gli script!

​
Come annullo le modifiche se aggiungo uno script che rompe qualcosa?

Se aggiungi uno script che non funziona come previsto, puoi rimuoverlo o disattivarlo facilmente:
  • Vai alle impostazioni Custom HTML di Upcart dove è stato aggiunto lo script.
  • Rimuovi lo script o disattivalo temporaneamente aggiungendo // all’inizio di ogni riga (questo lo trasforma in un commento, impedendone l’esecuzione).
  • Salva le modifiche e aggiorna il tuo store per verificare se il problema è risolto.
Se il problema persiste, prova a svuotare la cache o a ripristinare le modifiche recenti al tema — questo spesso risolve conflitti nascosti.
🚧 Cerchi personalizzazioni avanzate? Hai bisogno di personalizzazioni a livello di store o integrazioni con app di terze parti? Potresti aver bisogno di uno sviluppatore per aggiungere l’API di Upcart al tuo tema Shopify. Valuta di ingaggiare uno Shopify Expert tramite la Shopify Partner Directory e condividi con lui la nostra documentazione API per assistenza