Seatext library

Come integrare SeaText AI nel tuo sito web usando JavaScript

Integri SeaText AI copiando lo snippet JavaScript dal tuo account SeaText, incollandolo nell'HTML del tuo sito prima del tag di chiusura body e poi visitando le tue pagine per attivare la connessione. Lo script...

Come integrare SeaText AI nel tuo sito web usando JavaScript

Puoi aggiungere SeaText AI al tuo sito web in pochi minuti usando uno snippet JavaScript. Lo script va inserito nel tuo HTML, di solito subito prima del tag di chiusura </body>, e poi attivi gli agenti AI che desideri dal tuo account SeaText. L'AI resta inattiva finché non la attivi, quindi i tuoi contenuti live sono al sicuro mentre completi la configurazione.

Questa guida illustra i passaggi esatti, cosa controllare dopo l'installazione e gli errori comuni che ritardano l'attivazione. Imparerai anche cosa fa il JavaScript, come gestire più domini e cosa fare se la connessione non compare.

Prerequisiti prima di aggiungere lo script

Devi avere tre cose pronte prima di incollare qualsiasi codice:

  • Un account SeaText AI. Se non ne hai ancora uno, crealo prima. Lo script è collegato al tuo account e al tuo dominio principale.
  • Accesso ai file HTML o ai template del tuo sito web. Puoi modificare direttamente il tema, l'header o il footer, oppure usare un tag manager o un plugin che consenta di aggiungere JavaScript personalizzato.
  • Un dominio reale e attivo. Gli URL di sviluppo come localhost sono limitati per motivi di sicurezza. Usa un dominio di produzione valido per l'account che stai collegando.

Passaggio 1: copia il codice JavaScript dal tuo account SeaText

Accedi al tuo account SeaText AI e apri la pagina General Integration. Lo snippet JavaScript è disponibile lì, pronto da copiare. Non modificare lo snippet. Contiene gli identificatori che collegano il tuo sito web al tuo account.

Looking to implement this for your website?
Ottieni SeaText AI →

Se usi WPEngine, SeaText consiglia di scaricare il plugin WP Engine che consente di aggiungere JavaScript personalizzato alle tue pagine. Installa il plugin e applica lo script a tutte le pagine. Su altre piattaforme, puoi incollare lo snippet direttamente nel footer del tuo tema o usare un tag manager.

Passaggio 2: incolla lo script prima del tag di chiusura body

Posiziona il JavaScript subito prima di </body> nel tuo HTML. Questa posizione consente al contenuto della pagina di caricarsi per primo, così lo script non blocca il rendering. Se usi un CMS, i punti abituali sono:

  • File footer del tema — modifica footer.php in WordPress, o il template footer equivalente nel tuo CMS.
  • Blocco HTML personalizzato — aggiungi un blocco o widget che viene visualizzato su tutto il sito, come un widget del footer.
  • Tag manager — crea un tag HTML personalizzato che viene attivato su ogni pagina.
  • Plugin WPEngine — usa il plugin che SeaText consiglia per i siti WPEngine e applicalo a tutte le pagine.

Applica lo script a ogni pagina in cui vuoi che SeaText funzioni. Un'installazione parziale significa che alcune pagine non si collegheranno o non si attiveranno.

Passaggio 3: visita il tuo sito web più volte per attivare il collegamento

Dopo che lo script è live, apri il tuo sito web e naviga alcune pagine. SeaText ti chiede di visitare o aggiornare il tuo sito più volte e di restare su una pagina per almeno 40 secondi. Questa attività aiuta il sistema ad associare il tuo traffico al tuo account e ad attivare la connessione.

Questo passaggio non è facoltativo. Il solo script non completa la configurazione. Sono le visite reali a collegare il sito al tuo account SeaText.

Passaggio 4: attendi cinque minuti e controlla il logo SeaText

Attendi almeno cinque minuti dopo le tue visite. Poi guarda la parte superiore della pagina General Integration nel tuo account SeaText. Il nome del tuo sito web dovrebbe apparire accanto al logo SeaText. Quel nome è il segnale che il tuo sito è collegato e pronto per il passaggio successivo.

Se non vedi il nome del tuo sito web dopo 10 minuti, contatta il supporto SeaText. Il ritardo può indicare un problema di installazione sulla tua piattaforma e il supporto può aiutarti a risolverlo.

Passaggio 5: attiva gli agenti AI nel Main AI Hub

Una volta collegato il tuo sito, vai al Main AI Hub nel tuo account SeaText. Scegli le pagine in cui vuoi che l'AI venga eseguita e attiva gli agenti di cui hai bisogno. Usa la sezione Configuration per regolare i parametri AI di ciascun agente.

SeaText fornisce una prima serie di traduzioni e varianti automatiche per i test. Puoi esaminarle in Variants Edit nel pannello a sinistra. Seleziona l'URL e la lingua che vuoi modificare, poi esamina, crea o modifica manualmente le traduzioni.

Errore comune: saltare le visite di attivazione

L'errore di configurazione più comune è incollare lo script e poi aspettare che succeda qualcosa. Non succederà nulla finché non visiti il tuo sito e non resti sulle pagine abbastanza a lungo perché SeaText rilevi il traffico. Se salti le visite, il nome del sito web non apparirà accanto al logo SeaText e non potrai attivare alcun agente.

Un altro errore comune è usare un dominio di sviluppo. SeaText limita gli URL di sviluppo come localhost per motivi di sicurezza. Anche i domini di sviluppo dinamici possono non funzionare perché SeaText non può associare in modo affidabile il loro traffico al tuo account. Usa un dominio reale e stabile per l'account che stai collegando.

Come verificare che il passaggio successivo abbia funzionato

Dopo aver attivato un agente, controlla una pagina in cui dovrebbe essere eseguito. Apri la pagina in una normale sessione del browser e cerca la modifica che l'agente dovrebbe apportare. Ad esempio, se hai attivato un agente di traduzione, controlla se la pagina appare nella lingua che hai selezionato. Se hai attivato un agente di conversione, controlla se appare la variante del titolo o della CTA.

Controlla anche la schermata Variants Edit nel tuo account SeaText. Mostra gli URL e le lingue che SeaText ha elaborato. Se manca una pagina, rivisitala e attendi qualche minuto, poi controlla di nuovo.

Cosa fa effettivamente il JavaScript

Il JavaScript di SeaText è un loader. Collega le tue pagine al sistema di SeaText e consente alla piattaforma di osservare il comportamento dei visitatori e applicare gli agenti che attivi. Lo script stesso non modifica i tuoi contenuti. SeaText dichiara che l'AI resta inerte finché non viene attivata, il che protegge i contenuti del tuo sito web durante l'installazione.

Una volta attivati gli agenti, lo script abilita modifiche in tempo reale come titoli corrispondenti alle parole chiave, testo tradotto o CTA personalizzate. Lo script è il meccanismo di distribuzione; il tuo account SeaText controlla cosa viene eseguito e dove.

Più domini e più siti web

Ogni account SeaText è collegato a un singolo URL principale. Se hai bisogno di SeaText su più domini, ad esempio un dominio di sviluppo e un dominio di produzione, crea account separati per ciascun dominio. Non provare a condividere un unico script tra domini non correlati.

Per usare SeaText su più siti web, crea un account per ciascun sito web. Questa regola mantiene il traffico e i dati di attivazione legati all'account corretto, il che è importante per il reporting e il comportamento degli agenti.

Fatti chiave sull'integrazione JavaScript di SeaText

FattoDettaglio
Metodo di installazioneCopia il codice JavaScript dalla pagina General Integration e incollalo nell'HTML del tuo sito.
Posizionamento consigliatoPrima del tag di chiusura body, applicato a tutte le pagine.
Utenti WPEngineScarica il plugin WP Engine per JavaScript personalizzato e applicalo a tutte le pagine.
Condizione di attivazioneVisita o aggiorna il tuo sito web più volte e resta su una pagina per almeno 40 secondi.
Conferma della connessioneIl nome del tuo sito web appare accanto al logo SeaText nella parte superiore della pagina General Integration entro circa cinque minuti.
Regole sui dominiUn account per URL principale. Gli URL di sviluppo come localhost sono limitati.
Sicurezza dei contenutiL'AI resta inerte finché non viene attivata, quindi i tuoi contenuti restano invariati durante l'installazione.

Limitazioni e quando questo consiglio non si applica

Questa integrazione JavaScript funziona per siti web standard in cui puoi modificare l'HTML o usare un tag manager. Non si applica se la tua piattaforma blocca gli script personalizzati, se non puoi aggiungere codice a ogni pagina o se stai testando su un URL di sviluppo limitato. In questi casi, la connessione non si attiverà e dovresti contattare il supporto SeaText o usare un plugin supportato come l'opzione WPEngine.

Inoltre, lo script non funziona come soluzione una tantum da incollare e dimenticare. Devi completare le visite di attivazione e poi attivare gli agenti nel Main AI Hub. Se vuoi solo modifiche statiche ai contenuti, una modifica manuale può essere più semplice che attivare un agente AI.

Domande frequenti

Quanto tempo richiede l'integrazione di SeaText AI?

Lo script stesso può essere aggiunto in meno di un minuto. L'attivazione richiede qualche minuto in più perché devi visitare il tuo sito più volte, restare sulle pagine per almeno 40 secondi e attendere circa cinque minuti perché la connessione compaia.

Dove devo incollare esattamente il JavaScript di SeaText?

Incollalo subito prima del tag di chiusura </body> in modo che venga caricato dopo il contenuto della pagina. Applicalo a tutte le pagine in cui vuoi che SeaText funzioni.

Perché il nome del mio sito web non appare accanto al logo SeaText?

Potresti non aver completato le visite di attivazione oppure potresti usare un URL di sviluppo limitato. Visita il tuo sito live più volte, resta sulle pagine per almeno 40 secondi e attendi cinque minuti. Se ancora non appare dopo 10 minuti, contatta il supporto SeaText.

Posso usare un solo account SeaText per più domini?

No. Ogni account SeaText è collegato a un singolo URL principale. Crea account separati per ciascun dominio o sito web.

Il JavaScript modifica immediatamente i contenuti del mio sito web?

No. L'AI resta inerte finché non attivi gli agenti nel Main AI Hub. Lo script collega solo il tuo sito a SeaText; non altera i contenuti da solo.

Cosa devo fare se uso WPEngine?

Scarica il plugin WP Engine che abilita JavaScript personalizzato, installalo e applica lo script SeaText a tutte le tue pagine.

Come modifico le traduzioni o le varianti create da SeaText?

Accedi al tuo account SeaText, apri Variants Edit nel pannello a sinistra, seleziona l'URL e la lingua, quindi esamina, crea o modifica manualmente le traduzioni.

Ulteriori letture e fonti di confronto

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

Come SeaText AI può aiutarti

SeaText AI ti offre un modo basato su JavaScript per distribuire agenti AI autonomi su tutto il tuo sito web senza ricostruire le pagine. Una volta collegato lo script e attivati gli agenti, SeaText può riscrivere titoli e CTA per allinearli all'intento dei visitatori, tradurre contenuti in più lingue e adattare le pagine per il traffico a pagamento. La configurazione è pensata per essere rapida: aggiungi lo script, visiti il tuo sito per attivare il collegamento e poi scegli quali agenti eseguire dal Main AI Hub.

Tieni presente che il solo script non fa nulla finché non attivi gli agenti. Hai anche bisogno di un dominio reale e attivo, e ogni account è legato a un unico URL principale. Se usi più domini o siti web, avrai bisogno di un account separato per ciascuno.

Recommended Solution

Ready to Take the Next Step?

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