Migrare da un'App Precedente

Ultimo aggiornamento: 31/08/2026

Alcuni store usano un'app ARShades configurata su misura per loro, da prima che ARShades VTO fosse pubblicata sull'App Store di Shopify. Questa pagina serve a passare all'app dell'App Store.

Ti riguarda se hai un'app ARShades che non hai installato tu da https://apps.shopify.com/arshades-vto. Se l'hai installata da quel link, sei già sull'app attuale e puoi ignorare questa pagina.

Non rimuovere mai il Token

Nella pagina Licenza, dietro Modifica, la finestra Gestisci Token ARShades si chiude con un pulsante rosso Rimuovi Token dal negozio. È pensato per uno store che lascia ARShades definitivamente: rimuove il collegamento fra ogni variante e il suo modello 3D su tutto il catalogo, e svuota il catalogo collegato al tuo store. Non si può annullare, e quei collegamenti sono esattamente ciò che rende rapida questa migrazione. La sua finestra di conferma si intitola Disconnect ARShades: è lì che devi fermarti.

Non confonderlo con Disconnetti (solo DB) nella pagina Pixel: quello è innocuo.

Disinstallare è un'altra cosa, ed è sicuro. Per migrare: disinstalla. Mai rimuovere il Token.

Cosa sopravvive e cosa ricostruisci

Sopravvive intatto	Lo ricostruisci
Il Liquid del tuo tema, gli snippet e gli asset — ma inattivi finché i nuovi app embed non sono attivi	Gli app embed: riattivarli e reinserirne le impostazioni
I metafield arshades su shop e varianti — i collegamenti variante ↔ modello 3D	Ogni app block posizionato dall'editor del tema
Licenza, Token di Licenza e domini autorizzati	La tabella dei prodotti sincronizzati dell'app, con Repair Sync
Il catalogo 3D, i contatori di consumo e le statistiche storiche	L'autorizzazione dell'app — approvi di nuovo gli stessi permessi

Due cose cambiano da sole: il percorso che il tuo tema chiama sullo storefront, e la versione del bundle che il tuo store riceve. Un tema che legge il percorso dal metafield dello shop si ripara da solo; un tema che lo ha scritto a mano no.

Prima di iniziare

Niente di quanto segue modifica lo store, ma le impostazioni dell'app embed non sono più recuperabili dopo.

1. Duplica il tema pubblicato. Quella copia è il tuo rollback.
2. Annota le impostazioni degli app embed. Online Store → Themes → Customise → App embeds. Apri ARShades VTO Embed e, se lo usi, ARShades 3D Embed, e copia ogni valore di ciascun pannello: sono una trentina per embed, dal layout e la geometria della finestra fino ai colori dei pulsanti e alle opzioni Add to Cart. Non lavorare su un elenco parziale. Se hai anche posizionato app block ARShades nei template, aprili: hanno impostazioni proprie, fra cui il testo di caricamento. Copia i valori esatti, codici colore compresi: ripristinare a occhio non funziona.
3. Annota dove compaiono i tuoi pulsanti, se hai usato gli app block invece del codice del tema.
4. Cerca /apps/arshades nel tema. Se il tuo Liquid legge il percorso da shop.metafields.arshades.proxyPath, non devi fare nulla. Se il percorso è scritto a mano, annota ogni file: lo aggiornerai al passaggio 6.
5. Annota quanti prodotti risultano sincronizzati, e tieni a portata il Token di Licenza.

La migrazione

La maggior parte degli store può installare la nuova app prima di rimuovere la vecchia, così lo storefront non va mai giù e tornare indietro è banale. Una minoranza non può, perché le due app rivendicherebbero lo stesso percorso sullo storefront: se non sai in quale caso sei, chiedi al tuo referente ARShades prima di fissare la data. Se devi rimuovere prima la vecchia app, scegli un'ora di poco traffico: nel frattempo la prova virtuale non funziona.

1. Installa ARShades VTO da https://apps.shopify.com/arshades-vto — vedi Installazione. I permessi sono gli stessi di prima.
2. Verifica che licenza e catalogo siano riconosciuti. Se il catalogo non si riseleziona da solo, scegli quello esistente dall'elenco: non crearne uno nuovo.
3. Esegui Repair Sync. Ricostruisce i collegamenti variante ↔ modello dai dati già presenti sui tuoi prodotti. Confronta il numero con quello che avevi annotato.
4. Attiva gli app embed della nuova app — ARShades VTO Embed e, se mostri il visualizzatore 3D, ARShades 3D Embed — e reinserisci le impostazioni di ciascuno. Senza questo il codice nel tuo tema resta inerte e i pulsanti non aprono nulla. Se hai entrambe le app installate, disattiva i vecchi nello stesso salvataggio, altrimenti il servizio si carica due volte.
5. Rimetti gli app block e riposizionali dov'erano.
6. Aggiorna il percorso scritto a mano che avevi trovato, portandolo a /apps/arshades-vto.
7. Disinstalla la vecchia app — Settings → Apps and sales channels → Delete. È il punto di non ritorno: i suoi blocchi nel tema diventano orfani.

Verifica che funzioni

Apri questo indirizzo mentre sei collegato al tuo store:

https://<your-store>/apps/arshades-vto/vto-products?shop=<your-domain>&include3d=true

Deve rispondere con un elenco di varianti non vuoto. La risposta è in cache per circa cinque minuti, quindi dopo una correzione aspetta prima di riprovare.

Una dashboard verde non è una prova

La dashboard può mostrare tutti i prodotti come Synchronised mentre lo storefront resta muto, perché legge lo stato dai tuoi prodotti e non dal collegamento che l'app ha appena ricostruito. Fidati dell'indirizzo qui sopra, e poi di una pagina prodotto reale.

Sintomo	Causa e rimedio
I pulsanti compaiono ma non aprono nulla, o mancano i pulsanti 3D	L'app embed corrispondente non è attivo — passaggio 4
Elenco vuoto all'indirizzo qui sopra	Repair Sync non è stato eseguito, o non ha trovato nulla — passaggio 3
404 all'indirizzo qui sopra	Il tema chiama ancora il vecchio percorso — passaggio 6, vedi Integrazione Manuale
Il pulsante dice "Virtual Try-On", o la finestra ha un aspetto diverso	Le impostazioni sono tornate ai default — reinseriscile dai tuoi appunti
La prova virtuale si apre due volte	Sono attivi entrambi gli app embed — disattiva quello vecchio
L'Add to Cart nella prova è comparso o sparito	Atteso: alcune funzioni del tema si attivano sopra una versione minima del bundle, che dopo la migrazione può essere diversa

Se devi tornare indietro

Prima del passaggio 7, basta disinstallare la nuova app. Dopo, reinstalla l'app precedente e riattiva il suo embed: il codice del tuo tema non è mai stato modificato. In entrambi i casi, avvisa il tuo referente ARShades in giornata.

Ancora bloccato? Vedi Supporto e le FAQ.