Google Tag Manager (GTM) è uno strumento che ti consente di aggiungere e gestire snippet di codice sul tuo sito web senza modificare direttamente il codice del sito. Se il tuo sito utilizza già GTM, questo è il metodo consigliato per installare il web widget di Superchat.
Di seguito troverai le istruzioni passo-passo su come integrare il Web Widget di Superchat nel tuo Google Tag Manager.
Passo 1: Crea il tuo script del Web Widget
Clicca qui e seleziona Nuovo Web Widget.
Passo 2: Copia la applicationKey dallo script del Web Widget
Una volta creato il widget, Superchat visualizzerà uno script univoco per il tuo account. Sarà simile a questo:
<script src='https://widget.superchat.de/snippet.js?applicationKey=AAAAAAAAAAAAAAAAAAA' referrerpolicy='no-referrer-when-downgrade'></script>
Lo script mostrato sopra è solo un esempio — il tuo avrà una chiave applicationKey diversa. Non è necessario utilizzare direttamente questo script. Invece, individua la stringa di caratteri che appare dopo applicationKey= nel tuo script e copiala. Questa è la tua chiave applicationKey univoca, che incollerai nello script di GTM nel Passo 4.
Passo 3: Crea un nuovo tag in Google Tag Manager
Apri Google Tag Manager e seleziona il tuo contenitore
Nel menu a sinistra, clicca su Tag, poi su Nuovo
Assegna un nome al tuo tag, ad esempio "Superchat Web Widget"
Clicca sull'area Configurazione tag e seleziona HTML Personalizzato come tipo di tag
Passo 4: Aggiungi lo script di Superchat
Incolla il seguente script nel campo HTML, sostituendo XXXXXXXXXXXXXXXXX con la tua applicationKey del Passo 2:
<script>(function() {var script = document.createElement("script");script.type = "text/javascript";script.src = "https://widget.superchat.de/snippet.js?applicationKey=XXXXXXXXXXXXXXXXX";script.setAttribute("referrerpolicy","no-referrer-when-downgrade");document.body.appendChild(script);})();</script>
Passo 5: Imposta un trigger
Un trigger indica a GTM quando attivare il tuo tag — in altre parole, su quali pagine il widget deve essere caricato. Clicca sulla sezione Attivazione e seleziona Tutte le pagine. Questo assicura che il widget appaia su tutto il tuo sito web.
Se desideri che il widget appaia solo su alcune pagine, puoi creare un trigger personalizzato — ad esempio, per mostrarlo solo sulla pagina dei contatti o su quella dei prezzi.
Una volta configurato come desideri, puoi premere Salva.
Passo 6: Anteprima e verifica
Prima di pubblicare, è consigliabile verificare che il widget venga caricato correttamente. Clicca su Anteprima nell'angolo in alto a destra di GTM.
Successivamente, incolla semplicemente il URL in cui stai aggiungendo il Web Widget. Si aprirà una sessione di debug nel tuo browser, dove potrai visitare il tuo sito web e confermare che il widget di Superchat appaia come previsto. Potrai anche vedere nel pannello di debug di GTM se il tag è stato attivato correttamente.
Passo 7: Pubblica le modifiche
Una volta verificato che il widget venga caricato correttamente, torna su GTM e clicca su Invia nell'angolo in alto a destra.
Se richiesto, aggiungi un nome per la versione (ad esempio, "Aggiungi widget Superchat"), poi clicca su Pubblica. Il tuo widget sarà ora attivo sul tuo sito web.
Risoluzione dei problemi
Risoluzione dei problemi
Il widget non appare sul mio sito web
Verifica di aver pubblicato il contenitore GTM dopo aver salvato il tag — le modifiche in GTM non diventano attive finché non clicchi su Invia e Pubblica. Conferma inoltre che il trigger sia impostato su Tutte le pagine e che la applicationKey nello script corrisponda a quella nelle impostazioni del widget di Superchat.
Il tag non viene attivato in modalità Anteprima di GTM
Assicurati che il trigger sia configurato correttamente e che tu stia visitando una pagina che soddisfa le condizioni del trigger. Se stai utilizzando un trigger personalizzato, ricontrolla che le regole siano impostate come previsto.
Non sono sicuro di aver copiato la applicationKey corretta
Torna su Impostazioni → Web Widget in Superchat, apri il widget che hai creato e copia nuovamente lo script completo. La applicationKey è tutto ciò che segue applicationKey= e precede il segno di chiusura delle virgolette.