Checklist di preparazione per Squarespace per le varianti di traduzione AI di SeaText

Risposta rapida

Puoi eseguire le varianti di traduzione AI di SeaText su Squarespace quando sono soddisfatte quattro condizioni: il tuo piano è Business o superiore, puoi accedere a Impostazioni → Strumenti per sviluppatori → Iniezione di codice, il tuo sito è live su un dominio reale (niente localhost o URL di anteprima dinamici) e hai contenuti di pagina che contengono effettivamente testo traducibile. Se manca uno di questi elementi, lo script non può essere aggiunto o rimarrà inattivo.

Questa checklist esamina ogni condizione in dettaglio. Imparerai come verificare ciascuna, cosa fare se fallisci un controllo e come evitare errori comuni che ritardano l'attivazione.

Prerequisiti: livello del piano e permessi

Squarespace limita l'iniezione di codice ai piani Business, Commerce Basic e Commerce Advanced. I piani Personal e di prova non espongono la sezione Strumenti per sviluppatori, quindi lo snippet SeaText non ha dove andare. Verifica il tuo piano in Impostazioni → Fatturazione → Abbonamento prima di iniziare. Hai anche bisogno dei permessi di amministratore o proprietario sul sito; i ruoli di collaboratore non possono aprire gli Strumenti per sviluppatori.

Perché è importante: Senza il piano Business o superiore, non puoi aggiungere alcun JavaScript personalizzato. SeaText si basa su quello snippet per comunicare con le tue pagine. L'upgrade è l'unica soluzione. Se sei in prova, la sezione Strumenti per sviluppatori è nascosta finché non scegli un piano a pagamento.

Come verificare: Accedi al tuo pannello di controllo Squarespace. Fai clic sul nome del tuo sito, poi vai su Impostazioni → Fatturazione → Abbonamento. Il nome del piano appare lì. Se dice Personale o Prova, devi fare l'upgrade.

Controllo permessi: Vai su Impostazioni → Permessi. Il tuo ruolo dovrebbe essere Amministratore o Proprietario. Se sei un collaboratore, puoi richiedere l'accesso al proprietario del sito.

Accesso tecnico: disponibilità dell'iniezione di codice

Apri Impostazioni, scorri in fondo e fai clic su Strumenti per sviluppatori. Se vedi "Iniezione di codice" sei autorizzato a incollare il JavaScript di SeaText nel campo Header. Se la sezione è assente, il tuo piano non la supporta—fai l'upgrade o usa una piattaforma diversa. Lo snippet deve andare nell'Header, non nel Footer, e il sito deve essere salvato e pubblicato dopo l'incollaggio.

Perché l'iniezione nell'header è importante: SeaText deve caricarsi presto nel ciclo di vita della pagina per rilevare i nodi di testo. L'header è il posto standard per gli script di tracciamento e traduzione. Metterlo nel footer può ritardare l'esecuzione e può far sì che lo script manchi elementi che vengono renderizzati dopo il DOM ready.

Errore comune: Alcuni utenti incollano il codice nel Footer per errore. Ricontrolla di essere nel campo Header. Inoltre, assicurati di fare clic su Salva e poi Pubblica il sito. Le modifiche nell'iniezione di codice non diventano live finché non pubblichi.

Prontezza dei contenuti: testo che può essere tradotto

SeaText traduce i nodi di testo visibili—titoli, corpo del testo, etichette dei pulsanti, descrizioni dei prodotti, meta description e attributi alt. Le pagine che sono interamente immagini, app di terze parti incorporate o testo SVG hard-coded non produrranno varianti traducibili. Controlla alcune pagine chiave (home, prodotto, contatti) e conferma che contengano testo HTML live. Se usi un page builder che renderizza tutto come canvas o WebGL, la traduzione non funzionerà.

Cosa controllare: Apri il tuo sito in un browser, fai clic con il tasto destro e seleziona Visualizza sorgente pagina. Cerca i tag <p>, <h1>, <h2>, <span> e <button> che contengono testo visibile. Se la maggior parte dei tuoi contenuti è dentro tag <img> o fornita tramite iframe, SeaText non può leggerli.

Scenario pratico: Un negozio online con titoli e descrizioni di prodotto in HTML funzionerà bene. Un sito portfolio che mostra immagini senza didascalie di testo avrà poco da tradurre. Puoi aggiungere blocchi di testo in Squarespace per rendere le pagine traducibili.

Requisiti del dominio: URL di produzione valido

SeaText collega ogni account a un singolo URL primario. Indirizzi di sviluppo come localhost, 127.0.0.1 o i sottodomini di prova integrati di Squarespace come .squarespace.com sono bloccati per sicurezza. Hai bisogno di un dominio reale, pubblicamente risolvibile (ad es., example.com o shop.example.com) con HTTPS attivo. Se esegui un ambiente di staging su un sottodominio separato, crea un secondo account SeaText per quel sottodominio.

Perché la restrizione: SeaText deve associare in modo affidabile il traffico al tuo account. Gli URL di sviluppo dinamici cambiano spesso, rendendo impossibile tracciare le sessioni. Un dominio personalizzato è stabile e verificabile.

Come verificare: Nel tuo browser, vai al tuo dominio e guarda la barra degli indirizzi. Dovrebbe iniziare con https:// e non contenere localhost o .squarespace.com. Se stai usando un sito di prova, collega un dominio personalizzato in Impostazioni → Domini.

Passaggi di verifica dell'installazione

1. Incolla lo snippet JavaScript di SeaText in Impostazioni → Strumenti per sviluppatori → Iniezione di codice → Header e fai clic su Salva.
2. Pubblica il sito se non è già live.
3. Visita la homepage (o qualsiasi pagina con lo snippet) e rimani per almeno 40 secondi. Questo attiva l'AI e collega il dominio al tuo account SeaText.
4. Attendi cinque minuti, poi apri il tuo pannello di controllo SeaText. Il nome del tuo sito dovrebbe apparire accanto al logo SeaText in alto.
5. Se il nome non appare dopo 10 minuti, contatta il supporto SeaText—l'installazione potrebbe avere un problema specifico della piattaforma.

Perché 40 secondi? Lo script ha bisogno di tempo per caricarsi e inviare un segnale di sessione. Non basta un rapido refresh. Rimani sulla pagina e lascia che lo script completi la sua stretta di mano.

Cosa fare dopo: Dopo che il pannello mostra il tuo sito, vai all'Hub AI principale e attiva l'Agente di traduzione del sito web. Scegli le pagine che vuoi tradurre e configura i parametri. Il primo set di varianti di solito appare entro pochi minuti.

Blocchi comuni e come risolverli

• Iniezione di codice mancante: Fai l'upgrade al piano Business o superiore.
• Script salvato ma il nome del sito non appare mai: Svuota la cache del browser, assicurati che i blocchi di annunci/script siano disattivati per il tuo dominio, poi rivisita per altri 40 secondi.
• Sottodominio di prova utilizzato: Collega un dominio personalizzato nel pannello Domini di Squarespace, poi reinstalla lo snippet.
• Più domini sotto un unico account: Crea un account SeaText separato per ogni URL primario.
• Contenuti dentro iframe o widget esterni: SeaText non può raggiungere iframe cross-origin; sposta il testo traducibile in blocchi nativi di Squarespace.

Blocchi di script: Le estensioni del browser come uBlock Origin o gli strumenti di privacy possono impedire il caricamento dello snippet. Testa in una finestra privata con le estensioni disabilitate.

Problemi di cache: Dopo aver salvato lo snippet, fai un hard-refresh del browser (Ctrl+F5) per assicurarti di vedere la versione aggiornata della tua pagina.

Più siti web: Se hai più di un sito Squarespace, ognuno richiede il proprio account SeaText e snippet.

Limitazioni e quando questa checklist non si applica

Questa checklist copre i siti web Squarespace standard. Non copre i siti Commerce di Squarespace che usano estensioni di checkout personalizzate caricate tramite iframe, né si applica alle funzionalità native di scrittura AI di Squarespace—quelle sono separate da SeaText. Se già esegui un altro plugin di traduzione (ad es., Linguise o Weglot) tramite iniezione di codice, testa per conflitti di script prima di attivare SeaText. L'agente di traduzione in 125 lingue e il test delle varianti iniziano solo dopo che il pannello mostra il tuo sito come connesso.

App a pagina singola: I siti Squarespace sono per lo più renderizzati lato server. Se usi una SPA personalizzata (React o simile) dentro Squarespace, potresti dover implementare una gestione speciale. La documentazione di SeaText menziona il supporto SPA ma richiede di seguire la loro guida avanzata.

In conclusione: La checklist è un filtro. Se superi ogni punto, l'installazione dovrebbe essere fluida. Se fallisci uno, sai esattamente dove intervenire.

Fatti chiave

FAQ

Posso usare SeaText su un piano Personale se aggiungo lo script tramite un plugin di terze parti?

No. Squarespace non espone il punto di iniezione dell'Header sui piani Personali, e i plugin di terze parti non possono aggirare quella restrizione.

Il sottodominio di prova .squarespace.com funziona per i test?

No. SeaText blocca i sottodomini di prova e di sviluppo per sicurezza. Collega prima un dominio personalizzato.

Cosa succede se ho già due lingue costruite come pagine separate?

SeaText può comunque creare varianti per ogni pagina. Non sostituisce le tue traduzioni manuali ma aggiunge varianti generate dall'AI per i test. Puoi mantenere entrambi gli approcci.

Quanto tempo prima di vedere le prime varianti tradotte?

Dopo che il pannello mostra il tuo sito come connesso, attiva l'Agente di traduzione del sito web nell'Hub AI principale. Le varianti iniziali di solito appaiono entro pochi minuti.

SeaText rallenterà il mio sito Squarespace?

Lo script si carica in modo asincrono e rimane inattivo finché non viene attivato. Nessun impatto misurabile sui Core Web Vitals è stato riportato nella documentazione di origine.

Posso limitare la traduzione a pagine specifiche?

Sì. Nell'Hub AI principale scegli quali pagine attivano l'Agente di traduzione.

Cosa succede se devo tradurre un sottodominio di staging e il dominio live?

Crea due account SeaText—uno per URL primario—e installa lo snippet rispettivo su ogni ambiente.

Devo rimuovere altri strumenti di traduzione prima di installare SeaText?

Puoi eseguire SeaText insieme ad altri traduttori, ma testa per conflitti di script. Alcuni strumenti possono alterare il DOM in modi che impediscono a SeaText di rilevare il testo.

Posso usare SeaText su un sito Squarespace che usa un dominio personalizzato da un registrar di terze parti?

Sì. Finché il dominio è collegato correttamente e risolve al tuo sito, SeaText lo accetterà.

Cosa succede se i miei contenuti sono per lo più immagini con testo incorporato?

SeaText non può tradurre il testo dentro le immagini. Devi convertire quel contenuto in blocchi di testo HTML affinché la traduzione funzioni.