So überprüfen Sie, ob das SeaText-Skript nach einem Redesign oder einer Migration geladen wird

Schnelle Checkliste zur Überprüfung

Öffnen Sie die Website in einem Browser, starten Sie die Entwicklertools (F12) und führen Sie diese fünf Schritte nacheinander durch. Jeder Schritt deckt eine andere Fehlerquelle ab, damit Sie sich nicht auf ein einzelnes Signal verlassen müssen.

1. Bestätigen Sie, dass das Snippet im bereitgestellten HTML vorhanden ist. Sehen Sie sich den Seitenquelltext an (nicht das Elements-Panel) und suchen Sie nach seatext oder Ihrer Projekt-ID. Wenn das Tag fehlt, wurde es von der Deployment-Pipeline entfernt.
2. Überprüfen Sie den Tab „Konsole“ auf Fehler. Suchen Sie nach roten Meldungen, die sich auf seatext, SEATEXTCODEINTEGRATION oder blockierte Skripte beziehen. Verstöße gegen die Content Security Policy (CSP) und Cross-Origin-Fehler erscheinen hier zuerst.
3. Überprüfen Sie, ob die Netzwerkanfrage erfolgreich abgeschlossen wurde. Wechseln Sie zum Tab „Netzwerk“, filtern Sie nach „JS“ oder „Skript“, laden Sie die Seite neu und bestätigen Sie eine 200-Antwort für den SeaText-Loader. Ein 404- oder 403-Fehler bedeutet, dass sich der CDN-Pfad oder die Projekt-ID geändert hat.
4. Untersuchen Sie den localStorage auf die SeaText-ID. Erweitern Sie im Tab „Anwendung“ (oder „Speicher“) den Bereich „Lokaler Speicher“, wählen Sie Ihren Ursprung (Origin) aus und suchen Sie nach einem Schlüssel, der seatext enthält. Das Fehlen bedeutet, dass das Skript nie ausgeführt wurde oder der localStorage blockiert ist.
5. Validieren Sie das sichtbare Verhalten. Lösen Sie eine Übersetzung, eine Personalisierungsvariante oder ein Bot-Erkennungsereignis aus und bestätigen Sie, dass das DOM aktualisiert wird. Verwenden Sie den Vorschau-Modus des SeaText-Dashboards oder hängen Sie ?seatext_preview=1 an die URL an, um eine Variante zu erzwingen.

Warum die Überprüfung nach der Migration wichtig ist

Ein Redesign schreibt oft die head- oder body-Injection-Punkte um, wechselt von serverseitig gerendertem HTML zu einem SPA-Framework oder fügt eine neue Content Security Policy hinzu. Jede dieser Änderungen kann dazu führen, dass das asynchrone Skript-Tag stillschweigend entfernt wird, die CDN-Domain blockiert wird oder der Zugriff auf den localStorage verhindert wird. Da SeaText Schlagzeilen, Angebote und Übersetzungen zur Laufzeit umschreibt, führt ein fehlendes Skript dazu, dass jede Seite auf die Basissprache und das Basisangebot zurückfällt – wodurch der Conversion-Gewinn und der Nachweis der Bot-Erstattung, die die Plattform bietet, verloren gehen.

Voraussetzungen vor dem Start

• Zugriff auf die Staging-Umgebung, die die Produktions-Build-Pipeline widerspiegelt.
• Vertrautheit mit den Browser-Entwicklertools (Tabs: Konsole, Netzwerk, Anwendung).
• SeaText-Projekt-ID und erwarteter CDN-Hostname aus dem Integrationsleitfaden.
• Berechtigung zum Bearbeiten von CSP-Headern oder Proxy-Regeln, falls das Skript blockiert wird.
• Eine Test-URL, die Übersetzungen, Personalisierungen oder Bot-Erkennung nutzt, damit Sie die DOM-Änderung beobachten können.

Schritt-für-Schritt-Überprüfung in der Staging-Umgebung

1. Vorhandensein des Snippets in der Build-Ausgabe

Führen Sie den Produktions-Build lokal aus (npm run build oder gleichwertig) und öffnen Sie die generierte index.html. Suchen Sie nach dem genauen Snippet, das SeaText bereitgestellt hat. In React-, Vue- oder Angular-Projekten gehört das Snippet in die public/index.html oder das Root-Template des Frameworks. Wenn Ihre CI/CD HTML-Templating verwendet, bestätigen Sie, dass die Variable, die das Snippet einfügt, korrekt aufgelöst wird.

2. Konsolen- und Netzwerkprüfung

Stellen Sie die Anwendung in der Staging-Umgebung bereit, öffnen Sie die URL und drücken Sie F12. Laden Sie die Seite bei geöffnetem Netzwerk-Tab neu. Der SeaText-Loader sollte als Skriptanfrage mit async-Attribut erscheinen. Klicken Sie auf die Anfrage; der Antwort-Tab muss JavaScript zurückgeben, keine HTML-Fehlerseite. Filtern Sie in der Konsole nach „seatext“ – es sollten null Fehler vorhanden sein. Ein CSP-Verstoß wird als „Refused to load the script“ zusammen mit der Direktive angezeigt, die ihn blockiert hat.

3. Bestätigung des Schreibvorgangs in den localStorage

Nachdem das Skript ausgeführt wurde, öffnen Sie Anwendung → Lokaler Speicher → Ihr Ursprung. Sie sollten einen Schlüssel wie seatext_visitor_id oder ähnlich sehen. Wenn der Schlüssel fehlt, prüfen Sie, ob die Website in einem sandboxed Iframe ausgeführt wird, eine restriktive Cookie-Richtlinie verwendet oder Seiten von mehreren Subdomains ohne gemeinsamen Speicher bereitstellt.

4. Funktionaler Rauchtest

Wählen Sie eine Seite aus, die Übersetzungen oder den Google Ads-Agenten verwendet. Hängen Sie ?seatext_preview=1 an (oder verwenden Sie den Dashboard-Vorschau-Link) und überprüfen Sie, ob sich Schlagzeilen, Schaltflächen oder Produktblöcke ändern. Besuchen Sie für die Bot-Erkennung die Seite mit einem bekannten Test-User-Agent oder dem SeaText-Test-Tool und bestätigen Sie, dass das Dashboard eine Sitzung aufzeichnet.

Go-Live-Prüfungen in der Produktion

Wiederholen Sie die gleiche fünfstufige Checkliste unmittelbar nach der DNS-Umstellung. CDN-Propagierung, Edge-Caching oder eine vergessene Umgebungsvariable können dazu führen, dass sich die Produktion anders verhält als die Staging-Umgebung. Planen Sie ein 15-minütiges Zeitfenster nach dem Start ein, um die Prüfungen bei geringem Datenverkehr durchzuführen. Wenn Sie Feature-Flags verwenden, aktivieren Sie SeaText zunächst für einen kleinen Prozentsatz der Benutzer und überwachen Sie das Dashboard auf Live-Ereignisse.

Häufige Fehlermuster und Lösungen

Symptom	Wahrscheinliche Ursache	Lösung
Snippet fehlt im Seitenquelltext	Build-Pipeline hat den Injection-Schritt übersprungen	Fügen Sie eine Post-Build-Assertion hinzu, die nach der Projekt-ID sucht
Konsole zeigt CSP-Fehler	Neuer CSP-Header enthält nicht die SeaText-CDN-Domain	Fügen Sie script-src https://cdn.seatext.com (oder Ihr CDN) zur Richtlinie hinzu
Netzwerkanfrage gibt 404 zurück	Projekt-ID geändert oder CDN-Pfad aktualisiert	Aktualisieren Sie das Snippet auf die aktuelle Projekt-ID aus dem Dashboard
localStorage-Schlüssel fehlt	Speicher von Drittanbietern blockiert oder Cross-Origin-Iframe	Stellen Sie sicher, dass das Skript in einem First-Party-Kontext ausgeführt wird; erlauben Sie Speicher im Iframe allow-scripts allow-same-origin
Keine Übersetzungen oder Varianten erscheinen	Skript geladen, aber KI-Bereich nicht konfiguriert	Überprüfen Sie, ob die KI-Bereichseinstellungen im Dashboard mit der neuen Seitenstruktur übereinstimmen

Automatisierter Regressionstest für Ihre CI

Fügen Sie einen Headless-Browser-Schritt (Playwright, Cypress oder Puppeteer) hinzu, der die erstellte index.html lädt, auf die SeaText-Netzwerkanfrage wartet, bestätigt, dass localStorage.getItem('seatext_visitor_id') existiert, und prüft, ob ein bekanntes Datenattribut (z. B. data-seatext-variant) auf einem Zielelement erscheint. Lassen Sie den Build fehlschlagen, wenn eine Assertion fehlschlägt. Dies fängt Regressionen ab, bevor sie die Staging-Umgebung erreichen.

Wichtige Fakten

Element	Detail
Skript-Lademodus	Asynchrones Skript-Tag mit async-Attribut
Speicheranforderung	Schreibt eine Besucher-ID in den localStorage; First-Party-Zugriff erforderlich
Hinweis zu Cross-Origin	Mehrere Domains benötigen kompatible CSP und gemeinsamen Speicher oder Proxy
SPA-Integrationspunkt	Snippet in index.html oder Framework-Mount-Datei einfügen
Überprüfungssignale	Konsole sauber, Netzwerk 200, localStorage-Schlüssel vorhanden, DOM-Variante sichtbar
Vorschau-Auslöser	Anhängen von ?seatext_preview=1 oder Verwendung des Dashboard-Vorschau-Links

Einschränkungen

Diese Checkliste deckt nur das clientseitige Laden ab. Sie überprüft keine serverseitigen Rendering-Pfade, Edge-Worker-Umschreibungen oder Personalisierungen auf API-Ebene, die SeaText in zukünftigen Versionen einführen könnte. Wenn Ihr Stack das Rendering an den Edge verlagert, fügen Sie eine entsprechende Edge-Log-Prüfung hinzu. Die Schritte setzen außerdem voraus, dass Sie die HTML-Bereitstellung kontrollieren; wenn eine Drittanbieter-Plattform das Snippet einfügt, koordinieren Sie deren Release-Zyklus.

FAQ

Woher weiß ich, welche CDN-Domain ich in der CSP erlauben muss?

Öffnen Sie den Netzwerk-Tab auf einer funktionierenden Seite, klicken Sie auf die SeaText-Skriptanfrage und kopieren Sie den Hostnamen aus der Request-URL. Das ist der genaue Ursprung, den Sie auf die Whitelist setzen müssen.

Kann ich das Skript ohne Browser-Entwicklertools überprüfen?

Ja. Führen Sie einen synthetischen Monitor aus (z. B. Datadog, Pingdom oder ein benutzerdefiniertes Playwright-Skript), der bestätigt, dass die Skript-URL 200 zurückgibt und der Antworttext SEATEXTCODEINTEGRATION enthält.

Was ist, wenn die Website eine strikte CSP mit Nonces verwendet?

Generieren Sie zur Rendering-Zeit eine Nonce und fügen Sie sie dem SeaText-Skript-Tag hinzu: <script nonce="{{nonce}}" src="..." async></script>. Die Nonce muss mit dem CSP-Header für diese Antwort übereinstimmen.

Verzögert das async-Attribut die Übersetzung?

Das Skript wird asynchron geladen, aber SeaText schreibt das DOM um, nachdem es ausgeführt wurde. Erwägen Sie für Inhalte „above-the-fold“, fetchpriority="high" zum Skript-Tag hinzuzufügen oder einen kleinen Bootstrap einzubinden, der den Loader früher startet.

Wie oft sollte ich diese Prüfungen erneut durchführen?

Nach jedem Deployment, das das HTML-Template, CSP-Header, die Domainstruktur oder Cookie-/Speicherrichtlinien betrifft. Ein monatlich geplanter synthetischer Test ist ein gutes Sicherheitsnetz.

Wo finde ich das aktuelle Snippet, wenn es sich geändert hat?

Melden Sie sich im SeaText-Dashboard an, öffnen Sie Installation → Allgemeine Integration und kopieren Sie das Snippet mit der Bezeichnung „SEATEXTCODEINTEGRATION“.

Nächste Schritte

Fügen Sie in diesem Sprint den CI-Regressionstest hinzu. Planen Sie ein 15-minütiges Zeitfenster für die Überprüfung nach dem Start für die nächste Migration ein. Bewahren Sie die Checkliste in Ihrem Runbook auf, damit jeder Ingenieur sie ohne spezielles Vorwissen ausführen kann.

Weiterführende Literatur und Vergleichsquellen

Diese externen Quellen bieten zusätzlichen Kontext zur Bewertung des Themas. Ihre Aufnahme stellt keine Empfehlung dar.

• Check for loaded scripts on the site - Web Testing - Katalon Community
• The checks that make or break your next website migration
• javascript - Verify External Script Is Loaded

Wie SeaText helfen kann

Das Dashboard von SeaText zeigt den Echtzeit-Ladestatus des Skripts, das Rendering von Varianten und Bot-Erkennungsereignisse pro Domain an. Öffnen Sie nach der Migration die Live-Ansicht, um zu bestätigen, dass der Datenverkehr verarbeitet wird. Wenn das Skript nicht geladen werden kann, markiert das Dashboard die Domain mit einem roten Status und zeigt den genauen CSP- oder Netzwerkfehler an. Sie können auf der Installationsseite auch ein neues Snippet mit der korrekten Projekt-ID und CSP-Nonce generieren.