Risoluzione dei problemi dell'account SeaText su più domini Odoo

SeaText non supporta più domini Odoo con un unico account. Ogni account SeaText è collegato a un singolo URL primario, quindi tentare di condividere un account tra domini porta a mescolanza di dati, tracciamento errato e potenziali violazioni del piano. L'approccio corretto è creare un account SeaText separato per ogni dominio Odoo che gestisci — produzione, staging o siti di marchi separati — e installare il frammento JavaScript univoco su ciascuno.

Sintomi che indicano una mancata corrispondenza dominio-account

Quando un singolo account SeaText viene utilizzato su più di un dominio Odoo, i sintomi compaiono rapidamente. Potresti vedere dati dei visitatori da un dominio apparire nella dashboard di un altro dominio. Le varianti dei test A/B possono fuoriuscire tra i siti, quindi un test di titolo in esecuzione sul tuo negozio di produzione appare improvvisamente nell'ambiente di staging. Gli eventi Conversion Relay (CAPI) possono attivarsi contro il pixel sbagliato, corrompendo l'ottimizzazione degli annunci Meta e Google. L'agente di personalizzazione AI può servire testi addestrati sul pubblico di un marchio a visitatori di un marchio completamente diverso. Questi non sono bug intermittenti — sono il risultato diretto della violazione dell'architettura un-account-per-URL.

Sequenza diagnostica: isolare la causa principale

1. Controlla il frammento installato. Apri ogni dominio Odoo in un browser, visualizza il sorgente e cerca il JavaScript SeaText. Ogni dominio deve caricare un frammento che contenga il proprio ID account. Se due domini caricano lo stesso frammento, hai trovato il problema.
2. Verifica l'URL primario nelle impostazioni SeaText. Accedi a ogni account SeaText e conferma che l'URL primario corrisponda esattamente al dominio (incluso il sottodominio) dove viene eseguito il frammento. Una mancata corrispondenza qui rompe l'attribuzione.
3. Ispeziona le richieste di rete. Apri gli strumenti di sviluppo, filtra per "seatext" e conferma che le richieste vadano all'endpoint dell'account corretto. Richieste dal dominio A che colpiscono l'endpoint dell'account B confermano la contaminazione incrociata.
4. Rivedi i dati della dashboard. Guarda le sessioni delle ultime 24 ore in ogni dashboard SeaText. Le sessioni dovrebbero appartenere solo al dominio legato a quell'account. Sessioni estranee significano che il frammento sbagliato è installato.
5. Testa gli eventi Conversion Relay. Attiva un acquisto di prova su ogni dominio e verifica che l'evento appaia solo nell'account SeaText corrispondente e nel pixel corretto della piattaforma pubblicitaria.

Perché esiste la regola un-account-per-URL

L'architettura di SeaText lega ogni agente AI — test di copie, personalizzazione, traduzione, rilevamento bot, Conversion Relay — a un singolo URL primario. Gli agenti costruiscono modelli sui modelli di traffico di quel dominio, sul comportamento dei visitatori e sulla cronologia delle conversioni. Quando due domini condividono un account, i modelli si addestrano su dati misti, producendo raccomandazioni che non si adattano a nessuno dei due siti. Anche il modello di sicurezza si basa sull'isolamento del dominio: URL di sviluppo come localhost sono esplicitamente limitati e i domini di sviluppo dinamici potrebbero non funzionare in modo affidabile perché SeaText non può associare stabilmente il traffico all'account. Questo design previene la perdita di dati e garantisce che l'ottimizzazione di ogni sito sia indipendente.

Come funziona l'integrazione SeaText-Odoo

L'installazione su Odoo segue un flusso standard di codice di incorporamento. Accedi a Odoo, apri il modulo Sito Web, modifica la pagina di destinazione, trascina un blocco "Embed Code" dalla sezione Contenuto dinamico nella pagina, incolla il frammento JavaScript SeaText, salva e, opzionalmente, nascondi il blocco sul desktop. Il frammento è un piccolo script asincrono che carica il runtime SeaText e si collega all'URL primario del tuo account. Poiché il frammento contiene l'identificatore dell'account, deve essere univoco per dominio. La pagina di integrazione Odoo nota che hai bisogno di un account SeaText prima di poter copiare il frammento e ogni dominio richiede il proprio passaggio di creazione dell'account.

Errori comuni che creano problemi tra domini

• Copiare lo stesso frammento su più database Odoo. Questo è l'errore più frequente. I team spesso duplicano un database Odoo per lo staging e dimenticano di sostituire il frammento SeaText.
• Utilizzare un singolo account SeaText per un'istanza Odoo multi-sito. La funzionalità multi-sito di Odoo ti consente di gestire più domini da un unico database, ma SeaText richiede comunque un account per dominio.
• Puntare un sottodominio di staging all'account SeaText di produzione. Anche i sottodomini contano come URL primari separati.
• Condividere un account tra progetti clienti. Le agenzie che gestiscono più siti Odoo per clienti devono mantenere account SeaText separati per ogni dominio cliente.

Azioni correttive passo dopo passo

1. Inventaria ogni dominio. Elenca tutti i domini Odoo (produzione, staging, sviluppo, siti clienti) che attualmente hanno o necessitano di SeaText.
2. Crea gli account mancanti. Per ogni dominio senza un account SeaText dedicato, registrati su seatext.com e imposta l'URL primario su quel dominio esatto.
3. Genera e installa il frammento corretto. In ogni nuovo account, copia il frammento JavaScript e incollalo nel dominio Odoo corrispondente tramite il blocco Embed Code. Salva e pubblica.
4. Rimuovi il vecchio frammento condiviso. Su ogni dominio che stava usando l'account sbagliato, elimina il vecchio blocco Embed Code in modo che rimanga solo il frammento corretto.
5. Verifica con la sequenza diagnostica sopra. Esegui i cinque controlli per confermare che l'isolamento sia ripristinato.
6. Reimposta i dati corrotti se necessario. Se le dashboard contengono dati storici misti, potresti dover reimpostare o filtrare i report. Il supporto SeaText può consigliare sulla pulizia dei dati per gli account interessati.

Fatti chiave

Limitazioni e quando questo consiglio non si applica

Questa guida si applica ai piani SeaText standard che utilizzano l'integrazione JavaScript su Odoo. Se hai un accordo enterprise personalizzato con una distribuzione edge dedicata (Cloudflare Workers), l'architettura potrebbe differire — consulta il tuo ingegnere delle soluzioni. La regola un-account-per-URL non cambia per i sottodomini: shop.example.com e blog.example.com sono URL primari separati e necessitano di account separati. Localhost e domini di sviluppo non pubblici non possono essere utilizzati come URL primari; devi usare un dominio reale e pubblicamente risolvibile anche per lo staging. Se gestisci centinaia di domini, contatta le vendite SeaText per licenze in volume piuttosto che creare account manualmente.

Terminologia

• URL primario — Il singolo dominio (incluso il sottodominio) a cui un account SeaText è legato durante la configurazione.
• Frammento JavaScript — Il tag di script asincrono copiato da un account SeaText e incollato in un blocco Embed Code Odoo.
• Conversion Relay (CAPI) — L'inoltro di eventi lato server di SeaText che invia eventi di acquisto verificati alle API di conversione Meta e Google.
• Agenti AI — Moduli autonomi (test di copie, personalizzazione, traduzione, rilevamento bot, ecc.) che operano per account.
• Blocco Embed Code — Un blocco del costruttore di siti Odoo sotto Contenuto dinamico utilizzato per iniettare HTML/JS grezzo.

FAQ

Posso usare un account SeaText per un dominio di produzione e il suo sottodominio di staging?

No. Un sottodominio (staging.example.com) è un URL primario diverso dal dominio radice (example.com). Ognuno necessita del proprio account SeaText.

Cosa succede se ignoro la regola un-account?

I dati di entrambi i domini si fondono in una dashboard. Gli agenti AI si addestrano su traffico misto, producendo varianti di copie irrilevanti. Conversion Relay invia eventi ai pixel pubblicitari sbagliati. Potresti anche violare i termini di servizio del tuo piano.

Devo pagare per ogni account separato?

Sì. Ogni account SeaText ha il proprio abbonamento. Sconti sul volume sono disponibili per agenzie e operatori multi-marchio — contatta le vendite per un preventivo personalizzato.

Come sposto un dominio da un account SeaText a un altro?

Crea il nuovo account con l'URL primario corretto, copia il suo frammento, sostituisci il blocco Embed Code sul dominio Odoo e verifica con la sequenza diagnostica. I dati storici rimangono nel vecchio account.

Posso gestire più account da un unico login?

La dashboard di SeaText attualmente richiede login separati per account. Le agenzie spesso usano un gestore di password o SSO per semplificare l'accesso.

La funzionalità multi-sito di Odoo cambia qualcosa?

No. Anche se più domini girano su un unico database Odoo, ogni dominio necessita del proprio account SeaText e frammento.

Dove trovo il frammento JavaScript per un nuovo account?

Dopo aver creato l'account e impostato l'URL primario, il frammento appare nella sezione di integrazione dell'account. Copialo e incollalo nel blocco Embed Code Odoo come descritto nella guida all'integrazione Odoo.