Scopo: aggiungere snippet di codice personalizzati (JavaScript, CSS, HTML) nelle sezioni <head> o <body> di tutte le pagine del Web Store. Questo strumento è pensato per utenti esperti che necessitano di estendere le funzionalità del sito.
Destinatari: amministratori esperti, sviluppatori web, responsabili marketing.
Quando serve: per integrare servizi di terze parti non nativamente supportati, come widget di chat, pixel di tracciamento (es. Meta Pixel), servizi di heatmap (es. Hotjar) o stili CSS personalizzati.
Introduzione
In questo articolo, scoprirai come utilizzare la sezione "Script personalizzato" per aggiungere codice al tuo Web Store. Questa funzionalità ti offre la massima flessibilità per integrare strumenti esterni e personalizzare ulteriormente l'esperienza utente, ma va usata con cautela.
Come accedere
Fai clic sull'icona Impostazioni (ingranaggio) nel menu di navigazione principale.
Dal menu a sinistra, seleziona Impostazioni di Sistema > Impostazioni Web Store.
Seleziona la voce Script personalizzato dal menu a sinistra.
Overview interfaccia
La schermata è molto semplice e presenta due campi di testo principali, corrispondenti a due punti strategici del codice HTML di ogni pagina del tuo sito.
Configurare gli Script
Script code body
Scopo: Il codice inserito in questo campo verrà iniettato subito dopo il tag di apertura
<body>in tutte le pagine del tuo sito.Utilizzo tipico: È la posizione ideale per gli script che devono caricare elementi visibili o interagire con il contenuto della pagina, come i widget di chat (es. Tawk.to, Zendesk Chat) o la parte
<noscript>degli script di Google Tag Manager.
Script code head
Scopo: Il codice inserito qui verrà iniettato all'interno del tag
<head>di tutte le pagine.Utilizzo tipico: È la posizione corretta per la maggior parte degli script di tracciamento e analisi, come il Meta Pixel (Facebook/Instagram), i pixel di LinkedIn, i codici di verifica di proprietà del dominio (diversi dal caricamento file) e per l'inclusione di font personalizzati o fogli di stile CSS esterni.
FAQ & Esempi pratici
Voglio installare il Meta Pixel (Facebook Pixel) per tracciare le conversioni sul mio e-commerce. Dove devo incollare il codice che mi fornisce Facebook?
Il codice base del Meta Pixel deve essere caricato su ogni pagina del tuo sito. La posizione corretta per incollarlo è il campo Script code head. Questo assicura che lo script sia presente in tutto il sito e possa tracciare correttamente le visite, gli eventi (come "Aggiungi al carrello") e le conversioni finali.
Ho uno script per un widget di una chat dal vivo (es. Tawk.to, Crisp). Lo metto nel body o nell' head?
La stragrande maggioranza dei servizi di chat consiglia di inserire il proprio codice subito prima della chiusura del tag . Poiché qui abbiamo un campo per l'inizio del body, la posizione corretta e più sicura è il campo Script code body. Questo garantisce che il widget venga caricato dopo gli elementi principali della pagina, senza rallentarne il rendering iniziale.
Ho inserito uno script, ma dopo aver salvato il sito mostra una pagina bianca o non funziona più correttamente. Come risolvo l'emergenza?
Questo è un classico sintomo di un errore JavaScript che blocca il rendering della pagina. La soluzione immediata è:
Torna subito in questa sezione.
Cancella completamente il codice che hai inserito.
Salva le modifiche.
Questo dovrebbe ripristinare immediatamente il funzionamento del sito. Prima di reinserire lo script, controllalo attentamente per errori di sintassi (es. un tag “script" non chiuso) o prova a incollarlo prima in un validatore di codice online.
Posso usare questa sezione per cambiare l'aspetto del mio sito, ad esempio il colore di un pulsante?
Tecnicamente sì, ma non è la procedura consigliata. Potresti inserire del codice CSS personalizzato all'interno di tag style nel campo Script code head. Tuttavia, questo rende la manutenzione difficile. La procedura corretta per le modifiche grafiche è agire direttamente sui file CSS del template, come descritto nella sezione 1.3.5 Personalizzare i Template del Web Store (CMS). Usa questa sezione solo per script esterni.
Se ho già installato Google Analytics tramite la sezione "Google Analytics/Tag Manager/Maps", devo inserire di nuovo lo script qui?
No, assolutamente. Sarebbe un errore che porterebbe a un doppio tracciamento e a dati inaffidabili. Se hai già configurato Google Analytics o Google Tag Manager nelle loro sezioni dedicate, non devi inserire i loro script anche qui. Questa sezione serve solo per gli script che non hanno una loro area di integrazione nativa.