Seatext library

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...

So fügen Sie das SeaText-KI-Snippet für die allgemeine Integration zu Ihrer Website hinzu

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.

Looking to implement this for your website?
Mehr erfahren →

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

  1. Öffnen Sie die HTML-Vorlage oder Layoutdatei, die jede Seite umschließt (oft header.php, layout.html oder eine gemeinsame _Layout.cshtml).
  2. Fügen Sie das Snippet innerhalb des <head>-Tags ein, vor allen anderen Skripten von Drittanbietern.
  3. Speichern und stellen Sie die Änderung auf Staging oder Produktion bereit.
  4. 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

  1. Suchen Sie public/index.html (Create React App) oder Ihren benutzerdefinierten HTML-Einstiegspunkt.
  2. Fügen Sie das Snippet innerhalb des <body>-Tags ein, direkt vor dem schließenden </body>.
  3. Führen Sie npm start oder Ihren Build-Befehl aus und überprüfen Sie in der Konsole, dass das Skript geladen wird.

Vue.js

  1. Öffnen Sie index.html im Projektstamm (Vite) oder public/index.html (Vue CLI).
  2. Platzieren Sie das Snippet im <body>-Bereich.
  3. Führen Sie npm run serve aus und überprüfen Sie im Netzwerk-Tab die SeaText-Anfrage.

Angular

  1. Bearbeiten Sie src/index.html.
  2. Fügen Sie das Snippet innerhalb von <body> hinzu.
  3. Führen Sie ng serve aus 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

  1. Erstellen und bereitstellen Sie Ihre Anwendung mit dem Standardbefehl für Ihren Stack.
  2. Öffnen Sie die Entwicklertools (F12) und wechseln Sie zu den Konsolen- und Netzwerk-Tabs.
  3. Bestätigen Sie, dass das SeaText-Skript geladen wird mit Status 200 und keinen roten Fehlermeldungen.
  4. Ü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.
  5. Funktionsprüfung: Lösen Sie einen aktiven Agenten aus (z. B. fügen Sie utm_term=shoes zur 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.com und connect-src https://api.seatext.com enthält. Fügen Sie unsafe-inline nur 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

EigenschaftDetail
Snippet-AttributEnthält async für nicht blockierendes Laden
GrößeUnter 15 KB
AusführungszeitUnter 15 ms vor dem visuellen Paint
CLS-AuswirkungCLS = 0 (keine Layoutverschiebung)
SpeicherungVerwendet localStorage für die Persistenz der Besucher-ID
Cross-OriginMuss bei Multi-Domain-Setups erlaubt sein
SPA-PlatzierungInnerhalb von <body> von index.html oder Framework-Einstiegspunkt
ÜberprüfungKonsole, 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.

Recommended Solution

Ready to Take the Next Step?

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