So testen Sie, ob SeaText AI mit Ihrer Website verbunden ist

Schnelle Antwort

Installieren Sie den SeaText-JavaScript-Code auf jeder Seite. Öffnen Sie anschließend Ihre Website in einem Browser und bleiben Sie mindestens 40 Sekunden auf einer beliebigen Seite. Kehren Sie zum SeaText-Dashboard zurück und beobachten Sie die Kopfzeile neben dem SeaText-Logo. Der Name Ihrer Website sollte innerhalb von fünf Minuten erscheinen. Wenn er nach zehn Minuten nicht angezeigt wird, wurde die Verbindung nicht hergestellt. Sie müssen dann die Installation überprüfen oder den Support kontaktieren.

Voraussetzungen vor dem Test

• Ein aktives SeaText-AI-Konto. Jedes Konto ist mit einer einzigen primären URL verknüpft.
• Das aus Ihrem SeaText-Dashboard kopierte JavaScript-Snippet (mit der Bezeichnung SEATEXTCODEINTEGRATION).
• Zugriff auf das <head>-Element Ihrer Website oder auf einen Tag Manager, damit Sie das Snippet auf jeder zu überwachenden Seite einfügen können.
• Wenn Sie WP Engine als Hosting verwenden, installieren Sie vor dem Hinzufügen des Snippets das WP-Engine-Plugin, das das Einfügen von benutzerdefiniertem JavaScript ermöglicht.

Entwicklungs-URLs wie localhost und dynamische Vorschau-Domains sind aus Sicherheitsgründen eingeschränkt. Verwenden Sie für den Test eine echte, öffentlich auflösbare Domain. Wenn Sie SeaText auf einer Staging-Domain und einer Produktionsdomain benötigen, erstellen Sie für jede Domain ein separates Konto, wie im Quelltext angegeben: „Mehrere Domains ... jedes SEATEXT-AI-Konto ist mit einer einzigen primären URL verknüpft“ (S1).

Schritt 1: Überprüfen, ob das Skript im Browser geladen wird

1. Öffnen Sie Ihre Website in einem neuen Inkognito-Fenster.
2. Öffnen Sie die Entwicklertools des Browsers (F12 oder Rechtsklick → Untersuchen) und wechseln Sie zum Tab Konsole.
3. Laden Sie die Seite neu. Suchen Sie nach einer Netzwerkanfrage an seatext.com oder nach einem Konsolenprotokoll, das die Initialisierung von SeaText erwähnt.
4. Wenn die Anfrage durch eine Content-Security-Policy, einen Werbeblocker oder eine verzögerte Skriptausführung blockiert wird, passen Sie die Richtlinien oder Tag-Manager-Einstellungen so an, dass das SeaText-Skript ausgeführt wird, bevor das Laden der Seite abgeschlossen ist.

Warum das wichtig ist: Das Skript ist die einzige Möglichkeit, wie der Browser das SeaText-Backend kontaktieren kann. Eine blockierte Anfrage bedeutet, dass die KI die Sitzungsdaten des Besuchers nie erhält und das Dashboard daher niemals den Namen Ihrer Website anzeigen wird.

Schritt 2: Die 40-sekündige Aufenthaltsdauer erfüllen

SeaText aktiviert die KI erst, nachdem ein echter Besuch erkannt wurde. Bleiben Sie mindestens 40 Sekunden auf einer beliebigen Seite Ihrer Website. Schließen Sie den Tab nicht, navigieren Sie nicht weg und drosseln Sie den Tab nicht im Hintergrund. Diese Aufenthaltsdauer ermöglicht es dem Skript, einen Handshake mit den SeaText-Servern durchzuführen, eine Sitzungs-ID zu erstellen und den Besuch zu registrieren. Im Quelltext wird dies betont: „Wichtig: Besuchen oder aktualisieren Sie Ihre Website mehrmals und bleiben Sie mindestens 40 Sekunden auf Ihrer Seite – dadurch wird die KI aktiviert und mit Ihrem Konto verknüpft“ (S1).

Technisches Detail: Das Skript setzt beim Laden der Seite einen Timer. Nach 40 Sekunden sendet es eine POST-Anfrage mit der Seiten-URL, einem eindeutigen Besuchertoken und der primären Domain des Kontos. Das Backend überprüft die Domain anhand des Kontodatensatzes und markiert die Website als „verbunden“, wenn sie übereinstimmt.

Schritt 3: Im Dashboard nach dem Websitenamen suchen

1. Melden Sie sich bei Ihrem SeaText-Konto an.
2. Sehen Sie in der oberen Kopfzeile neben dem SeaText-Logo nach.
3. Warten Sie bis zu fünf Minuten. Der Name Ihrer Website sollte dort erscheinen und die Verbindung bestätigen.

Wenn der Name erscheint, ist die Integration aktiv. Sie können nun zum Main AI Hub wechseln, um Agenten zu aktivieren, Parameter zu konfigurieren oder Varianten zu bearbeiten. Die Dashboard-Kopfzeile ist eine einfache Zustandsprüfung; sie bestätigt, dass mindestens ein erfolgreicher Handshake stattgefunden hat.

Schritt 4: Eine testweise KI-Antwort auslösen (optional)

Sobald der Websitename im Dashboard angezeigt wird, gehen Sie zu Main AI Hub → Konfiguration und aktivieren Sie einen Agenten wie den CRO Optimizer. Besuchen Sie eine Seite, auf der der Agent ausgeführt wird, und überprüfen Sie, ob sich der Seiteninhalt (Überschrift, CTA oder Übersetzung) entsprechend den Regeln des Agenten ändert. Dadurch wird bestätigt, dass die KI nicht nur verbunden ist, sondern aktiv Inhalte umschreibt.

Eine Testantwort hilft Ihnen außerdem zu überprüfen, ob das Skript früh genug ausgeführt wird. Wenn Sie einen Tag Manager verwenden, stellen Sie den SeaText-Tag so ein, dass er bei Page View – DOM Ready oder früher ausgelöst wird. Andernfalls verpasst der Agent möglicherweise die ursprüngliche Anfrage.

Häufige Gründe für einen Verbindungsfehler

• Skript nicht auf jeder Seite: SeaText muss auf jeder zu überwachenden Seite geladen werden. Eine Installation auf nur einer Seite verbindet nur diese Seite. Stellen Sie sicher, dass das Snippet in einer globalen Kopfzeile oder über einen Tag Manager eingefügt wird, der auf allen URLs ausgelöst wird.
• CSP oder Werbeblocker blockiert die Anfrage: Überprüfen Sie die Konsole auf Fehler wie blocked:csp oder net::ERR_BLOCKED_BY_CLIENT. Passen Sie den Content-Security-Policy-Header so an, dass script-src https://seatext.com erlaubt ist, und setzen Sie die Domain auf die Whitelist des Werbeblockers.
• Tag Manager wird zu spät ausgelöst: Wenn der Tag erst nach window.onload ausgelöst wird, startet der 40-Sekunden-Timer möglicherweise zu spät, sodass der Handshake das erforderliche Zeitfenster verpasst. Stellen Sie den Tag so ein, dass er bei DOM Ready ausgelöst wird, oder verwenden Sie einen benutzerdefinierten HTML-Tag, der vor anderen Skripten platziert wird.
• Falsche Domain im Konto: Jedes Konto akzeptiert nur seine registrierte primäre URL. Eine Abweichung verhindert den Handshake. Überprüfen Sie, ob die in Ihrem SeaText-Dashboard aufgeführte Domain mit der getesteten URL übereinstimmt.
• Verwendung einer eingeschränkten Entwicklungs-URL: localhost, 127.0.0.1 oder dynamische Vorschau-Domains werden keine Verbindung herstellen. Im Quelltext wird darauf hingewiesen, dass diese „aus Sicherheitsgründen eingeschränkt“ sind (S1).
• Serverseitiges Rendering entfernt das Skript: Einige SSR-Frameworks fügen Skripte nur auf der Client-Seite ein. Wenn das Skript den Browser nie erreicht, schlägt die Verbindung fehl. Verwenden Sie eine clientseitige Injektionsmethode oder deaktivieren Sie SSR für das Snippet.
• Edge-Caching liefert eine veraltete Version: CDNs können eine ältere HTML-Datei ohne das Snippet zwischenspeichern. Leeren Sie den Cache, nachdem Sie das Skript hinzugefügt haben.

Empfehlungen für die Praxis: Testen Sie immer in einem sauberen Inkognito-Fenster, deaktivieren Sie Werbeblocker und überprüfen Sie die Netzwerkanfrage im Tab „Netzwerk“ der Entwicklertools.

Checkliste zur Überprüfung

Wann Sie den Support kontaktieren sollten

Wenn der Websitename innerhalb von zehn Minuten nach dem 40-sekündigen Aufenthalt auf einer gültigen Domain mit fehlerfrei geladenem Skript nicht neben dem SeaText-Logo erscheint, kontaktieren Sie den SeaText-Support. Die Verzögerung weist normalerweise auf ein plattformspezifisches Installationsproblem hin (z. B. serverseitiges Rendering, das das Skript entfernt, Edge-Caching oder einen CSP-Header, den Sie nicht ändern können). Stellen Sie dem Supportteam Konsolenprotokolle, Details zur Netzwerkanfrage und die genaue getestete URL zur Verfügung.

Einschränkungen des Verbindungstests

• Die Dashboard-Kopfzeile bestätigt lediglich, dass das Skript einmal eine Verbindung zum Server hergestellt hat. Sie garantiert nicht, dass jede Seitenvariante oder jeder Agent korrekt funktioniert.
• Für mehrere Domains sind separate Konten erforderlich; ein einzelnes Dashboard zeigt nicht mehrere Websites an. Dies wird im Quelltext angegeben: „Jedes SEATEXT-AI-Konto ist mit einer einzigen primären URL verknüpft“ (S1).
• Dynamische Entwicklungsdomains (z. B. Vercel-Vorschau-URLs) stellen möglicherweise nie zuverlässig eine Verbindung her, weil SeaText den Datenverkehr nicht dauerhaft Ihrem Konto zuordnen kann.
• Der Test überprüft keine Übersetzungsagenten, Bot-Schutz-Agenten oder anderen spezialisierten Module. Für diese sind eigene Funktionstests erforderlich.
• Der Verbindungsstatus kann durch Netzwerklatenz oder die Verbreitung über ein CDN verzögert werden, insbesondere bei weltweit verteilten Websites.

Häufig gestellte Fragen

Kann ich auf localhost testen?

Nein. Entwicklungs-URLs wie localhost sind aus Sicherheitsgründen eingeschränkt. Verwenden Sie eine echte Domain oder eine öffentliche Staging-Domain.

Muss ich das Skript nach einer Änderung der primären URL in meinem Konto neu installieren?

Ja. Jedes Konto ist mit einer einzigen primären URL verknüpft. Wenn Sie die Domain ändern, müssen Sie die Skriptquelle aktualisieren oder ein neues Konto für die neue Domain erstellen.

Wie lange dauert die erste Verbindung?

Bis zu fünf Minuten nach einem 40-sekündigen Aufenthalt. Wenn es länger als zehn Minuten dauert, betrachten Sie dies als Fehler und suchen Sie nach der Ursache.

Bleibt die Verbindung über Subdomains hinweg bestehen?

Nur wenn dasselbe Skript auf jeder Subdomain installiert ist und die primäre URL im Konto mit der Root-Domain übereinstimmt. Subdomains in verschiedenen Konten benötigen separate Installationen.

Kann ich einen Tag Manager verwenden, statt das Theme zu bearbeiten?

Ja, sofern der Tag früh (DOM Ready) ausgelöst und nicht durch die CSP blockiert wird. Überprüfen Sie in der Konsole, ob das Skript fehlerfrei geladen wird.

Was ist, wenn ich WP Engine verwende?

Installieren Sie das WP-Engine-Plugin, das das Einfügen von benutzerdefiniertem JavaScript ermöglicht. Fügen Sie anschließend das SeaText-Snippet über dieses Plugin hinzu, damit es auf jeder Seite geladen wird.

Bestätigt der Test, dass Übersetzungen funktionieren?

Nein. Der Verbindungstest bestätigt nur, dass das Skript mit dem Backend kommuniziert. Aktivieren Sie den Website-Übersetzungsagenten und besuchen Sie eine Seite in einer Zielsprache, um die Übersetzungen zu überprüfen.