Seatext library

Come aggiungere lo snippet SeaText a Shopify con Google Tag Manager

Aggiungi lo snippet SeaText a Shopify tramite GTM installando lo snippet del contenitore GTM in theme.liquid, quindi creando un tag HTML personalizzato in GTM che contenga il JavaScript di SeaText e venga attivato su...

Come aggiungere lo snippet SeaText a Shopify con Google Tag Manager

Aggiungi lo snippet SeaText a Shopify con Google Tag Manager installando prima lo snippet del contenitore GTM nel tuo tema, quindi creando un tag HTML personalizzato all'interno di GTM che contenga il JavaScript di SeaText. Attiva quel tag su tutte le pagine. Prima di poter fare tutto ciò, hai bisogno di un account SeaText e di una copia dello snippet JavaScript dalla sezione di integrazione SEATEXT AI.

Questa guida illustra la configurazione in passaggi ordinati, incluso il tag per la descrizione del prodotto e come verificare che tutto funzioni correttamente.

Cosa ti serve prima di iniziare

Hai bisogno di cinque cose prima di iniziare:

  • Un account SeaText. La pagina di integrazione di SeaText indica che ne serve uno prima di poter installare lo script.
  • Lo snippet JavaScript di SeaText. Lo copierai dalla sezione di integrazione SEATEXT AI.
  • Accesso come amministratore al tuo negozio Shopify per poter modificare il codice del tema.
  • Un account Google Tag Manager con un contenitore creato. Avrai bisogno dell'ID del contenitore, solitamente GTM-XXXXXXX.
  • Un dominio valido e reale. Gli URL di sviluppo come localhost sono limitati.

Passaggio 1: Ottieni il tuo snippet SeaText e l'account

Se non hai ancora un account SeaText, creane uno per prima cosa. Le istruzioni di integrazione dicono che è necessario un account prima di poter installare lo script.

Looking to implement this for your website?
Apri la guida all'integrazione Shopify di SeaText →

Una volta effettuato l'accesso, vai alla sezione di integrazione SEATEXT AI e copia il codice JavaScript che appare lì. Conservalo in un luogo sicuro. Questo è lo snippet che fornirai a Google Tag Manager.

Tieni a mente la regola del dominio: ogni account SeaText è collegato a un singolo URL principale. Se vuoi testare su un dominio di sviluppo e andare live su un dominio di produzione, crea un account separato per ciascuno. Localhost è bloccato e i domini di sviluppo dinamici potrebbero non funzionare in modo affidabile perché SeaText potrebbe non essere in grado di associare il traffico al tuo account.

Passaggio 2: Aggiungi il contenitore GTM a Shopify

Google Tag Manager non può caricare nulla finché il suo snippet del contenitore non è presente nel tuo tema. Questa è una modifica del codice da effettuare una sola volta.

  1. Accedi al tuo pannello di controllo Shopify.
  2. Vai su Negozio online e apri Temi.
  3. Accanto al tuo tema attivo, fai clic su Azioni e scegli Modifica codice.
  4. Apri la cartella Layout e fai clic su theme.liquid.
  5. Incolla il primo snippet GTM subito dopo il tag di apertura head.
  6. Incolla il secondo snippet GTM, la versione noscript, subito dopo il tag di apertura body.
  7. Fai clic su Salva.

Non incollare SeaText in theme.liquid a questo punto. Il passaggio successivo collega SeaText a GTM. In questo modo potrai aggiornare lo snippet senza dover modificare nuovamente il codice del tema.

Passaggio 3: Crea il tag HTML personalizzato SeaText in GTM

Ora apri Google Tag Manager e aggiungi lo snippet SeaText come tag.

  1. Apri il tuo spazio di lavoro GTM.
  2. Fai clic su Tag, quindi su Nuovo.
  3. Fai clic su Configurazione tag e scegli HTML personalizzato.
  4. Incolla lo snippet JavaScript di SeaText che hai copiato nel Passaggio 1.
  5. Fai clic su Attivazione e scegli Tutte le pagine. Per una configurazione solo per i prodotti, usa un attivatore di percorso pagina per le pagine dei prodotti.
  6. Fai clic su Salva e dai al tag un nome chiaro, come SeaText - Tutte le pagine.

Un tag in GTM non viene eseguito finché non invii e pubblichi il contenitore. Usa la modalità Anteprima prima di pubblicare.

Passaggio 4: Aggiungi il tag della descrizione del prodotto di SeaText (se necessario)

L'integrazione Shopify di SeaText include anche un tag per le descrizioni dei prodotti. Non inserirlo in GTM. Appartiene al modello del tema che esegue il rendering della descrizione del prodotto.

  1. Nel pannello di controllo Shopify, vai su Negozio online e apri Temi.
  2. Fai clic su Azioni e scegli Modifica codice.
  3. Trova il modello del prodotto. La fonte SeaText indica product.liquid o product-template.liquid come posizioni tipiche.
  4. Individua il codice di output della descrizione del prodotto.
  5. Avvolgi quell'output con l'attributo data o il wrapper fornito da SeaText nella sua documentazione.
  6. Fai clic su Salva.

Dopo aver salvato, visualizza in anteprima una pagina prodotto e ispeziona il codice sorgente HTML con gli strumenti per sviluppatori del tuo browser. Verifica che l'attributo data- appaia nell'output.

Passaggio 5: Verifica che lo snippet SeaText si stia caricando

La verifica è il passaggio che rileva la maggior parte degli errori. Non saltarlo.

  • In GTM, fai clic su Anteprima per aprire Tag Assistant.
  • Apri il tuo negozio Shopify in un'altra scheda e ricarica la pagina.
  • Controlla se il tag SeaText - Tutte le pagine si attiva.
  • Apri gli strumenti per sviluppatori del browser e passa alla scheda Rete. Cerca una richiesta dallo script SeaText.
  • Se hai aggiunto il tag della descrizione del prodotto, apri una pagina prodotto e ispeziona il codice sorgente HTML per l'attributo data-.

Se il tag GTM si attiva ma non appare alcuno script nella scheda Rete, controlla l'attivatore e conferma che la versione del contenitore sia stata pubblicata. Se lo script appare ma l'attributo del prodotto manca, il problema è nel modello del prodotto, non in GTM.

Errori comuni e come evitarli

  • Installazione senza account. SeaText afferma che è necessario un account SEATEXT AI prima di installare lo script.
  • Utilizzo dello stesso account per più domini. Ogni account è collegato a un URL principale. Usa account separati per domini separati.
  • Test su localhost. Gli URL di sviluppo sono limitati, quindi usa un dominio reale valido.
  • Pubblicazione di GTM senza anteprima. Visualizza sempre prima in anteprima, poi pubblica.
  • Incollare SeaText sia in theme.liquid che in GTM. Questo può caricare lo snippet due volte. Scegli un metodo.
  • Modifica del tema sbagliato. Assicurati di modificare il tema live, non un duplicato.
  • Tentativo di avvolgere le descrizioni dei prodotti all'interno di GTM. Quel wrapper va in product.liquid o product-template.liquid.

Fatti chiave: installazione di SeaText e regole sui domini

La tabella seguente elenca i fatti dalla pagina di integrazione Shopify di SeaText.

FattoDettaglio
Requisito dell'accountÈ necessario un account SEATEXT AI prima di installare lo script.
Fonte dello snippetCopia il codice JavaScript dalla sezione di integrazione SEATEXT AI.
Vincolo del dominioOgni account SEATEXT AI è collegato a un singolo URL principale.
Domini multipliCrea account separati per ogni dominio.
URL di sviluppoLocalhost è limitato; usa un dominio reale valido.
SicurezzaIl processo di installazione è sicuro e l'IA rimane inerte fino all'attivazione.
Tag descrizione prodottoAvvolgi l'output della descrizione del prodotto e verifica l'attributo data- nel codice sorgente HTML.

Limitazioni e quando questa guida non si applica

Questa guida presuppone un tema Shopify Online Store 2.0 standard con un file theme.liquid. La maggior parte dei temi funziona in questo modo, ma le configurazioni headless o i temi pesantemente personalizzati potrebbero posizionare gli script in modo diverso.

GTM attiva i tag in modo asincrono. Se la documentazione di SeaText richiede un attivatore specifico, come DOM Ready o Window Loaded, usa quell'attivatore invece di Tutte le pagine. L'attivatore giusto dipende da ciò a cui lo script deve accedere nella pagina.

La regola del dominio si applica ancora quando usi GTM. Un account SeaText è collegato a un URL principale e gli URL di sviluppo come localhost sono limitati. Se passi da un sottodominio di staging al tuo dominio di produzione, pianifica di creare un account separato invece di presumere che lo stesso snippet funzioni.

Se non vuoi usare affatto GTM, puoi incollare lo snippet SeaText direttamente in theme.liquid seguendo i passaggi di integrazione Shopify di SeaText. GTM è un livello di gestione, non un requisito per SeaText.

SeaText e GTM: terminologia in parole semplici

  • Snippet: un piccolo pezzo di JavaScript che aggiungi a una pagina.
  • Contenitore: il tuo spazio di lavoro Google Tag Manager e le sue impostazioni.
  • Tag: un blocco di codice in GTM che si attiva quando le condizioni sono soddisfatte.
  • Attivatore: la condizione, come Tutte le pagine, che dice a un tag quando essere eseguito.
  • theme.liquid: il file di layout principale nel tuo tema Shopify che avvolge ogni pagina.

Domande frequenti

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

Sì. Ogni account SeaText è collegato a un singolo URL principale e localhost è limitato. Usa un dominio reale per ogni ambiente.

Posso installare SeaText senza GTM?

Sì. Incolla lo snippet direttamente in theme.liquid o segui i passaggi di integrazione Shopify di SeaText. GTM rende solo più facile gestire lo snippet.

Perché usare GTM se posso incollare lo snippet in theme.liquid?

GTM ti consente di aggiornare lo snippet, aggiungere attivatori e gestire altri script di terze parti in un unico posto senza modificare il codice del tema ogni volta.

Dove incollo il contenitore GTM in Shopify?

In theme.liquid. Aggiungi la prima parte dopo il tag di apertura head e la parte noscript dopo il tag di apertura body.

Come faccio a sapere se lo snippet SeaText funziona?

Usa la modalità Anteprima di GTM per confermare che il tag si attivi, quindi controlla la scheda Rete per lo script. Per il tag della descrizione del prodotto, ispeziona il codice sorgente HTML della pagina per l'attributo data-.

Il tag della descrizione del prodotto necessita di GTM?

No. Appartiene al modello del prodotto, solitamente product.liquid o product-template.liquid.

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 può aiutarti

Come SeaText può aiutarti

SeaText ti fornisce uno snippet JavaScript progettato per il tuo negozio Shopify. Il processo di installazione è sicuro e l'IA rimane inerte finché non la attivi. Prima di installare, crea un account SeaText e usa un dominio reale valido, poiché ogni account è legato a un URL principale. Per le descrizioni dei prodotti, SeaText fornisce anche un tag data-attribute separato che avvolgi attorno all'output della descrizione del prodotto nel modello del tuo tema.

Usa la guida all'integrazione ufficiale per vedere il codice esatto generato dal tuo account e per evitare di inserire lo snippet nel file sbagliato.

Recommended Solution

Ready to Take the Next Step?

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