Come capire se un’app Shopify sta causando un problema?

La maggior parte dei negozi Shopify si appoggia alle app. Recensioni, upsell, opzioni prodotto, abbonamenti, traduzioni, liste dei desideri, pop-up, regole di spedizione, tracciamento: ognuna di solito arriva da uno sviluppatore diverso.

Quando qualcosa nel negozio all’improvviso appare o si comporta in modo strano, un’app è spesso tra i primi sospettati. Sintomi tipici:

• una sezione della pagina prodotto è sparita o si è spostata
• il pulsante aggiungi al carrello non funziona più
• il carrello laterale si apre vuoto o mostra il totale sbagliato
• un pop-up, un badge o un widget compare due volte
• prezzi, sconti o opzioni prodotto vengono mostrati in modo errato
• il negozio è diventato sensibilmente più lento
• compare un errore o uno spazio vuoto dove prima c’era un widget

La buona notizia è che Shopify è ospitato e gestito direttamente dalla piattaforma, quindi un problema con un’app raramente significa che i dati del negozio sono danneggiati. Prodotti, ordini e clienti di norma sono ancora al sicuro nel pannello di amministrazione. Quello che di solito ne risente è la vetrina: ciò che i tuoi clienti vedono e cliccano.

La parte difficile è che le app possono intervenire sul negozio in modi diversi, e due app che da sole funzionano perfettamente possono interferire tra loro. L’obiettivo è capire quale app è coinvolta senza rimuovere cose alla cieca.

Questa guida spiega come le app interagiscono con il tuo tema, cosa puoi controllare in sicurezza, come fare test su un tema duplicato e quando ha senso chiedere aiuto.

Come modificano il mio negozio le app Shopify?

Capire come le app si collegano al negozio rende molto più facile scoprire da dove arriva un problema. Ci sono alcuni metodi comuni.

Blocchi app e incorporamenti app

Molte app moderne usano le theme app extension di Shopify. Queste aggiungono:

• blocchi app (app blocks), che inserisci dentro una sezione con l’editor del tema, per esempio un blocco recensioni nella pagina prodotto
• incorporamenti app (app embeds), che si attivano per l’intero tema e di solito caricano uno script, un widget fluttuante o un pop-up

Sono il metodo più pulito. Li vedi nell’editor del tema, puoi attivarli e disattivarli e di norma vengono rimossi quando disinstalli l’app.

Codice aggiunto direttamente al tema

Le app più vecchie, e alcune attuali, inseriscono codice direttamente nei file del tema. Può trattarsi di un file snippet, di una riga nel file di layout principale o di modifiche ai template di prodotto e carrello.

Questo codice non è sempre visibile dall’editor del tema. E non sempre viene rimosso in automatico quando disinstalli l’app.

Script caricati fuori dal tema

Alcune app caricano script nella vetrina in modi che non dipendono dai file del tema. Questo significa che cambiare tema, o rimuovere codice dal tema, non le fermerà necessariamente.

Pixel di tracciamento ed eventi dei clienti

Le app di marketing e analisi spesso registrano pixel che tracciano visite, aggiunte al carrello e acquisti. Si gestiscono separatamente dal tema, nelle impostazioni del negozio.

App che modificano i dati

Alcune app modificano dati dietro le quinte, come inventario, prezzi, tag o regole di sconto. Se non funzionano bene, il sintomo può sembrare un problema del tema quando in realtà è un problema di dati.

Quali sono i segnali che la causa è un’app?

Nessun segnale da solo lo dimostra, ma diversi insieme rendono un’app un forte sospettato.

I tempi coincidono con una modifica a un’app

Pensa a cosa è successo poco prima che comparisse il problema:

• Hai installato una nuova app?
• Un’app esistente ha rilasciato un aggiornamento o cambiato le sue impostazioni?
• Hai modificato un’impostazione dentro un’app?
• Hai attivato un nuovo incorporamento app o aggiunto un blocco app?
• Qualcuno ha disinstallato un’app?
• Hai aggiornato o sostituito il tema più o meno nello stesso periodo?

Le app possono aggiornarsi senza alcuna azione da parte tua. Se dal tuo lato non è cambiato nulla, controlla il changelog, le note di rilascio o la pagina di supporto dell’app, oppure verifica nelle recensioni dell’app se altri merchant segnalano lo stesso problema.

Il problema riguarda una sola funzione

Se è coinvolta solo la sezione recensioni, solo le opzioni prodotto o solo il carrello laterale, l’app responsabile di quella funzione è il punto di partenza naturale. Tieni presente, però, che un’altra app potrebbe interferire con essa.

Due app fanno lavori simili

I conflitti sono particolarmente comuni quando due app lavorano sulla stessa parte del negozio, per esempio:

• due app che modificano entrambe il carrello
• un convertitore di valuta e un’app di traduzione
• due app di sconti o di upsell
• un’app di opzioni prodotto e un’app di bundle
• un’app di abbonamenti e un pulsante aggiungi al carrello personalizzato

Il problema compare su alcune pagine e non su altre

Un’app può caricarsi solo nelle pagine prodotto, nelle pagine collezione o nel carrello. Se il problema segue questo schema, indica l’app che si carica lì.

Cosa devo controllare per primo?

Questi controlli sono sicuri e non modificano nulla nel negozio.

Annota cosa è cambiato e quando

Prendi una semplice nota con la data in cui è iniziato il problema, le app installate, aggiornate o rimosse di recente, eventuali modifiche al tema e chi altro ha accesso al negozio, come collaboratori interni, un freelance o un’agenzia.

Riproduci il problema in una finestra privata

Apri il negozio in una finestra del browser privata o in incognito, così lo vedi come un nuovo visitatore. Provalo sia da mobile sia da desktop.

Annota l’URL della pagina, cosa hai cliccato, cosa ti aspettavi e cosa è successo invece. Uno screenshot o una breve registrazione dello schermo aiuta chiunque debba indagare.

Verifica se il checkout è coinvolto

Prova ad arrivare al checkout con un prodotto di prova. Se i clienti non riescono a pagare, il problema diventa urgente e potresti volerlo affrontare prima di qualsiasi altra cosa. Leggi checkout Shopify non funziona per saperne di più su questa situazione.

Rivedi le app installate

Apri l’elenco delle app installate nel pannello di Shopify e guardalo con occhi nuovi:

• Ci sono app che non usi più?
• Ci sono app che fanno lo stesso lavoro?
• Ci sono app installate di recente che non riconosci?
• Qualche app mostra un avviso o chiede nuove autorizzazioni?

Per ora non disinstallare nulla. Fai solo un elenco.

Come faccio un test su un tema duplicato?

Il test su un tema duplicato è il modo più sicuro per indagare su un problema di un’app legato al tema. Il negozio online resta esattamente com’è mentre sperimenti su una copia.

L’idea generale è:

1. Duplica il tema pubblicato.
2. Apri il duplicato nell’editor del tema.
3. Disattiva un incorporamento app o rimuovi un blocco app alla volta.
4. Visualizza l’anteprima del duplicato e verifica se il problema c’è ancora.
5. Annota il risultato di ogni modifica.

Se il problema sparisce dopo aver disattivato un determinato incorporamento, hai trovato una pista solida.

Alcuni punti da tenere a mente:

• Il tema duplicato è visibile solo a te in anteprima, quindi i clienti non ne risentono.
• Le modifiche fatte al duplicato non toccano il tema pubblicato.
• Alcune app caricano script che non dipendono dal tema, quindi potrebbero girare anche nell’anteprima.
• Alcune app sono legate a un tema specifico e potrebbero non comportarsi allo stesso modo su una copia.

Se nel duplicato il problema non cambia affatto, è comunque un’informazione utile. Può indicare un’app che lavora fuori dal tema, le impostazioni dell’app stessa o qualcosa che non dipende dalle app.

E il codice lasciato dalle vecchie app?

È una delle cause più comuni dei problemi difficili da spiegare.

Quando un’app aggiunge codice direttamente al tema e poi viene disinstallata, quel codice può restare nei file del tema. Può:

• cercare di caricare uno script che non esiste più
• mostrare un riquadro vuoto o un widget rotto
• causare errori che bloccano altri script della pagina
• rallentare il negozio
• interferire con un’app che l’ha sostituita

Alcuni sviluppatori di app pubblicano istruzioni per rimuovere il loro codice dopo la disinstallazione, quindi controlla le pagine di aiuto dell’app.

Il codice residuo spiega anche perché a volte una copia nuova del tema fa sparire un problema. È un test utile, ma ricostruire il tema pubblicato in questo modo significa rifare ogni personalizzazione.

Cosa evitare

Quando il negozio non funziona bene, viene la tentazione di provare tutto insieme. Queste azioni spesso rendono la situazione più difficile da capire o da annullare:

• Disinstallare più app contemporaneamente. Non saprai quale era la responsabile e potresti perdere impostazioni e dati delle app difficili da ricostruire.
• Modificare direttamente il codice del tema pubblicato. Lavora prima su un duplicato.
• Cancellare codice che non capisci. Potrebbe appartenere a un’app che usi ancora o a una funzione personalizzata.
• Installare un’altra app per risolvere il problema. Può aggiungere un nuovo conflitto a quello vecchio.
• Pubblicare in fretta un tema diverso. Il nuovo tema potrebbe non includere le tue sezioni, impostazioni o blocchi app.
• Ignorare i dati dell’app. Disinstallare app di recensioni, abbonamenti o fedeltà può eliminare dati su cui i clienti contano. Verifica prima se c’è un’esportazione.

Devo contattare lo sviluppatore dell’app?

Spesso sì. Gli sviluppatori conoscono il proprio codice e vedono spesso gli stessi conflitti su molti negozi.

Per avere in fretta una risposta utile, includi:

• l’indirizzo myshopify del tuo negozio
• il nome del tema e la sua versione, se la conosci
• l’URL della pagina in cui compare il problema
• una breve descrizione di cosa succede e di cosa dovrebbe succedere
• screenshot o una registrazione dello schermo
• quando è iniziato il problema
• le altre app che lavorano sulla stessa funzione
• cosa hai già provato, compresi i test su un tema duplicato

Molti sviluppatori chiederanno un accesso da collaboratore per indagare. Concedi solo le autorizzazioni necessarie, usa le funzioni di accesso per collaboratori o per lo staff di Shopify invece di condividere le tue credenziali e rimuovi l’accesso quando il lavoro è finito. Non inviare mai la tua password via email o chat.

Quando due app vanno in conflitto, ciascuno sviluppatore può dare la colpa all’altro. Qualcuno che può guardare l’intero negozio può decidere dove va fatta la correzione.

Quando chiedere supporto?

È una buona idea coinvolgere uno sviluppatore quando:

• sono coinvolti il checkout, il carrello o il pulsante aggiungi al carrello
• dopo semplici test non riesci a capire quale app sia responsabile
• due o più sviluppatori di app si danno la colpa a vicenda
• il problema riguarda codice aggiunto direttamente al tema
• sospetti codice residuo di app rimosse molto tempo fa
• il negozio ha molte app ed è diventato lento o instabile
• il problema tocca prezzi, inventario, sconti o ordini
• non ti senti a tuo agio a lavorare sul codice del tema

Quali informazioni raccogliere?

Sono utili gli stessi dettagli che invieresti allo sviluppatore di un’app, più l’elenco delle app installate, i risultati di eventuali test su un tema duplicato, le risposte ricevute dagli sviluppatori e se i clienti hanno segnalato problemi. Non ti serve tutto questo per iniziare: per aprire una richiesta basta una breve descrizione.

Come può aiutarti D4Hub

L’obiettivo non è solo far sparire il sintomo, ma capire quale componente è responsabile e correggerlo nel punto giusto.

A seconda della situazione, D4Hub può aiutarti a:

• rivedere le app installate e come ognuna si collega al negozio
• testare incorporamenti e blocchi app su un tema duplicato
• trovare e rimuovere in sicurezza il codice lasciato da app disinstallate
• individuare conflitti tra app che lavorano sulla stessa funzione
• parlare con gli sviluppatori delle app fornendo i dettagli tecnici di cui hanno bisogno
• controllare carrello, aggiungi al carrello e checkout dopo una correzione
• ridurre il numero di app dove diverse si sovrappongono
• consigliarti una routine più sicura per installare e testare nuove app

Puoi chiedere supporto in qualsiasi fase. D4Hub può guidarti in un singolo controllo, confermare se un’azione è sicura o farsi carico dell’intera indagine.

{% render 'app-name-snippet' %}

{% comment %}
{% render 'old-app-snippet' %}
{% endcomment %}

Domande frequenti

Un’app può danneggiare i miei prodotti o ordini?

La maggior parte delle app che causano problemi alla vetrina non tocca prodotti o ordini. Tuttavia, le app autorizzate a modificare dati, come quelle per inventario, prezzi o modifiche in blocco, possono cambiare i dati se non funzionano bene. Se noti modifiche inattese a prodotti o ordini, sospendi le automazioni dell’app e contatta lo sviluppatore prima di fare qualsiasi altra cosa.

Disinstallare un’app rimuove tutto il suo codice?

Non sempre. Le app costruite con le theme app extension di solito vengono rimosse in modo pulito. Le app che hanno aggiunto codice direttamente al tema possono lasciare snippet e riferimenti a script, che possono causare errori o rallentare il negozio.

Perché il problema si presenta ancora su un tema duplicato con l’app disattivata?

Alcune app caricano script in modo indipendente dal tema, quindi continuano a girare qualunque cosa tu cambi nei file del tema. Il problema potrebbe anche arrivare dalle impostazioni dell’app stessa, da un’altra app o dal tema. Un test su un tema duplicato restringe il campo, ma non risolve ogni caso.

Devo disinstallare tutte le app per trovare la colpevole?

No. Rimuovere le app una per una sul negozio online può rompere funzioni su cui contano i clienti e può cancellare i dati delle app. Fai prima i test su un tema duplicato e disinstalla un’app solo quando sei sicuro che sia la causa e hai esportato tutto ciò che ti serve.

Quante app sono troppe?

Non c’è un numero fisso. Conta se ogni app è necessaria, se diverse app si sovrappongono e quanto ognuna pesa sul caricamento delle pagine. Rivedere periodicamente le app installate è una buona abitudine. Leggi Perché il mio negozio Shopify è lento? per capire meglio come le app influiscono sulla velocità.

Lo sviluppatore dell’app dice che il problema non è la sua app. E ora?

Può essere vero: la causa potrebbe essere un’altra app o il tema. Condividi con lui i risultati dei test sul tema duplicato e, se due sviluppatori si danno la colpa a vicenda, chiedi a qualcuno che può guardare l’intero negozio di individuare dove avviene il conflitto.