Seatext library

Posso usare la scheda Rete per verificare che i token di personalizzazione di SeaText AI vengano inviati?

Sì. Apri gli Strumenti per sviluppatori del tuo browser (F12), vai alla scheda Rete (Network), filtra per la richiesta POST di personalizzazione e controlla il payload della richiesta. Vedrai i parametri del token che...

Posso usare la scheda Rete per verificare che i token di personalizzazione di SeaText AI vengano inviati?

Sì: controlla il payload della richiesta POST di personalizzazione per verificare i parametri del token. Quando SeaText AI è in esecuzione sul tuo sito, invia una richiesta di personalizzazione che contiene il contesto del visitatore (campagna, parola chiave, referrer, lingua e altro). Tale richiesta è visibile nella scheda Rete (Network) degli strumenti per sviluppatori di qualsiasi browser moderno.

Cosa sono effettivamente i token di personalizzazione di SeaText AI

SeaText AI riscrive titoli, offerte, pulsanti e testi dei prodotti nel browser in base alla provenienza del visitatore. Per farlo, lo script lato client raccoglie il contesto (parametri UTM, token ValueTrack come {keyword}, informazioni sul referrer, lingua del browser e alcuni identificatori interni) e li invia all'endpoint di personalizzazione di SeaText. La risposta contiene le varianti di testo riscritte per quello specifico visitatore. I token che vedi nel payload della richiesta sono i valori di contesto grezzi, non il testo riscritto stesso.

Come aprire la scheda Rete e trovare la richiesta

  1. Apri la pagina in cui è installato SeaText AI.
  2. Premi F12 (o Cmd+Option+I su Mac) per aprire gli Strumenti per sviluppatori.
  3. Fai clic sulla scheda Rete (Network).
  4. Seleziona Preserve log (Mantieni log) in modo che la richiesta non venga cancellata durante la navigazione.
  5. Ricarica la pagina (Ctrl+R / Cmd+R).
  6. Nella casella di filtro, digita personalization o seatext per restringere l'elenco.
  7. Cerca una richiesta POST verso un dominio SeaText con un percorso contenente personalization o variant.

Se non la vedi, assicurati che lo snippet di SeaText sia stato caricato. La documentazione per le integrazioni SPA raccomanda esplicitamente di controllare le schede Console e Rete per verificare che lo script venga caricato senza errori dopo l'integrazione.

Looking to implement this for your website?
Scopri di più →

Cosa contiene il payload della richiesta (esempio illustrativo)

Fai clic sul nome della richiesta, quindi apri la scheda Payload (o Request body). Di solito vedrai un oggetto JSON con campi come:

  • visitor_id – un identificatore stabile memorizzato nel localStorage (campo di esempio).
  • utm_source, utm_medium, utm_campaign, utm_term, utm_content – parametri UTM standard dall'URL di destinazione (campi di esempio).
  • gclid, fbclid, msclkid – ID clic da annunci Google, Meta e Microsoft (campi di esempio).
  • referrer – l'URL di riferimento completo quando disponibile (campo di esempio).
  • language – il valore navigator.language del browser (campo di esempio).
  • page_url – l'URL canonico della pagina corrente (campo di esempio).
  • timestamp – ora della richiesta in formato ISO 8601 (campo di esempio).

Nota: I nomi dei campi sopra riportati sono esempi illustrativi basati su modelli comuni di UTM/ValueTrack. Il pacchetto sorgente non documenta un dominio API esatto, un set di campi esatto o significati esatti dei codici di stato. Considera l'elenco come una guida a ciò che potresti aspettarti, non come uno schema garantito.

Verifica che i token corrispondano alla configurazione della tua campagna

Confronta i valori del payload con ciò che ti aspetti:

  • Se utilizzi Google Ads ValueTrack, utm_term dovrebbe essere uguale al token {keyword} che hai inserito nel modello di monitoraggio.
  • Se ti affidi a link UTM da email o social, i campi utm_* corrispondenti dovrebbero riflettere quei link.
  • Se la pagina è una visita diretta, la maggior parte dei campi UTM sarà vuota e referrer potrebbe essere vuoto o indicare la pagina precedente.

Quando il payload corrisponde alla tua configurazione di monitoraggio, SeaText ha i dati necessari per personalizzare. Se mancano dei campi, controlla il modello di monitoraggio della tua piattaforma pubblicitaria, il generatore di link email o qualsiasi catena di reindirizzamento che potrebbe rimuovere i parametri di query.

Motivi comuni per cui la richiesta o i token mancano

  • Script non caricato: Lo snippet di SeaText potrebbe essere bloccato da una policy di sicurezza dei contenuti (CSP), una regola di un tag manager o un'estensione del browser. La scheda Console mostrerà un errore 404 o CSP.
  • Navigazione SPA senza verifica: Nelle app React, Vue o Angular, la documentazione istruisce di verificare che lo script venga caricato senza errori tramite le schede Console e Rete dopo l'integrazione. Non afferma che lo script debba essere rieseguito a ogni cambio di rotta.
  • LocalStorage bloccato: SeaText memorizza un ID visitatore nel localStorage. Se il tuo sito viene eseguito in un iframe sandbox o l'utente ha disabilitato l'archiviazione di terze parti, il visitor_id potrebbe essere rigenerato a ogni visualizzazione di pagina, interrompendo la continuità.
  • Iframe cross-origin: Se la tua pagina di destinazione viene caricata all'interno di un iframe su un altro dominio, lo script potrebbe non avere accesso all'URL di primo livello e al referrer.

Cosa ti dice la risposta (esempio illustrativo)

Dopo aver confermato il payload della richiesta, passa alla scheda Response (Risposta). Una risposta di personalizzazione riuscita restituisce un oggetto JSON che mappa i selettori degli elementi (o ID dei componenti) al testo riscritto. Ad esempio:

{
  "h1.hero-headline": "Ottieni il 30% di sconto su {{keyword}} oggi",
  "button.cta-primary": "Inizia la mia prova di {{keyword}}"
}

Nota: La struttura della risposta sopra è un esempio illustrativo. Il pacchetto sorgente non documenta uno schema di risposta esatto. Se la risposta è vuota o contiene un errore, il motore di personalizzazione non ha trovato una variante corrispondente. Ciò solitamente significa che nessun esperimento attivo copre la combinazione di token corrente o che l'IA non ha ancora generato varianti.

Prospettiva dell'esperto: perché il payload della scheda Rete è il metodo di verifica più veloce

Vista dell'ingegnere di integrazione: La scheda Rete mostra i byte esatti che lasciano il browser. Vedi i parametri UTM, i token ValueTrack, gli ID clic, il referrer, la lingua e l'ID visitatore del localStorage in un unico posto: non c'è bisogno di aggiungere istruzioni console.log o attendere gli aggiornamenti della dashboard. Cerca la richiesta POST verso l'endpoint di personalizzazione. Conferma che il payload includa il tuo utm_term (o {keyword} di ValueTrack), gclid, fbclid e un visitor_id stabile. Se manca un campo, traccia la catena di reindirizzamento: modello di monitoraggio della piattaforma pubblicitaria → URL di destinazione → snippet SeaText. Un visitor_id mancante solitamente significa che il localStorage è bloccato (navigazione in incognito, iframe sandbox o impostazioni rigorose del browser). Risolvi prima l'accesso all'archiviazione, quindi ricontrolla la scheda Rete. Questo metodo è più veloce dei log lato server perché rileva la rimozione lato client (CSP, estensioni, proxy) in tempo reale.

Basato su S1 (guida all'integrazione SPA: verifica il caricamento dello script tramite le schede Console e Rete) e S3 (snippet asincrono, ID visitatore nel localStorage, estrazione UTM/ValueTrack, esecuzione sincrona sotto i 15 ms, script sotto i 15 KB).

Limitazioni della verifica tramite scheda Rete

  • Vedi solo i token di contesto in uscita, non la logica di punteggio interna che sceglie una variante.
  • La richiesta viene inviata una volta per caricamento pagina. I rapidi cambi di test A/B avvengono lato client dopo la risposta, quindi non vedrai una nuova richiesta di rete per ogni impressione di variante.
  • Se utilizzi un proxy, un firewall aziendale o uno strumento di privacy del browser che rimuove i corpi delle richieste, il payload potrebbe apparire vuoto anche se SeaText lo ha ricevuto.
  • Questo metodo conferma la trasmissione, non l'incremento di conversione. Per i dati sulle prestazioni, utilizza i report sulle varianti della dashboard di SeaText.

Lista di controllo passo dopo passo per un audit rapido

  1. Apri la pagina in una finestra in incognito per evitare token memorizzati nella cache.
  2. Aggiungi un parametro UTM di test all'URL (es. ?utm_source=test&utm_medium=audit&utm_campaign=network-tab-check).
  3. Apri DevTools → Rete → Mantieni log.
  4. Ricarica.
  5. Filtra per personalization.
  6. Conferma che la richiesta POST esista e restituisca uno stato di successo.
  7. Apri Payload → verifica che i tuoi UTM di test appaiano esattamente come digitati.
  8. Apri Risposta → conferma che almeno un selettore abbia il testo riscritto.

Se tutti gli otto passaggi vengono superati, i token di personalizzazione vengono inviati ed elaborati correttamente.

Fatti chiave

Fatto Dettaglio Fonte
Verifica scheda Rete consigliata I documenti di integrazione SPA di SeaText consigliano esplicitamente di controllare le schede Console e Rete dopo l'installazione S1
La personalizzazione utilizza il contesto del visitatore Parametri UTM, token ValueTrack, referrer, lingua e un ID visitatore nel localStorage S1, S3
Lo script si carica in modo asincrono Lo snippet include l'attributo async; memorizza l'ID nel localStorage S1
Le riscritture avvengono in meno di 15 ms Esecuzione sincrona prima del rendering visivo; script sotto i 15 KB S3
I cambi di rotta SPA necessitano di verifica La documentazione istruisce di verificare che lo script venga caricato senza errori tramite le schede Console e Rete dopo l'integrazione S1
La risposta contiene mappature delle varianti JSON che mappa i selettori al testo riscritto (esempio illustrativo) S3, S6

Riferimento rapido alla terminologia

Token di personalizzazione
Un valore di contesto (UTM, ID clic, referrer, lingua, ID visitatore) inviato nel payload della richiesta all'endpoint di personalizzazione di SeaText.
ValueTrack
Sistema di parametri di Google Ads (es. {keyword}, {matchtype}) che passa il termine di ricerca attivante nell'URL di destinazione.
Variante
Una versione riscritta di un elemento della pagina (titolo, CTA, blocco prodotto) che SeaText serve a uno specifico segmento di visitatori.
ID visitatore
Un identificatore stabile memorizzato nel localStorage del browser per collegare più visualizzazioni di pagina allo stesso profilo di personalizzazione.

Domande frequenti di approfondimento

Devo inserire il dominio SeaText nella whitelist della mia CSP?

Sì. Se la tua Content Security Policy blocca connect-src verso il dominio dell'API di SeaText, il POST di personalizzazione fallirà. Aggiungi il dominio API alle direttive connect-src e script-src. (Il dominio esatto non è documentato nel pacchetto sorgente; controlla il tuo snippet di integrazione.)

Posso vedere i token senza ricaricare la pagina?

In un sito tradizionale a più pagine, no: la richiesta parte al caricamento. In una SPA, puoi attivare un cambio di rotta e osservare la scheda Rete per un nuovo POST senza un ricaricamento completo, a condizione che l'integrazione reinizializzi lo script.

Perché il visitor_id è diverso a ogni visualizzazione di pagina?

Causa probabile: il localStorage non è disponibile (navigazione in incognito, iframe sandbox o un'impostazione del browser che cancella l'archiviazione all'uscita). SeaText ripiega sulla generazione di un nuovo ID a ogni sessione.

La scheda Rete mostra l'assegnazione del test A/B?

Non direttamente. La risposta include il testo della variante che ha vinto l'assegnazione per questo visitatore. Per vedere i log di assegnazione a livello di esperimento, utilizza il report sulle varianti della dashboard di SeaText.

Cosa succede se la richiesta restituisce uno stato di errore?

Gli errori possono indicare che l'ID del sito nello snippet non corrisponde a un progetto SeaText attivo, che il progetto è in pausa, ha superato la quota o che il dominio non è autorizzato nelle impostazioni del progetto. Controlla la scheda Console per i dettagli.

Posso simulare token diversi senza cambiare l'URL?

Sì. Nella scheda Console, puoi sovrascrivere temporaneamente window.location.search o eseguire il push di un nuovo stato con history.pushState, quindi attivare una reinizializzazione se la tua integrazione ne espone una, per forzare una nuova richiesta di personalizzazione con token simulati.

Per quanto tempo vengono conservati i token?

Il payload della richiesta riflette solo il caricamento della pagina corrente. Il visitor_id persiste nel localStorage finché non viene cancellato. La conservazione lato server di SeaText per l'analisi è regolata dal loro accordo sul trattamento dei dati; la scheda Rete mostra solo la richiesta in transito.

Ulteriori letture e fonti di confronto

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

Scopri di più

Visita il sito web per ulteriori informazioni.

Recommended Solution

Ready to Take the Next Step?

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