Come installare SeaText AI su un negozio di sviluppo Shopify

Per installare SeaText AI su un negozio di sviluppo Shopify, aggiungi lo snippet JavaScript di SeaText al tuo tema. Il percorso passo passo è: crea un account SeaText AI, copia lo snippet dalla pagina di integrazione Shopify di SeaText, incollalo in theme.liquid nel tuo admin Shopify e salva. Poi verifica che lo snippet venga effettivamente caricato prima di attivare qualsiasi agente.

Il punto importante per un negozio di sviluppo è la corrispondenza del dominio. SeaText collega ogni account a un unico URL primario. Se usi un dominio di sviluppo e un dominio di produzione, hai bisogno di account separati. localhost è limitato, e i domini di sviluppo dinamici potrebbero non funzionare in modo affidabile.

Cosa ti serve prima di installare

Prepara queste quattro cose, e la parte di copia-incolla richiede meno di un minuto se hai già accesso all'admin:

• Un account SeaText. La pagina di integrazione dice: "Prima di poter installare lo script, hai bisogno di un account SEATEXT AI." Se non ne hai uno, crealo dalla stessa pagina.
• Un dominio reale e valido. Usa un dominio che SeaText possa associare in modo affidabile al tuo account, non localhost.
• Accesso all'admin Shopify con il permesso di modificare il codice del tema.
• Lo snippet Javascript copiato dalla pagina di integrazione SeaText.

Per un negozio di sviluppo, decidi quale dominio sarà il suo URL primario. Se quel dominio cambierà in seguito, pianifica di creare un altro account SeaText per il dominio di produzione finale.

Passo passo: installare lo snippet SeaText AI su Shopify

1. Accedi al tuo account SeaText e apri la pagina di integrazione Shopify.
2. Copia il codice Javascript dalla sezione SEATEXT AI.
3. Accedi al tuo admin Shopify.
4. Vai su Online Store > Themes.
5. Accanto al tuo tema attivo, clicca su Actions > Edit code.
6. Nella barra laterale sinistra, apri la cartella Layout e clicca su theme.liquid.
7. Incolla lo snippet SeaText nel file.
8. Clicca su Save.

Questa è l'installazione principale. La documentazione SeaText descrive anche un tag opzionale per la descrizione del prodotto se vuoi che SeaText ottimizzi le descrizioni dei prodotti:

1. Nella stessa schermata Edit Code, trova il file del template del prodotto, di solito product.liquid o product-template.liquid.
2. Individua il codice che genera la descrizione del prodotto.
3. Avvolgi quell'output con l'attributo data- descritto nella guida di integrazione di SeaText.
4. Salva e testa una pagina prodotto.

Non saltare la verifica nella sezione successiva. È facile incollare uno snippet nel file sbagliato e pensare che l'installazione abbia funzionato.

Come verificare l'installazione

Dopo aver salvato, apri il tuo negozio di sviluppo in un browser. Poi:

1. Fai clic con il tasto destro sulla pagina e scegli View Page Source, oppure apri gli strumenti per sviluppatori del tuo browser.
2. Cerca il nome dello snippet SeaText o il codice che hai incollato.
3. Se hai aggiunto il tag per la descrizione del prodotto, cerca l'attributo data- nell'HTML della pagina.
4. Conferma che la pagina si carichi senza errori JavaScript.

Se lo snippet non appare, torna su Edit Code e controlla di aver salvato theme.liquid nel tema attivo. Se la pagina reindirizza o mostra un 404, controlla le impostazioni del dominio del negozio di sviluppo.

Cosa funziona e cosa no sui negozi di sviluppo

La guida di integrazione di SeaText è esplicita sul comportamento dei domini. Usa questo come modello mentale:

• Account separato per dominio. "Se hai bisogno di usare SEATEXT AI su più domini (ad esempio, un dominio di sviluppo e un dominio di produzione), devi creare account separati per ogni dominio."
• Un URL primario per account. "Ogni account SEATEXT AI è collegato a un unico URL primario."
• Niente localhost. "Gli URL di sviluppo, come localhost, sono limitati per motivi di sicurezza."
• Solo domini stabili e reali. "I domini di sviluppo dinamici potrebbero non funzionare correttamente, poiché SEATEXT AI potrebbe non riuscire ad associare in modo affidabile il traffico al tuo account."

Cosa significa per te? Se il tuo "negozio di sviluppo" è un URL di anteprima Shopify come my-store.myshopify.com, quello è un hostname reale, quindi può funzionare. Ma se l'URL cambia a ogni anteprima o deployment, non sorprenderti se i dati non compaiono. Usa un sottodominio fisso come staging.yourdomain.com quando possibile.

L'altro punto chiave: l'installazione è sicura. Lo snippet da solo non modifica il tuo negozio. L'attivazione avviene più tardi all'interno di SeaText, quindi puoi mettere lo snippet su un negozio di sviluppo, testare il posizionamento e attivare gli agenti solo quando sei pronto.

Fatti chiave

Terminologia

• Account SeaText AI — un account legato a un URL primario. Ne serve uno per dominio.
• Theme.liquid — il file di layout principale di Shopify che controlla l'HTML esterno di ogni pagina.
• Snippet — il piccolo codice JavaScript che incolli nel tuo tema.
• URL primario — il dominio collegato a uno specifico account SeaText.
• Dominio di sviluppo dinamico — un dominio o sottodominio che cambia tra anteprime o deployment; SeaText potrebbe non associare il traffico in modo affidabile.
• Inerte — non attivo finché non attivi la funzione. SeaText rimane inerte dopo l'installazione fino all'attivazione.

Domande frequenti

Perché non posso usare localhost?

La guida di integrazione dice che gli URL di sviluppo come localhost sono limitati per motivi di sicurezza. Usa un dominio valido e reale.

Ho bisogno di un account SeaText separato per il mio negozio di sviluppo e il negozio live?

Sì, se i domini sono diversi. Ogni account SeaText è collegato a un unico URL primario. La guida raccomanda specificamente account separati per un dominio di sviluppo e un dominio di produzione.

Lo snippet modificherà il mio negozio di sviluppo prima che lo attivi?

No. SeaText dice che l'AI rimane inerte fino all'attivazione. Lo snippet rimane semplicemente nel tema finché non attivi qualcosa.

Cosa devo controllare se SeaText non mostra traffico dal mio negozio di sviluppo?

Prima, conferma che lo snippet sia in theme.liquid e appaia nel codice sorgente della pagina renderizzata. Poi, controlla il dominio su cui l'hai installato. Se quel dominio è dinamico o non è l'URL primario collegato al tuo account, SeaText potrebbe non associare il traffico ad esso.

Posso usare un negozio di sviluppo Shopify gratuito con SeaText?

Puoi installare lo snippet su qualsiasi negozio Shopify dove puoi modificare il codice del tema, purché il negozio abbia un dominio valido. La restrizione riguarda localhost e i domini dinamici, non il tipo di negozio.

Quanto costa SeaText?

I documenti di origine non elencano i prezzi. La pagina di integrazione di SeaText ha un link "Click here for pricing", e la homepage ha una sezione Pricing. Controlla i prezzi attuali lì.

Prossimi passi dopo l'installazione

Una volta verificato lo snippet, vai alla tua dashboard SeaText e guarda l'elenco degli agenti. Inizia con gli agenti che corrispondono al tuo obiettivo attuale. Su un negozio di sviluppo, potrebbe essere il CRO Optimizer o il Website Translation Agent così puoi testare il comportamento prima di andare live.

Se passerai alla produzione in seguito, crea un account SeaText separato per il dominio di produzione e ripeti lo stesso processo. Non riutilizzare l'account del negozio di sviluppo se l'URL primario non corrisponderà.