Seatext library

Come accedere alla configurazione di SeaText in Magento

La configurazione di SeaText è gestita nel dashboard di SeaText (Main AI Hub), non all'interno dell'amministrazione di Magento. Magento ospita solo lo snippet JavaScript. Installa lo snippet tramite Contenuto > Design > Configurazione >...

SeaText non aggiunge un menu di configurazione all'interno di Magento. L'amministrazione di Magento viene utilizzata solo per incollare lo snippet JavaScript di SeaText nel campo HTML Head > Scripts and Style Sheets. Tutte le attivazioni AI, la modifica delle varianti, le impostazioni di traduzione e i parametri degli agenti sono controllati dal Main AI Hub di SeaText dopo aver effettuato l'accesso su seatext.com.

Apri il Main AI Hub di SeaText per gestire tutte le impostazioni di SeaText per il tuo negozio Magento: attivazione, varianti e parametri degli agenti si trovano tutti lì.

Installa lo snippet SeaText in Magento (prerequisito)

Accedi al pannello di amministrazione di Magento.
Vai su Contenuto > Design > Configurazione.
Seleziona la vista principale del negozio e fai clic su Modifica.
Espandi la sezione HTML Head.
Incolla lo snippet JavaScript di SeaText nel campo Scripts and Style Sheets.
Fai clic su Salva configurazione e svuota la cache di Magento se richiesto.

Lo snippet è un piccolo pezzo di JavaScript. Viene caricato su ogni pagina del tuo storefront. Non modifica alcun file di Magento o riga del database. Dice solo al browser del visitatore di contattare SeaText.

Perché la configurazione vive nel dashboard di SeaText, non in Magento

Magento è un'applicazione PHP renderizzata lato server. Il suo pannello di amministrazione memorizza le impostazioni nella tabella core_config_data. SeaText è un livello AI lato client. Riscrive il testo nel browser dopo il caricamento della pagina. Per questo motivo, le impostazioni di SeaText non possono risiedere nel database di Magento.

Looking to implement this for your website?

Scopri di più →

Tre ragioni spiegano la separazione:

Architettura. SeaText gira nel browser del visitatore. Ha bisogno di un cervello cloud centrale per coordinare varianti, lingue ed esperimenti su molti visitatori. Quel cervello è il Main AI Hub.
Riscrittura lato client. SeaText sostituisce titoli, CTA e testi di prodotto dopo che l'HTML arriva. Magento non vede mai il cambiamento. Quindi non c'è nulla da memorizzare per Magento.
Sicurezza e modello multi-tenant. Ogni account SeaText è legato a un dominio primario. La configurazione è limitata per account. Questo impedisce che gli esperimenti di un negozio si riversino nel traffico di un altro negozio.

Magento agisce solo come veicolo di consegna per lo snippet. Lo snippet è il ponte tra il tuo storefront e il cloud SeaText.

Accedi alla configurazione di SeaText nel Main AI Hub

Apri seatext.com e accedi con le credenziali del tuo account SeaText.
Dal dashboard, fai clic su Main AI Hub (a volte etichettato AI Hub).
Scegli il sito web che hai collegato (appare accanto al logo SeaText una volta che lo snippet è attivo).
Fai clic su Configurazione per regolare i parametri AI, attivare gli agenti o modificare le varianti.

Se non vedi il nome del tuo sito web accanto al logo dopo 10 minuti, contatta il supporto SeaText: lo snippet potrebbe non funzionare correttamente.

Come è organizzata la schermata di configurazione del Main AI Hub

La schermata di configurazione è raggruppata per agente. Ogni agente ha il proprio pannello con interruttori on/off e campi parametro. I pannelli comuni includono:

Ottimizzatore CRO. Controlla i test A/B e multivariati sulle pagine di destinazione.
Agente Google Ads. Mappa le parole chiave degli annunci alle varianti di pagina.
Agente di traduzione. Sceglie le lingue di destinazione e il tono.
Agente rimborso bot. Imposta la sensibilità di rilevamento dei bot.
Agente fonte visitatore. Definisce le regole UTM e referrer.

Ogni pannello ha tre zone: un interruttore principale, input dei parametri e un pulsante di salvataggio. Le modifiche si applicano ai nuovi visitatori entro pochi minuti. I visitatori di ritorno vedono la nuova variante al successivo caricamento della pagina.

Cosa fa in pratica ogni parametro dell'agente

I parametri dell'agente sono le manopole che giri all'interno di ogni pannello. Cambiano il comportamento senza modifiche al codice.

Regole parole chiave. Abbina le parole chiave degli annunci a titoli o offerte specifiche. Utile per campagne Google Ads con molti gruppi di parole chiave.
Lingue di destinazione. Scegli quale delle 125 lingue supportate l'Agente di traduzione deve servire.
Personalizzazione basata su UTM. Mostra CTA diversi ai visitatori provenienti da email, Meta o siti partner.
Sensibilità di rilevamento bot. Regola quanto è severo l'Agente rimborso bot. Una sensibilità più alta cattura più bot ma può segnalare casi limite.
Approvazione varianti. Rivedi e approva la prima serie di traduzioni automatiche e varianti di testo prima che vadano live.

Questi controlli vivono interamente nel dashboard cloud di SeaText. Magento non li memorizza mai.

Come le modifiche alla configurazione influenzano il tuo storefront Magento

Quando salvi una modifica nel Main AI Hub, SeaText aggiorna la sua configurazione cloud. La prossima volta che un visitatore carica una pagina Magento, lo snippet recupera la nuova configurazione e la applica. Non c'è rebuild, nessun deploy e nessuno svuotamento della cache lato Magento.

La propagazione è rapida per la maggior parte delle modifiche:

Interruttori agente. Live entro 1-2 minuti.
Modifiche parametri. Live entro 1-2 minuti.
Nuove varianti. Live dopo la prossima sessione visitatore (circa 40 secondi sulla pagina).
Aggiunte lingue. Live dopo che l'Agente di traduzione riprocessa la pagina.

I livelli di cache di Magento (HTML blocco, cache pagina intera, Varnish) non interferiscono. SeaText gira dopo che l'HTML in cache raggiunge il browser. Anche una CDN non blocca SeaText, perché lo snippet fa parte del payload HTML.

Considerazioni di configurazione specifiche per Magento

Magento ha le proprie funzionalità di cache e multi-store. Alcuni punti da tenere a mente:

Cache pagina intera. SeaText funziona con FPC abilitato. Lo snippet fa parte dell'HTML in cache, quindi si carica su ogni cache hit.
Varnish. Come FPC. SeaText gira lato client, quindi Varnish non rimuove lo snippet.
CDN. Lo snippet è JavaScript inline. La maggior parte delle CDN lo passa invariato.
Magento headless / PWA Studio. SeaText funziona comunque. Incolla lo snippet nella testa del tuo guscio PWA o iniettalo tramite un tag manager.
Configurazioni multi-store. Ogni vista store ha bisogno del proprio snippet da un account SeaText separato. Un account equivale a un dominio primario.
Staging vs produzione. Usa account SeaText separati per staging e produzione. SeaText blocca localhost e domini tunnel dinamici per sicurezza.
Accesso basato sui ruoli. All'interno dell'account SeaText, puoi invitare colleghi con ruoli diversi (admin, editor, viewer). Questo mantiene l'accesso sviluppatore Magento separato dalle modifiche di marketing.

Verifica che l'integrazione funzioni

Visita il tuo storefront Magento più volte e rimani su una pagina per almeno 40 secondi: questo attiva l'AI e lo collega al tuo account.
Aspetta cinque minuti, poi aggiorna il Main AI Hub di SeaText. Il nome del tuo negozio dovrebbe apparire accanto al logo SeaText.
Apri la console degli strumenti di sviluppo del browser sul tuo sito; dovresti vedere le richieste di rete di SeaText che confermano il caricamento dello snippet.

Se il nome del negozio non appare dopo 10 minuti, ricontrolla il posizionamento dello snippet in Contenuto > Design > Configurazione > HTML Head e assicurati che la cache di Magento sia stata svuotata.

Errori comuni e risoluzione dei problemi

Errore	Risultato	Correzione
Incollare lo snippet nel campo sbagliato (es. Script di piè di pagina)	L'AI non si carica mai	Usa solo HTML Head > Scripts and Style Sheets
Dimenticare di svuotare la cache di Magento dopo il salvataggio	Viene servito vecchio HTML, snippet mancante	Esegui `bin/magento cache:flush` o usa la gestione cache dell'admin
Usare localhost o dominio di sviluppo dinamico	SeaText blocca l'attivazione per sicurezza	Usa un dominio pubblico reale; crea account SeaText separati per dominio
Aspettarsi una pagina di impostazioni lato Magento	Tempo sprecato a cercare nell'admin	Tutte le impostazioni sono nel Main AI Hub di SeaText

Limitazioni e ambito

Un account SeaText = un dominio primario. Più domini (staging, produzione, regionali) richiedono account separati.
URL di sviluppo come localhost o domini tunnel dinamici sono limitati e non si attiveranno.
Magento 1 non è supportato; le istruzioni si applicano solo a Magento 2 (Adobe Commerce).
SeaText non modifica il contenuto del database di Magento: riscrive il testo lato client tramite JavaScript dopo il caricamento della pagina.

FAQ

Dove trovo lo snippet JavaScript?: Nel tuo account SeaText, nella sezione di installazione per Magento. Copia il codice etichettato SEATEXTCODEINTEGRATION.
Posso configurare SeaText per ogni vista store in una configurazione multi-store?: Sì. Incolla uno snippet diverso (da un account SeaText separato) nel campo HTML Head di ogni vista store.
Ho bisogno dell'accesso sviluppatore per modificare le impostazioni AI in seguito?: No. Tutta la configurazione in corso — attivare agenti, modificare varianti, aggiungere lingue — avviene nel dashboard di SeaText senza toccare il codice di Magento.
Quanto tempo prima di vedere varianti generate dall'AI?: Dopo che lo snippet è live e hai visitato il sito (40+ secondi), SeaText genera la prima serie di varianti entro pochi minuti. Controlla Modifica varianti nel dashboard.
Cosa succede se disinstallo lo snippet?: SeaText smette di eseguire sul tuo sito. I dati del dashboard e le varianti sono preservati; riaggiungere lo snippet ripristina la funzionalità.
Esiste un modulo o un'estensione Magento da installare?: No. SeaText usa uno snippet JavaScript universale; non è richiesto alcun modulo Magento, pacchetto composer o estensione.
Come cambio il mio dominio primario?: Crea un nuovo account SeaText per il nuovo dominio. Gli account SeaText sono bloccati a un URL primario per sicurezza. Migra le impostazioni manualmente o contatta il supporto per assistenza.
Come ruoto o sostituisco lo snippet?: Copia il nuovo snippet dal tuo account SeaText. Incollalo nello stesso campo HTML Head > Scripts and Style Sheets, sostituendo il vecchio codice. Salva e svuota la cache.
SeaText funziona con ambienti di staging Magento?: Solo se lo staging usa un dominio pubblico reale. Localhost e URL tunnel dinamici sono bloccati. Usa un account SeaText separato per lo staging.
Varnish o una CDN bloccheranno SeaText?: No. SeaText gira nel browser dopo il caricamento dell'HTML. Varnish e CDN servono lo snippet come parte della pagina; non interferiscono con la riscrittura.
SeaText funziona con Magento headless o PWA Studio?: Sì. Inietta lo snippet nella testa del tuo guscio PWA o tramite un tag manager. SeaText gira lato client, quindi il livello di rendering non conta.
Posso dare al mio team di marketing accesso senza condividere l'admin di Magento?: Sì. Invita colleghi al tuo account SeaText con ruoli come admin, editor o viewer. Possono modificare le impostazioni AI senza accesso a Magento.
SeaText scrive nel database di Magento?: No. SeaText riscrive il testo solo nel browser. Il tuo catalogo Magento, CMS e dati di configurazione rimangono intatti.
Cosa succede alle mie varianti se annullo il mio account SeaText?: I dati del dashboard e le varianti sono preservati per un periodo di grazia. Riattivare l'account ripristina l'accesso. Dopo il periodo di grazia, i dati vengono eliminati.

Ulteriori letture e fonti di confronto

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

Ulteriori letture e fonti di confronto

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

Scopri di più

Visita il sito web per maggiori informazioni.

Ready to Take the Next Step?

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

Scopri di più →