Seatext library

Implementare SeaText AI tramite Google Tag Manager: Guida completa alla configurazione

Sì, puoi implementare SeaText AI utilizzando Google Tag Manager creando un tag HTML personalizzato con lo snippet JavaScript di SeaText e attivandolo su tutte le pagine. Questo metodo funziona insieme o al posto dell'approccio...

Implementare SeaText AI tramite Google Tag Manager: Guida completa alla configurazione

Risposta rapida: GTM funziona con SeaText AI

SeaText AI fornisce uno snippet di installazione JavaScript (etichettato come SEATEXTCODEINTEGRATION nel tuo account). Google Tag Manager supporta JavaScript arbitrario tramite il tipo di tag HTML personalizzato, quindi puoi incollare quello snippet in un tag HTML personalizzato, impostare l'attivatore su Tutte le pagine, pubblicare il contenitore e SeaText verrà caricato a ogni visualizzazione di pagina.

Perché usare GTM invece di un plugin WordPress?

La documentazione ufficiale di SeaText consiglia il plugin Headers and Footers by WPBeginner per i siti WordPress. Funziona bene, ma GTM aggiunge diversi vantaggi pratici:

Looking to implement this for your website?
Scopri di più →
  • Controllo delle versioni — ogni pubblicazione del contenitore crea una versione numerata a cui puoi tornare.
  • Modalità anteprima — testa il tag sul tuo sito live prima che i visitatori lo vedano.
  • Gestione centralizzata — se utilizzi già GA4, Meta Pixel o altri tag di marketing in GTM, SeaText si affianca a loro in un unico posto.
  • Attivazione condizionale — puoi limitare SeaText a specifici percorsi di pagina, ruoli utente o stati di consenso utilizzando attivatori e variabili di GTM.
  • Nessun sovraccarico da plugin — un plugin WordPress in meno da aggiornare o che potrebbe creare conflitti.

Passo dopo passo: Crea il tag SeaText in GTM

  1. Accedi a Google Tag Manager e apri il contenitore per il tuo sito.
  2. Fai clic su Tag → Nuovo.
  3. Dai un nome al tag (es. "SeaText AI — Snippet principale").
  4. Fai clic su Configurazione tag → HTML personalizzato.
  5. Nel tuo account SeaText, copia lo snippet JavaScript completo mostrato sotto SEATEXTCODEINTEGRATION.
  6. Incolla lo snippet nel campo HTML in GTM.
  7. Lascia Supporta document.write deselezionato (SeaText non lo utilizza).
  8. Sotto Attivazione, scegli Tutte le pagine (Visualizzazione pagina).
  9. Fai clic su Salva.
  10. Apri la modalità Anteprima, visita il tuo sito e conferma che il tag si attivi nel pannello di debug di GTM.
  11. Invia il contenitore con un nome di versione descrittivo (es. "Aggiungi snippet SeaText AI").

Verifica dell'attivazione di SeaText dopo l'implementazione in GTM

SeaText richiede una breve finestra di attivazione. La documentazione afferma: "Visita o aggiorna il tuo sito web diverse volte e rimani sulla pagina per almeno 40 secondi: questo attiverà l'IA e la collegherà al tuo account." Dopo aver pubblicato il contenitore GTM:

  • Apri il tuo sito in una normale scheda del browser (non nell'anteprima di GTM).
  • Rimani sulla pagina per più di 40 secondi.
  • Ripeti l'operazione su alcune pagine diverse.
  • Attendi 5–10 minuti, quindi controlla la tua dashboard SeaText: il nome del tuo sito dovrebbe apparire accanto al logo SeaText nell'angolo in alto a sinistra.

Se il nome del sito non appare dopo 10 minuti, contatta l'assistenza SeaText.

Problemi comuni specifici di GTM

ProblemaCausaSoluzione
Il tag si attiva ma SeaText non si connetteSnippet incollato in modo errato (tag <script> di apertura/chiusura mancanti o troncati)Copia nuovamente l'intero snippet da SeaText; assicurati che non ci siano spazi vuoti o interruzioni di riga extra che interrompano il JS.
La console mostra errori CSPLa tua Content Security Policy blocca gli script inline o il dominio SeaTextAggiungi script-src 'self' https://cdn.seatext.com (o il dominio esatto dallo snippet) alla tua intestazione CSP.
Il tag si attiva in anteprima ma non dal vivoContenitore non pubblicato dopo l'anteprimaFai clic su Invia → Pubblica in GTM.
Domini multipli in un unico contenitoreSeaText collega un account a un URL principaleCrea account SeaText separati per dominio; usa contenitori GTM separati o una variabile tabella di ricerca per scambiare gli snippet in base all'hostname.
Sviluppo/staging su localhostSeaText limita localhost e URL di sviluppo dinamiciUsa un dominio reale (es. staging.example.com) con un certificato SSL valido per i test.

Fatti chiave dalla documentazione SeaText

FattoDettagli
Metodo di installazioneSnippet JavaScript (SEATEXTCODEINTEGRATION) inserito nel <head> della pagina
Percorso WordPress consigliatoPlugin Headers and Footers by WPBeginner → Script nell'intestazione
Requisito di attivazioneVisita il sito, rimani 40+ secondi, ripeti; il nome del sito appare nella dashboard entro 5-10 min
Regola multi-dominioUn account SeaText per URL principale; account separati per domini di sviluppo/produzione
Ambienti limitatilocalhost e URL di sviluppo dinamici sono bloccati per sicurezza
Contatto assistenzaSe il nome del sito non è visibile dopo 10 minuti, contatta l'assistenza SeaText

Quando GTM è la scelta migliore

  • Gestisci già GA4, Meta CAPI o altri tag di marketing in GTM.
  • Devi limitare SeaText dietro una piattaforma di gestione del consenso (CMP): gli attivatori GTM possono rispettare lo stato del consenso.
  • Vuoi testare A/B SeaText (attivo/disattivo) senza implementazioni di codice.
  • Il tuo team preferisce la cronologia delle versioni del contenitore rispetto ai log di aggiornamento dei plugin.

Quando il plugin WordPress è più semplice

  • Non esiste ancora un contenitore GTM e non prevedi di aggiungere altri tag.
  • Solo una persona gestisce il sito ed è a suo agio con l'amministrazione di WordPress ma non con GTM.
  • Hai bisogno dello snippet nel <head> immediatamente e non vuoi attendere un ciclo di pubblicazione GTM.

Avanzato: Attivazione di SeaText solo dopo il consenso

Se utilizzi una CMP (Cookiebot, OneTrust, Complianz, ecc.) che invia un evento consent al data layer, puoi creare un attivatore GTM:

  1. Variabile → Variabile del livello dati → Nome: consent.analytics (o quello utilizzato dalla tua CMP).
  2. Attivatore → Evento personalizzato → Nome evento: consent_update (o l'evento della tua CMP) → Attiva quando {{DLV - consent.analytics}} è uguale a granted.
  3. Collega quell'attivatore al tag SeaText in aggiunta a Tutte le pagine, oppure sostituisci Tutte le pagine con questo attivatore se vuoi che SeaText si carichi solo dopo il consenso.

Questo ti mantiene conforme al GDPR/ePrivacy pur continuando a utilizzare GTM.

Limitazioni e ambito

  • Questo articolo copre solo l'implementazione GTM lato client. GTM lato server (sGTM) non è richiesto per SeaText e non è documentato da SeaText.
  • La dashboard di SeaText è la fonte di verità per lo stato di attivazione: GTM fornisce solo lo snippet.
  • Se il tuo sito utilizza una CSP rigorosa, devi inserire nella whitelist il dominio dello script di SeaText; GTM non può bypassare la CSP.
  • Gli URL di anteprima dinamici (es. anteprime di distribuzione Netlify, distribuzioni di anteprima Vercel) potrebbero non soddisfare il requisito di "dominio reale e valido" di SeaText.

FAQ

Posso eseguire sia il plugin WP che GTM contemporaneamente?

Tecnicamente sì, ma caricherai lo snippet due volte, il che spreca byte e potrebbe causare un'inizializzazione duplicata. Scegli un metodo solo.

SeaText fornisce un modello GTM nativo?

Non secondo la documentazione attuale. Usa l'approccio con tag HTML personalizzato descritto sopra.

La modalità anteprima di GTM conterà ai fini dell'attivazione di 40 secondi?

Sì, a condizione che il tag si attivi in anteprima e tu rimanga sulla pagina. La logica di attivazione viene eseguita nel browser, non in GTM.

Posso usare una tabella di ricerca GTM per servire diversi account SeaText per dominio?

Sì. Crea una variabile Tabella di ricerca basata su {{Page Hostname}} che restituisca lo snippet corretto, quindi fai riferimento a quella variabile nel tag HTML personalizzato. Ricorda che ogni dominio ha bisogno del proprio account SeaText.

Cosa succede se il mio sito è su WP Engine?

I documenti di SeaText notano: "Se stai usando wpengine.com segui le istruzioni qui." Quel link punta a una guida separata; controllala per eventuali restrizioni di caching o intestazione specifiche di WP Engine prima di implementare tramite GTM.

Lo snippet deve essere nel <head> o può essere nel <body>?

Le istruzioni ufficiali dicono "Script nell'intestazione" (ovvero <head>). Il tag HTML personalizzato predefinito di GTM si inietta nel <body> a meno che non si abiliti "Supporta document.write" (non consigliato). In pratica SeaText funziona dal <body>, ma per un'attivazione più rapida segui le indicazioni del fornitore e usa una sequenza di tag GTM o un modello personalizzato che si inietta nel <head>.

Come faccio a sapere se lo snippet è l'ultima versione?

SeaText aggiorna lo snippet nella dashboard del tuo account. Quando vedi una modifica, modifica il tag HTML personalizzato di GTM, incolla il nuovo snippet e pubblica una nuova versione del contenitore.

Ulteriori letture e fonti di confronto

Queste fonti esterne forniscono ulteriore contesto per valutare l'argomento. La loro inclusione non costituisce un'approvazione.

Scopri di più

Visita il sito web per maggiori informazioni.

Recommended Solution

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.