So integrieren Sie SeaText in Ihre Website: Implementierungsschritte, Kontrolle und Überprüfung

SeaText verbindet sich mit Ihrer Website über ein leichtgewichtiges JavaScript-Snippet, das Sie einmalig einfügen — typischerweise in den <head>-Bereich oder über den Google Tag Manager. Nachdem das Snippet geladen wurde, aktivieren Sie den Google Ads Landing Page-Agenten (oder andere Agenten) über das SeaText-Dashboard. Der Agent liest den Keyword-Parameter, den Google Ads an Ihre Landingpage-URL anhängt (zum Beispiel ?keyword=bueroflaeche), gleicht ihn mit einer von Ihnen genehmigten Keyword-Liste ab und schreibt den Seiteninhalt um, bevor der Besucher ihn sieht. Sie behalten die volle Kontrolle: Jede umgeschriebene Version erscheint zur Überprüfung im Dashboard, Sie können die KI-Ausgabe manuell bearbeiten, Anweisungen für das Modell hinzufügen oder die Optimierung für jedes beliebige Keyword deaktivieren.

So funktioniert die Integration von Anfang bis Ende

Die Integration besteht aus drei Komponenten: dem Snippet, dem Dashboard und der Agenten-Logik. Das Snippet ist ein einzelnes <script>-Tag, das asynchron geladen wird und weniger als 50 KB (gzipped) groß ist. Es blockiert das Rendering nicht. Sobald es vorhanden ist, überwacht es das Laden der Seite, extrahiert Abfrageparameter (UTM-Begriffe, gclid, benutzerdefinierte Keyword-Parameter) und sendet diese an die SeaText Edge-Funktion. Die Edge-Funktion sucht das Keyword in Ihrer genehmigten Liste, ruft die vorab generierte Variante ab (oder generiert eine „on the fly“, falls es der erste Besuch für dieses Keyword ist) und gibt einen JSON-Patch zurück, den das Snippet auf das DOM anwendet — es tauscht Überschriften, Fließtext, Angebote, Produktblöcke und CTAs aus. Die ursprüngliche Seite bleibt in Ihrem CMS unverändert; Besucher sehen die personalisierte Version nur, solange die Sitzung mit einem genehmigten Keyword übereinstimmt.

Schritt-für-Schritt-Implementierung

1. Erstellen Sie ein SeaText-Konto und öffnen Sie das Dashboard. Im Dashboard verwalten Sie Agenten, Keyword-Listen und überprüfen die umgeschriebenen Texte.
2. Kopieren Sie das Installations-Snippet. Im Dashboard finden Sie eine eindeutige <script src="https://cdn.seatext.com/..." async></script>-Zeile. Fügen Sie diese in den globalen <head>-Bereich Ihrer Website ein oder fügen Sie sie über Google Tag Manager / Segment / Tealium als benutzerdefiniertes HTML-Tag hinzu. Das Snippet funktioniert auf jeder Plattform — WordPress, Webflow, Shopify, statisches HTML, React, Next.js, Vue —, da es lediglich die URL liest und das gerenderte DOM verändert.
3. Überprüfen Sie, ob das Snippet geladen wird. Öffnen Sie Ihre Website mit dem angehängten Parameter ?seatext_debug=1 an einer beliebigen URL. Die Konsole protokolliert "SeaText snippet loaded" und zeigt die erkannten Parameter an. Wenn Sie eine CSP verwenden, fügen Sie https://cdn.seatext.com und https://api.seatext.com zu script-src und connect-src hinzu.
4. Aktivieren Sie den Google Ads Landing Page-Agenten. Schalten Sie im Dashboard den "Google Ads Landing Page AI"-Agenten auf Aktiv. Dieser Agent wurde speziell für Paid-Search-Traffic entwickelt; andere Agenten (Übersetzung, Personalisierung, A/B-Testing usw.) können unabhängig davon aktiviert werden.
5. Verbinden Sie Ihr Google Ads-Konto (optional, aber empfohlen). Durch die Verknüpfung kann SeaText Ihre Kampagnen-/Keyword-Struktur automatisch abrufen und Vorschläge machen, welche Keywords personalisiert werden sollten. Sie können auch manuell eine CSV-Datei mit Keywords hochladen.
6. Erstellen Sie Ihre Keyword-Liste. Klicken Sie für jedes Keyword, das Sie personalisieren möchten, auf Keyword hinzufügen, geben Sie den exakten Begriff ein (z. B. "Kurzzeitmiete") und genehmigen Sie die KI-generierte Umschreibung. Das Dashboard zeigt einen direkten Vergleich: Original vs. Umschreibung. Bearbeiten Sie die Umschreibung bei Bedarf, fügen Sie Anweisungen wie "flexible Checkout-Optionen betonen" hinzu und speichern Sie dann.
7. Legen Sie die Traffic-Zuteilung fest. Standardmäßig sehen 100 % des passenden Traffics die Umschreibung. Sie können diesen Wert senken, um einen Shadow-Test durchzuführen (z. B. 10 %), während Sie die Conversion-Daten überwachen.
8. Gehen Sie live. Klicken Sie auf Veröffentlichen. Der nächste Besucher, der auf eine Anzeige für ein genehmigtes Keyword klickt, sieht die maßgeschneiderte Seite.

Voraussetzungen vor dem Start

• Administratorzugriff auf den <head>-Bereich Ihrer Website oder den Tag Manager. Sie müssen das Snippet einmalig einfügen.
• Google Ads-Kampagnen, die Keyword-Insertion oder explizite Keyword-Tracking-Parameter verwenden. SeaText liest das Keyword aus der Landingpage-URL. Wenn Ihre Anzeigen nur gclid ohne Keyword-Parameter verwenden, aktivieren Sie "Auto-Tagging" in Google Ads und fügen Sie {keyword} zu Ihrem finalen URL-Suffix hinzu (z. B. ?kw={keyword}).
• Eine Liste der Keywords, auf die Sie tatsächlich bieten. Die Personalisierung für Keywords, auf die Sie nicht bieten, verschwendet Zeit bei der Überprüfung und kann organische Besucher verwirren.
• Inhalte, die sicher ausgetauscht werden können. Der Agent schreibt Textknoten und Attributwerte um (Überschriften, Button-Beschriftungen, Meta-Beschreibungen). Er strukturiert kein HTML um, verschiebt keine Container und führt kein benutzerdefiniertes JavaScript aus. Wenn Ihre Seite auf einem starren Layout basiert, bei dem sich ändernde Textlängen das Design zerstören, legen Sie Zeichenlängenbeschränkungen in den Keyword-Einstellungen fest.
• Zustimmung zur Personalisierung gemäß Ihrer Datenschutzrichtlinie. Das Snippet setzt ein First-Party-Cookie (seatext_session), um die Konsistenz der Variante während der Sitzung aufrechtzuerhalten. Geben Sie dies in Ihrem Cookie-Hinweis an.

Was wird umgeschrieben (und was nicht)

Kontrolle & Überprüfung

Jedes von Ihnen genehmigte Keyword erhält eine Versionshistorie im Dashboard. Sie können:

• Vorschau der Umschreibung auf Ihrer Live-URL durch Anhängen von ?seatext_preview=keyword-slug anzeigen.
• Bearbeiten der KI-Ausgabe direkt in einer Rich-Text-Diff-Ansicht.
• Anweisungen hinzufügen wie "UK-Rechtschreibung verwenden" oder "24/7-Support erwähnen", die das Modell bei der nächsten Neugenerierung befolgt.
• Pausieren eines einzelnen Keywords, ohne den Agenten zu deaktivieren.
• Exportieren aller Umschreibungen als CSV zur Compliance-Prüfung.

Um zu überprüfen, ob die Integration in der Produktion funktioniert, öffnen Sie ein Inkognito-Fenster, klicken Sie auf eine Ihrer eigenen Anzeigen (oder simulieren Sie dies mit der exakten finalen URL + Keyword-Parameter) und bestätigen Sie, dass sich die Überschrift ändert. Das "Live-Ansicht"-Panel des Dashboards zeigt zudem Echtzeit-Sitzungen, das übereinstimmende Keyword und die ausgespielte Variante.

Häufige Integrationsszenarien

Szenario A: Einzelne Landingpage, 50+ Keywords

Sie betreiben eine generische Landingpage für eine Google Ads-Kampagne mit 50 Keywords. Nach der Installation des Snippets aktivieren Sie den Google Ads-Agenten, importieren die Keyword-Liste aus Google Ads und genehmigen Umschreibungen für die Top-20-Keywords nach Volumen. Die verbleibenden 30 Keywords greifen auf die ursprüngliche Seite zurück. Ergebnis: Jedes Keyword mit hohem Volumen erhält eine maßgeschneiderte Überschrift und ein Angebot; Long-Tail-Keywords behalten die generische Seite.

Szenario B: Mehrere Landingpages, verschiedene Kampagnen

Sie haben separate Seiten für "Bürofläche", "Coworking" und "virtuelles Büro". Installieren Sie das Snippet global. Erstellen Sie im Dashboard drei Keyword-Gruppen, die dem URL-Pfad der jeweiligen Seite zugeordnet sind. Aktivieren Sie den Agenten. Besucher, die auf "Coworking"-Anzeigen klicken, landen auf der Coworking-Seite und sehen Coworking-spezifische Umschreibungen; Klicks auf "Bürofläche" sehen Büroflächen-Umschreibungen auf der Büroflächen-Seite.

Szenario C: Headless / SPA (Next.js, React Router)

Da das Snippet bei jedem Routenwechsel ausgeführt wird (es überwacht popstate und pushState), funktioniert die Personalisierung bei clientseitiger Navigation. Fügen Sie data-seatext-ignore zu jeder Komponente hinzu, die ihre eigenen Texte über eine CMS-API verwaltet, um ein doppeltes Umschreiben zu verhindern.

Einschränkungen & Wann dieser Rat nicht gilt

• Kein Keyword-Parameter in der URL. Wenn Ihre Anzeigen nur gclid verwenden und Sie keinen Keyword-Parameter hinzufügen können, kann SeaText nicht wissen, welches Keyword den Klick ausgelöst hat. Workaround: Aktivieren Sie das Google Ads Auto-Tagging und fügen Sie {keyword} zum finalen URL-Suffix hinzu.
• Starkes clientseitiges Rendering ohne serverseitigen Text. Wenn die gesamte Seite nach dem Laden aus JSON aufgebaut wird, schreibt das Snippet möglicherweise zu spät um oder übersieht Elemente. Verwenden Sie das data-seatext-ignore-Attribut oder rendern Sie den kritischen Text serverseitig.
• Strenge CSP ohne https://cdn.seatext.com und https://api.seatext.com. Das Snippet wird blockiert. Aktualisieren Sie Ihre Richtlinie.
• Seiten hinter Login oder Paywall. Der Agent funktioniert nur auf öffentlichen URLs, die Google crawlen kann und die Besucher direkt von einer Anzeige aus erreichen können.
• Nicht-Google-Anzeigenplattformen ohne Keyword-Parameter. Der Google Ads-Agent erwartet das Parameterformat von Google. Verwenden Sie für Meta, TikTok oder E-Mail stattdessen den "Visitor Source Rewrites"-Agenten (separate Aktivierung).

Wichtige Fakten

FAQ

Benötige ich Entwicklerhilfe, um das Snippet zu installieren?

Normalerweise nicht. Jeder mit Zugriff auf den <head>-Bereich der Website oder den Google Tag Manager kann die eine Zeile einfügen. Wenn Sie eine strenge CSP verwenden, muss ein Entwickler die beiden Domains zur Richtlinie hinzufügen.

Wird das Snippet meine Seite verlangsamen?

Das Skript lädt asynchron, ist unter 50 KB (gzipped) groß und wird nach DOMContentLoaded ausgeführt. Es blockiert weder das Rendering noch die Core Web Vitals.

Kann ich SeaText ohne Google Ads verwenden?

Ja. Der "Visitor Source Rewrites"-Agent personalisiert nach Referrer (Meta, E-Mail, organisch, direkt) anstatt nach Keyword. Aktivieren Sie diesen Agenten anstelle (oder zusätzlich) zum Google Ads-Agenten.

Was passiert, wenn die KI etwas Ungenaues schreibt?

Sie überprüfen jede Umschreibung vor der Veröffentlichung. Sie können den Text manuell bearbeiten, Korrekturanweisungen hinzufügen oder das Keyword pausieren. Nichts geht ohne Ihre Zustimmung live.

Ändert SeaText meine CMS-Inhalte?

Nein. Umschreibungen erfolgen im Browser via DOM-Mutation. Ihr CMS, Ihre Datenbank und Ihr Quell-HTML bleiben exakt so, wie sie sind.

Kann ich die personalisierte Version gegen das Original A/B-testen?

Ja. Legen Sie die Traffic-Zuteilung für jedes Keyword auf unter 100 % fest (z. B. 50 %), um einen Split-Test durchzuführen. Das Dashboard berichtet Conversions pro Variante.

Gibt es eine kostenlose Testversion?

SeaText bietet einen kostenlosen 1-monatigen Pilotzeitraum für den Google Ads Landing Page-Agenten an. Aktivieren Sie diesen nach der Installation des Snippets über das Dashboard.