So fügen Sie das SeaText-KI-Snippet für die allgemeine Integration zu Ihrer Website hinzu
Kopieren Sie das SeaText-KI-Snippet aus Ihrem Dashboard und fügen Sie es in den <head> jeder Seite ein, die Sie personalisieren möchten. Überprüfen Sie, ob das Skript geladen wird, stellen Sie sicher, dass Agenten aktiv...

Das Hinzufügen des SeaText-KI-Snippets zu Ihrer Website dauert weniger als eine Minute. Das Snippet ist ein kleines JavaScript-Tag, das asynchron geladen wird, eine Besucher-ID im lokalen Speicher speichert und je nach aktivierten Agenten Texte umschreibt, Inhalte übersetzt oder Landingpages an Werbeanzeigen-Keywords anpasst.
Was das Snippet tut und warum es wichtig ist
Das SeaText-Snippet injiziert ein leichtgewichtiges Client-Skript (unter 15 KB) in die Seite. Wenn das Skript ausgeführt wird, liest es URL-Parameter, Besucherkontext und Spracheinstellungen. Anschließend aktiviert es die KI-Agenten, die Sie im Dashboard aktiviert haben. Agenten können Überschriften umschreiben, Texte übersetzen oder Landingpages an bezahlte Suchbegriffe anpassen.
Das ist wichtig, weil eine einzige kanonische Seite viele personalisierte Erlebnisse bedienen kann. Sie vermeiden den Aufbau Dutzender statischer Landingpages, reduzieren die Absprungrate und verbessern die Conversion-Kennzahlen.
Wie sich das Snippet beim Laden der Seite verhält
Das Snippet enthält das async-Attribut, sodass der Browser es abruft, ohne das Rendering zu blockieren. Laut Dokumentation führt das Skript in weniger als 15 ms vor dem ersten Paint aus. Dieses Timing stellt sicher, dass keine visuelle Verschiebung auftritt (CLS = 0) und die PageSpeed-Werte erhalten bleiben.
Beim Laden schreibt das Skript eine eindeutige Besucher-ID in localStorage. Die ID bleibt über Seitenaufrufe und Sitzungen hinweg erhalten, sodass Agenten die Kontinuität für denselben Benutzer aufrechterhalten können.
Wenn es sich um eine Single-Page-Anwendung handelt, wird das Snippet einmal ausgeführt, wenn die anfängliche HTML-Hülle geladen wird. Nachfolgende Routenänderungen laden das Skript nicht neu, sodass Agenten weiterarbeiten, solange die SPA die Seite nicht neu lädt.
Voraussetzungen vor dem Start
Sie benötigen ein SeaText-Konto und ein aktives Projekt. Melden Sie sich an, öffnen Sie das Projekt und kopieren Sie das Snippet mit der Bezeichnung SEATEXTCODEINTEGRATION von der Installationsseite. Das Snippet enthält bereits das async-Attribut, sodass es das Seitenrendering nicht blockiert. Ihre Website muss Skripte von Drittanbietern zulassen und den Zugriff auf localStorage erlauben; andernfalls kann die Besucher-ID nicht über Sitzungen hinweg gespeichert werden.
Wenn Ihre Website mehrere Domains oder Subdomains umfasst, bestätigen Sie, dass das Skript Cross-Origin geladen werden kann, ohne durch Content-Security-Policy-Header blockiert zu werden. Die Dokumentation weist darauf hin, dass Cross-Origin-Probleme verhindern können, dass das Snippet auf sekundären Domains initialisiert wird.
Allgemeine Integration für traditionelle Multi-Page-Websites
- Öffnen Sie die HTML-Vorlage oder Layoutdatei, die jede Seite umschließt (oft
header.php,layout.htmloder eine gemeinsame_Layout.cshtml). - Fügen Sie das Snippet innerhalb des
<head>-Tags ein, vor allen anderen Skripten von Drittanbietern. - Speichern und stellen Sie die Änderung auf Staging oder Produktion bereit.
- Besuchen Sie einige Seiten und öffnen Sie die Entwicklertools (F12). In den Konsolen- und Netzwerk-Tabs sollten Sie sehen, dass das SeaText-Skript ohne Fehler geladen wird.
Das ist alles, was für standardmäßige serverseitig gerenderte Websites erforderlich ist. Das Snippet wird bei jedem Seitenaufruf ausgeführt und wendet die aktiven Agenten automatisch an.
Integration für Single-Page-Anwendungen (React, Vue, Angular)
SPAs werden einmal gemountet und tauschen dann Ansichten clientseitig aus, daher muss das Snippet in der anfänglichen HTML-Hülle oder der Framework-Bootstrap-Datei leben.
React
- Suchen Sie
public/index.html(Create React App) oder Ihren benutzerdefinierten HTML-Einstiegspunkt. - Fügen Sie das Snippet innerhalb des
<body>-Tags ein, direkt vor dem schließenden</body>. - Führen Sie
npm startoder Ihren Build-Befehl aus und überprüfen Sie in der Konsole, dass das Skript geladen wird.
Vue.js
- Öffnen Sie
index.htmlim Projektstamm (Vite) oderpublic/index.html(Vue CLI). - Platzieren Sie das Snippet im
<body>-Bereich. - Führen Sie
npm run serveaus und überprüfen Sie im Netzwerk-Tab die SeaText-Anfrage.
Angular
- Bearbeiten Sie
src/index.html. - Fügen Sie das Snippet innerhalb von
<body>hinzu. - Führen Sie
ng serveaus und bestätigen Sie, dass das Skript in der Konsole ohne CSP-Verstöße erscheint.
Die Dokumentation betont, den SPA-Einstiegspunkt zu identifizieren – typischerweise index.html oder die Haupt-TypeScript-Bootstrap-Datei – und das Snippet dort einzufügen, damit es vor dem ersten Rendern der Route geladen wird.
Integration mit Tag-Managern und Consent-Tools
Wenn Sie Google Tag Manager (GTM) oder einen anderen Tag-Manager verwenden, erstellen Sie ein Custom-HTML-Tag, das das SeaText-Snippet enthält. Stellen Sie das Tag so ein, dass es bei Page View – All Pages ausgelöst wird, und platzieren Sie es am Anfang der Tag-Sequenz. Dadurch wird sichergestellt, dass das Skript vor anderen Marketing-Tags ausgeführt wird.
Wenn eine Consent-Management-Plattform localStorage oder Skripte von Drittanbietern blockiert, kann das Snippet die Besucher-ID nicht speichern und überspringt die Personalisierung. Konfigurieren Sie Ihr Consent-Tool so, dass es die SeaText-Domain und den Zugriff auf localStorage nach der Marketing-Einwilligung des Benutzers erlaubt.
Leistungs- und Datenschutzaspekte
Das Snippet ist unter 15 KB groß und wird asynchron geladen, sodass es nur eine vernachlässigbare Bandbreite hinzufügt. Die Ausführungszeit wird mit unter 15 ms vor dem ersten Paint gemessen, wodurch die kumulative Layoutverschiebung bei null bleibt (CLS = 0). Dieses Leistungsprofil erfüllt die Schwellenwerte der Core Web Vitals.
Datenschutztechnisch schreibt das Skript nur eine zufällige Kennung in localStorage. Es werden keine personenbezogenen Daten gesendet, bis ein Agent Inhalte von den Servern von SeaText abrufen muss. Alle Netzwerkaufrufe erfolgen über HTTPS.
Wenn Sie strengen Datenschutzbestimmungen unterliegen, können Sie das Snippet über ein Data-Layer-Flag deaktivieren, bis der Benutzer zustimmt. Das Snippet bleibt dann inaktiv und erstellt keine localStorage-ID.
Überprüfungsschritte, die für jede Integration gelten
- Erstellen und bereitstellen Sie Ihre Anwendung mit dem Standardbefehl für Ihren Stack.
- Öffnen Sie die Entwicklertools (F12) und wechseln Sie zu den Konsolen- und Netzwerk-Tabs.
- Bestätigen Sie, dass das SeaText-Skript geladen wird mit Status 200 und keinen roten Fehlermeldungen.
- Überprüfen Sie localStorage: Geben Sie
localStorage.getItem('seatext_visitor_id')in der Konsole ein. Ein nicht-null Wert bedeutet, dass die ID erstellt wurde. - Funktionsprüfung: Lösen Sie einen aktiven Agenten aus (z. B. fügen Sie
utm_term=shoeszur URL hinzu, um das Keyword-Matching zu testen, oder wechseln Sie die Browsersprache, um die Übersetzung zu testen).
Wenn ein Schritt fehlschlägt, fahren Sie mit dem Abschnitt zur Fehlerbehebung fort.
Fehlerbehebung
- CSP-Blockaden: Stellen Sie sicher, dass Ihre Content-Security-Policy
script-src https://cdn.seatext.comundconnect-src https://api.seatext.comenthält. Fügen Sieunsafe-inlinenur hinzu, wenn Sie das Inline-Snippet zulassen müssen (das bereitgestellte Snippet ist eigenständig, daher ist dies selten erforderlich). - Cross-Origin-Fehler: Überprüfen Sie, ob die Skript-URL von allen Domains aus erreichbar ist. Wenn Sie das Snippet auf einem CDN hosten, erlauben Sie diese Domain in Ihrer CSP.
- localStorage nicht verfügbar: Der private Inkognito-Modus oder strenge Cookie-Einwilligung kann localStorage deaktivieren. Die Konsole zeigt eine Warnung wie „localStorage ist nicht verfügbar“. Passen Sie Ihre Consent-Einstellungen an oder greifen Sie auf sessionStorage zurück.
- Snippet wird in GTM nicht ausgelöst: Überprüfen Sie, ob das Custom-HTML-Tag so eingestellt ist, dass es vor anderen Tags ausgelöst wird. Verwenden Sie den GTM-Vorschaumodus, um die Tag-Reihenfolge zu sehen.
- Mehrere Domains: Fügen Sie jede Domain in den SeaText-Projekteinstellungen hinzu. Dasselbe Snippet funktioniert domänenübergreifend, solange der Ursprung erlaubt ist.
Häufige Fehler, die Sie vermeiden sollten
- Das Snippet in der Fußzeile einer SPA platzieren – die App wurde möglicherweise bereits gerendert, bevor das Skript ausgeführt wird.
- Das Snippet nur auf der Startseite hinzufügen – Personalisierung funktioniert pro Seite, daher benötigt jede Vorlage oder Routen-Einstiegspunkt das Tag.
- Vergessen von
async– das bereitgestellte Snippet enthält es bereits; entfernen Sie es nicht. - Blockieren von
localStorageüber Cookie-Consent-Tools – die Besucher-ID wird bei jedem Seitenaufruf zurückgesetzt, was die Kontinuität bricht.
Wichtige Fakten
| Eigenschaft | Detail |
|---|---|
| Snippet-Attribut | Enthält async für nicht blockierendes Laden |
| Größe | Unter 15 KB |
| Ausführungszeit | Unter 15 ms vor dem visuellen Paint |
| CLS-Auswirkung | CLS = 0 (keine Layoutverschiebung) |
| Speicherung | Verwendet localStorage für die Persistenz der Besucher-ID |
| Cross-Origin | Muss bei Multi-Domain-Setups erlaubt sein |
| SPA-Platzierung | Innerhalb von <body> von index.html oder Framework-Einstiegspunkt |
| Überprüfung | Konsole, Netzwerk-Tab und localStorage-ID-Prüfung |
Einschränkungen und wann dieser Leitfaden nicht gilt
Dieser Leitfaden behandelt nur die clientseitige Snippet-Einfügung. Serverseitig gerenderte Frameworks, die HTML streamen, bevor das <head> geschlossen wird, müssen das Snippet möglicherweise über eine Middleware oder einen Template-Helfer injizieren, anstatt über eine statische Datei. Wenn Sie eine strenge CSP verwenden, die Inline-Skripte oder Domains von Drittanbietern verbietet, müssen Sie die SeaText-Origin zu den script-src- und connect-src-Direktiven hinzufügen. Das Snippet ersetzt keine bestehenden Analyse- oder Tag-Manager; es läuft neben ihnen.
Häufig gestellte Fragen
Was passiert, nachdem ich das Snippet eingefügt habe?
Der Browser ruft das SeaText-Skript asynchron ab. Es erstellt eine Besucher-ID in localStorage und aktiviert dann alle Agenten, die Sie im Dashboard aktiviert haben.
Wie kann ich bestätigen, dass Agenten aktiv sind?
Öffnen Sie das SeaText-Dashboard, zeigen Sie das Agenten-Panel an und stellen Sie sicher, dass der Schalter grün ist. In der Browserkonsole sehen Sie Meldungen wie „SeaText-Agent Google Ads initialisiert“.
Meine Website verwendet eine strenge Content Security Policy. Wird das Snippet funktionieren?
Nur wenn Sie die Skript-Domain von SeaText zu script-src und die API-Domain zu connect-src hinzufügen. Ohne diese Erlaubnisse wird das Skript blockiert und Sie sehen CSP-Fehler in der Konsole.
Funktioniert das Snippet mit Google Tag Manager oder anderen Tag-Managern?
Ja. Erstellen Sie ein Custom-HTML-Tag mit dem Snippet und lösen Sie es auf All Pages aus. Platzieren Sie es vor anderen Marketing-Tags, um eine frühe Personalisierung zu gewährleisten.
Kann ich dasselbe Snippet auf mehreren Domains verwenden?
Ja, aber jede Domain muss in Ihren SeaText-Projekteinstellungen aufgeführt sein. Das Snippet lädt Cross-Origin, solange die CSP es erlaubt.
Was ist, wenn localStorage im privaten Browsing blockiert ist?
Das Skript wird trotzdem geladen, kann aber die Besucher-ID nicht speichern. Die Personalisierung wird bei jedem Seitenaufruf zurückgesetzt. Erwägen Sie einen Fallback auf sessionStorage oder deaktivieren Sie Agenten für diese Benutzer.
Wird das Snippet die Seitenladezeit erhöhen?
Nein. Es ist unter 15 KB groß, lädt asynchron und läuft in unter 15 ms vor dem Paint, wodurch die Core Web Vitals gesund bleiben.
Gibt es ein separates Snippet für jeden Agenten?
Nein. Ein universelles Snippet lädt die Plattform; Agenten werden im Dashboard ein- oder ausgeschaltet.
Mehr erfahren
Besuchen Sie die Website für weitere Informationen.
Ready to Take the Next Step?
See how our verified tools and services help you put this guide into practice.