Risoluzione dei problemi di integrazione del tema
L'integrazione di ShopGuide con un tema procede senza problemi per la maggior parte del tempo, ma quando ciò non avviene, la causa è solitamente una delle poche cose prevedibili. Ecco come risolverli.
Il blocco della chat non viene visualizzato
Se manca nella categoria App dell'editor del tema o semplicemente non appare nelle pagine attive, procedi in questo ordine:
- Conferma che ShopGuide è installato e che il tuo abbonamento o prova è attivo (ShopGuide amministratore → Impostazioni/Fatturazione)
- Verifica che il tuo tema sia Negozio online 2.0: i temi più vecchi non supportano affatto i blocchi delle app; vedi Shopify nozioni di base sull'editor di temi
- Conferma che il blocco ShopGuide Chat sia effettivamente aggiunto alla pagina o al modello che stai guardando: un blocco viene visualizzato solo dove è stato posizionato
- Conferma che ** mette in pausa la chat a livello di negozio ** non è attivato (ShopGuide amministratore → Impostazioni)
- Svuota la cache del browser e aggiorna (Ctrl+F5/Cmd+Shift+R)
Se manca davvero dal modello, aggiungilo di nuovo: Aggiungi sezione → App → ShopGuide Chat. Se il blocco è presente ma non viene visualizzato nulla, controlla la console del browser per errori JavaScript e prova un browser diverso o una finestra di navigazione in incognito per escludere un'estensione.
Problemi di stile
Colori non corrispondenti al tuo marchio, contrasto debole o bolla che si sovrappone a un altro elemento fisso nella pagina (Un cassetto del carrello, una barra di aggiunta al carrello fissa, un banner di cookie, un navigatore mobile) tutto risale alle stesse poche correzioni: regola i colori e il modello di stile nella pagina Aspetto (vedi Aspetto della chat e branding), prova l'angolo opposto o attiva "Il negozio ha una barra di navigazione mobile" (vedi Posizionamento e layout della chat), oppure utilizza CSS personalizzati con i widget veri selettori per tutto ciò che le impostazioni non coprono (vedi Stile chat avanzato).
La chat si apre ma non risponde
Controlla che il limite di visitatori del tuo piano non sia stato raggiunto (ShopGuide admin → Billing), controlla la tua connessione, quindi apri la console del browser (F12) e cerca JavaScript o errori di rete. Il test in un browser diverso e con altre app dello storefront o blocchi degli annunci temporaneamente disabilitati esclude un conflitto. Vale anche la pena dare un'occhiata veloce: l'attivazione/disattivazione della pausa in tutto il negozio.
Alcune stranezze specifiche del browser
I blocchi degli annunci e le estensioni per la privacy bloccano occasionalmente lo script della chat o le sue richieste di rete: la modalità di navigazione in incognito con le estensioni disattivate è il modo più rapido per escluderlo. La protezione dal tracciamento di Safari e Firefox può interferire con tutto ciò che dipende dal consenso dell'analisi, come i messaggi proattivi, che vengono caricati solo una volta concesso il consenso: si tratta di un comportamento previsto legato alla privacy del cliente API di Shopify, non di un bug. E vale la pena confermare di utilizzare una versione del browser ragionevolmente aggiornata prima di intensificare ulteriormente qualsiasi cosa.
Su dispositivi mobili in particolare
Una bolla troppo piccola per essere toccata comodamente o una che si sovrappone a una barra di navigazione inferiore, di solito necessita solo di una ** Dimensione bolla più grande ** Impostazione ( Impostazioni → Bolla ) o "Il negozio ha la barra di navigazione mobile" attivato. Vale la pena testare una risposta più lenta su dispositivi più vecchi o di fascia bassa su un paio di telefoni reali piuttosto che fare affidamento solo sull'anteprima mobile dell'editor del tema.
Compatibilità dei temi
È richiesto il negozio online 2.0: i blocchi di app non esistono sulle architetture di temi precedenti. Dawn e altri temi attuali del Theme Store funzionano immediatamente. Un tema fortemente personalizzato o legacy potrebbe richiedere un aggiornamento prima che il blocco possa essere aggiunto del tutto; vedi Shopify nozioni di base sull'editor di temi.
Dopo qualsiasi aggiornamento del tema, vale la pena confermare tre cose: il blocco è ancora attaccato dove previsto, la bolla appare ancora e si apre correttamente e lo stile corrisponde ancora: gli aggiornamenti del tema occasionalmente ripristinano i CSS personalizzati inseriti altrove.
Scavando più a fondo
Nella console del browser (F12 su Chrome/Firefox, Sviluppa → Mostra console JavaScript su Safari), cerca gli errori dagli script di ShopGuide: secure-chat-core.js, chat-styles.css, ab-test-engine-bundle.js. Nella scheda Rete, filtra le richieste ai percorsi /apps/proxy/... o /apps/ai-agent-proxy/... del tuo negozio; una richiesta non riuscita o lenta di solito indica un problema di abbonamento, limite di velocità o connettività piuttosto che qualcosa correlato al tema.
Se tutto ciò non risolve il problema, contatta il supporto ShopGuide indicando il dominio .myshopify.com del tuo negozio, il nome del tema e se si tratta di Negozio online 2.0, il browser e la versione, eventuali messaggi di errore o screenshot della console e i passaggi per riprodurlo.