Come installare SeaText AI su un sito web con codice personalizzato: guida passo passo

Cosa ti serve prima di iniziare

Installare SeaText AI su un sito con codice personalizzato richiede alcuni elementi:

• Un account SEATEXT AI – Puoi crearne uno gratuitamente nella pagina dei prezzi.
• Accesso all'HTML del tuo sito web – Devi essere in grado di modificare il codice sorgente, tipicamente tramite un client FTP, un editor di codice o il pannello di controllo del tuo hosting.
• Un dominio valido e reale – URL di sviluppo come localhost o domini di staging dinamici non sono supportati. Usa un dominio di produzione o un dominio di test reale.
• Un account per dominio – Se prevedi di installare su più siti, devi creare account separati per ciascuno.
• Per gli utenti WPEngine – Installa il plugin WP Engine per aggiungere JavaScript personalizzato se non puoi modificare direttamente i file del tema.

Processo di installazione passo passo

Passo 1: Crea un account SEATEXT AI

Vai alla homepage di SEATEXT AI e registrati. Avrai bisogno di un'email valida e di un URL primario per il tuo sito web. Ogni account è legato a un singolo dominio, quindi scegli l'URL esatto che utilizzerai. Se hai più domini, crea un account separato per ciascuno.

Passo 2: Copia il codice JavaScript

Dopo aver effettuato l'accesso, vai alla sezione General Integration. Lì troverai uno snippet JavaScript univoco. Copialo esattamente come mostrato. Non modificare il codice. Lo snippet contiene l'ID del tuo account e le impostazioni.

Passo 3: Inserisci il codice nel tuo sito web

Apri il file HTML del tuo sito web (o il file template se usi un CMS). Trova il tag di chiusura </body>. Incolla lo snippet JavaScript copiato subito prima di quel tag. Salva il file. Se hai più pagine, assicurati che lo snippet sia incluso in ogni pagina in cui vuoi che SeaText funzioni. Molti siti utilizzano un template footer comune – inseriscilo lì una volta.

Passo 4: Distribuisci le modifiche

Carica il file modificato sul tuo server o pubblica le modifiche tramite la tua piattaforma di hosting. Il codice è sicuro e rimane inattivo finché non lo attivi, quindi nessun contenuto cambierà ancora.

Passo 5: Visita il tuo sito web più volte

Apri il tuo sito in un browser. Visitalo più volte e rimani sulla pagina per almeno 40 secondi ogni volta. Questo passaggio collega l'AI al tuo account e conferma che lo script è caricato. Un caricamento rapido della pagina non attiverà la connessione.

Passo 6: Attendi la conferma

Consenti fino a 5 minuti. Poi controlla la tua dashboard SEATEXT AI. Dovresti vedere il nome del tuo sito web visualizzato accanto al logo SEATEXT nella parte superiore della pagina. Se non appare dopo 10 minuti, contatta il supporto.

Passo 7: Attiva gli agenti AI

Una volta che il tuo sito è connesso, vai al Main AI Hub. Lì puoi attivare gli agenti AI specifici di cui hai bisogno (ad esempio, CRO Optimizer, Google Ads Agent, Translation Agent). Usa il pannello Configuration per regolare i parametri. Puoi anche modificare manualmente le varianti in seguito.

Come funziona l'installazione: meccanica e perché è importante

Lo snippet JavaScript è uno script leggero che si carica quando un visitatore apre la tua pagina. Non cambia l'aspetto del tuo sito finché non attivi un agente. Lo script comunica con i server SeaText per associare il tuo account e tracciare le visite. Ecco perché devi visitare il tuo sito dopo l'installazione – lo script deve vedere un visitatore reale dal dominio del tuo account per collegare i due.

Perché è importante? Senza il passaggio di attivazione, l'AI rimane inerte. Il tuo sito rimane esattamente com'è. Il tempo di permanenza di 40 secondi garantisce che lo script abbia tempo sufficiente per caricarsi e inviare dati. L'attesa di 5 minuti consente al server di elaborare la visita e aggiornare la dashboard.

Questo processo è progettato per essere sicuro. Lo script è legato al tuo account. Nessun altro può usarlo. E si attiva solo quando scegli di attivare gli agenti dalla dashboard.

Come verificare l'installazione

Dopo aver completato i passaggi, conferma che l'integrazione funzioni:

• Controlla la tua dashboard SEATEXT per l'indicatore di connessione verde accanto al tuo dominio.
• Apri la console del browser del tuo sito web (F12) e cerca eventuali errori dallo script SeaText.
• Attiva una visita di test digitando una parola chiave che corrisponde a una campagna pubblicitaria – la pagina dovrebbe adattarsi in tempo reale se hai attivato il Google Ads Agent.

Se non vedi il nome del dominio nella dashboard dopo 10 minuti, il codice potrebbe non essere posizionato correttamente. Ricontrolla il punto di inserimento e assicurati che il file sia salvato. Cancella la cache del browser e riprova. Contatta il supporto se ancora non funziona.

Fatti chiave sull'installazione di SeaText AI

Errori comuni e come evitarli

• Usare lo stesso account per più domini – Ogni account SEATEXT è legato a un URL primario. Se devi installare su più di un sito, crea account separati.
• Posizionare il codice nel posto sbagliato – Lo snippet deve andare prima del tag di chiusura </body>. Posizionarlo nel <head> o altrove potrebbe compromettere la funzionalità.
• Non aspettare abbastanza – Il processo di attivazione richiede di visitare il sito e rimanere per almeno 40 secondi. Un caricamento rapido della pagina non attiverà la connessione.
• Usare un URL di sviluppo – localhost o domini di staging dinamici sono bloccati. Usa un dominio reale o un dominio di test statico.
• Dimenticare di aggiornare dopo l'inserimento del codice – Dopo aver incollato il codice, devi aggiornare la pagina per caricare lo script. Inoltre, cancella eventuali cache del server se applicabile.
• Non includere lo snippet su tutte le pagine – Se vuoi che SeaText funzioni su ogni pagina, lo snippet deve essere presente su ogni pagina. Usa un template comune per evitare pagine mancanti.

Limitazioni e quando questo consiglio non si applica

Questo metodo di installazione funziona solo per siti web in cui hai accesso diretto al codice sorgente HTML. Se usi una piattaforma come WPEngine, potresti aver bisogno di un plugin per aggiungere JavaScript personalizzato (il pacchetto sorgente raccomanda il plugin WP Engine). Per altri CMS o website builder, fai riferimento alle loro guide di integrazione specifiche.

SeaText AI non supporta domini di sviluppo dinamici (ad esempio, quelli generati da Heroku, anteprime Netlify o localhost). Se sei in fase di sviluppo iniziale, usa un sottodominio accessibile pubblicamente.

Ogni account può gestire solo un URL primario. Se hai più domini, devi creare un account separato per ciascuno. Questa è una misura di sicurezza e integrità dei dati.

Un'altra limitazione: lo script si basa su JavaScript. Se il tuo sito ha una Content Security Policy (CSP) rigorosa che blocca gli script esterni, potresti dover aggiungere alla whitelist il dominio SeaText. Verifica con il tuo sviluppatore o provider di hosting.

Infine, i passaggi di installazione presuppongono che tu abbia competenze di base nella modifica HTML. Se non ti senti a tuo agio nel modificare il codice, chiedi aiuto a uno sviluppatore o usa un approccio basato su plugin.

Domande frequenti

Ho bisogno di competenze tecniche per installare SeaText AI?

È sufficiente una capacità di base di modifica HTML. Devi sapere dove si trova il tag </body> nel template del tuo sito. La maggior parte degli sviluppatori o proprietari di siti può farlo in meno di un minuto.

Quanto tempo richiede l'attivazione?

Dopo aver inserito il codice, devi visitare il tuo sito più volte e rimanere per almeno 40 secondi. Poi attendi fino a 5 minuti affinché la dashboard mostri la connessione. In rari casi, potrebbe richiedere fino a 10 minuti.

Posso usare SeaText AI su un sito di staging?

Solo se il sito di staging utilizza un dominio pubblico e reale. Domini dinamici o localhost non sono consentiti. Se devi testare, usa un sottodominio come test.yourdomain.com.

Cosa succede se non vedo il mio dominio nella dashboard?

Prima, ricontrolla che il codice sia posizionato correttamente subito prima del tag di chiusura </body>. Poi cancella la cache del browser e riprova. Se ancora non appare dopo 10 minuti, contatta il supporto SEATEXT.

Posso installare SeaText AI su più pagine?

Sì. Lo snippet JavaScript deve essere incluso in ogni pagina in cui vuoi che SeaText funzioni. Se hai un template comune, inseriscilo lì una volta.

L'installazione è sicura?

Sì. Lo script è inerte finché non lo attivi dalla tua dashboard. Non modifica automaticamente i tuoi contenuti. Il processo di installazione è sicuro e non influisce sulle prestazioni del tuo sito.

Cosa succede dopo l'installazione?

Una volta confermata la connessione, puoi andare al Main AI Hub per attivare gli agenti di cui hai bisogno. Ogni agente ha la propria configurazione – ad esempio, il Google Ads Agent riscrive le landing page in base alle parole chiave, e il CRO Optimizer esegue test A/B su titoli e CTA. Puoi anche modificare manualmente le varianti generate.

Posso usare lo stesso account per un dominio di sviluppo e uno di produzione?

No. Ogni account è collegato a un URL primario. Crea un account separato per ogni dominio. Questa è una misura di sicurezza.

Cosa succede se il mio sito usa un CMS come WordPress?

Questa guida è per siti con codice personalizzato. Se usi WordPress, usa un plugin come Insert Headers and Footers o l'editor del tema integrato. Per altri CMS, fai riferimento alle loro guide di integrazione specifiche.