So überprüfen Sie die SeaText AI-Verbindung zu Ihrem Shopify-Shop

Sie können überprüfen, ob SeaText AI korrekt mit Ihrem Shopify-Shop verbunden ist, indem Sie eine Produktseite in einem Browser öffnen und den HTML-Code auf das Attribut data-seatext untersuchen. Sie sollten außerdem bestätigen, dass das SeaText JavaScript-Snippet weiterhin in der Datei theme.liquid Ihres aktiven Shopify-Themes vorhanden ist. Wenn beide Prüfungen erfolgreich sind, ist die Verbindung aktiv.

Warum die Überprüfung wichtig ist

SeaText verwendet JavaScript auf Ihrem Shop, um autonome KI-Agenten auszuführen. Diese Agenten können Überschriften, Angebote, Produktblöcke und CTAs basierend auf dem Keyword oder der Kampagne hinter jedem Besuch umschreiben. Wenn das Skript nicht verbunden ist, haben die Agenten keine Möglichkeit, Shop-Daten zu lesen oder Änderungen zu veröffentlichen. Sie könnten glauben, dass eine Kampagne optimiert wird, während der Shop tatsächlich die Standardseite ausliefert.

Die Überprüfung gibt Ihnen die Sicherheit, dass die Bereitstellungsebene funktioniert, bevor Sie sich auf KI-Ergebnisse verlassen. Sie hilft Ihnen auch dabei, kleine Probleme, wie ein fehlendes Snippet nach einem Theme-Update, zu erkennen, bevor diese die Conversions beeinträchtigen.

Was eine korrekte SeaText-Verbindung bedeutet

Eine korrekte Verbindung ist mehr als nur ein gespeichertes Skript. Es bedeutet, dass das SeaText-Skript mit Ihrem Shopify-Theme geladen werden kann, die Produktbeschreibung findet und den Inhalt markiert, den es verarbeitet hat.

SeaText wird als JavaScript installiert, das Sie in Ihr Theme einfügen. Vor der Aktivierung bleibt die KI inaktiv. Sie ändert Ihren Shop erst, wenn sie eingeschaltet wird. Das schützt Ihre Inhalte während der Installation.

Die Überprüfung sollte drei Fragen beantworten: Ist das Snippet im aktiven Theme vorhanden? Lädt die Produktseite es? Kann das Skript sein data-Attribut an ein verarbeitetes Element anhängen?

Wenn alle drei Fragen mit Ja beantwortet werden, kann SeaText mit Ihren Shop-Daten kommunizieren.

Wie das SeaText-Skript in theme.liquid geladen wird

Die Shopify-Integrationsanleitung von SeaText weist Sie an, ein JavaScript-Snippet in die theme.liquid einzufügen. Diese Datei steuert das globale Layout Ihres Shop-Themes.

Beginnen Sie in Ihrem Shopify-Adminbereich. Gehen Sie zu Onlineshop und dann zu Themes. Öffnen Sie das Menü „Aktionen“ für Ihr aktives Theme und wählen Sie „Code bearbeiten“. Öffnen Sie im Ordner „Layout“ die Datei theme.liquid. Fügen Sie das SeaText-Code-Snippet ein und klicken Sie auf Speichern.

theme.liquid ist der richtige Ort für das Skript, da Shopify es auf jeder Seite lädt, die Ihr Theme verwendet. Das bedeutet, dass Produktseiten, Kategorieseiten und Startseiten die Möglichkeit haben, den SeaText-Code auszuführen.

Wenn Sie das Snippet in ein anderes Theme einfügen, wird es im Live-Shop nicht ausgeführt. Das aktive Theme ist dasjenige, das Ihre Besucher sehen. Ein dupliziertes oder archiviertes Theme reicht nicht aus.

Auch das Produkt-Template ist wichtig. Die Integrationsanleitung von SeaText besagt, dass das Tag in Produktbeschreibungen implementiert werden muss. Suchen Sie die Datei, die die Produktbeschreibung rendert, normalerweise product.liquid oder product-template.liquid. Umschließen Sie die Ausgabe der Produktbeschreibung, damit das Skript weiß, welchen Inhalt es optimieren soll.

Wenn das Snippet vorhanden ist und die Beschreibung umschlossen wurde, kann das Skript auf der Produktseite geladen werden und Inhalte für die Modifikation durch SeaText vorbereiten.

Wie eine erfolgreiche Skript-Kommunikation im Browser aussieht

Eine erfolgreiche Kommunikation ist im gerenderten HTML sichtbar. SeaText fügt ein data-Attribut zu Elementen hinzu, die es verarbeitet hat. Die Entwicklertools Ihres Browsers zeigen dieses Attribut bei der Produktbeschreibung oder anderen modifizierten Seitenelementen an.

Sie müssen keine komplexen Protokolle einsehen. Das Vorhandensein des data-Attributs ist das praktische Signal dafür, dass das Skript geladen wurde und seine Arbeit getan hat.

Erfolgreiche Kommunikation bedeutet auch, dass der Shop weiterhin normal funktioniert. Die Produktbeschreibung sollte korrekt angezeigt werden, nachdem SeaText sie geändert hat. Wenn die Seite ohne Fehler gerendert wird und das data-Attribut vorhanden ist, kann das Skript mit Ihren Shop-Daten kommunizieren.

Denken Sie daran, dass SeaText möglicherweise nicht jedes Element sofort umschreibt. Die KI wird erst aktiv, nachdem Sie die benötigten Agenten aktiviert haben. Ein inaktives Skript kann dennoch verbunden sein; es wurde lediglich noch nicht angewiesen, Inhalte zu ändern.

So überprüfen Sie das data-seatext-Attribut

Öffnen Sie Ihren Shopify-Shop in einem Browser. Gehen Sie zu einer Produktseite, die die umschlossene Produktbeschreibung enthält.

Klicken Sie mit der rechten Maustaste auf die Seite und wählen Sie „Untersuchen“. Dies öffnet die Entwicklertools. Suchen Sie im Tab „Elemente“ nach data-seatext oder dem in der SeaText-Dokumentation beschriebenen data-Attribut.

Verwenden Sie das Suchfeld innerhalb des Elemente-Bereichs, um das Attribut zu finden. Der Browser hebt das passende HTML-Element hervor.

Wenn das Attribut erscheint, ist das Skript auf dieser Seite aktiv. Wenn es nicht erscheint, fahren Sie mit den unten stehenden Schritten zur Fehlerbehebung fort.

Sie können dies auch überprüfen, indem Sie den HTML-Quelltext anzeigen. Die Integrationsanleitung empfiehlt, eine Produktseite in der Vorschau zu betrachten und zu bestätigen, dass das data-Attribut im HTML-Quelltext vorhanden ist. Die Entwicklertools bieten Ihnen dieselbe Ansicht mit mehr Kontext.

Warum jedes Konto eine primäre URL benötigt

Jedes SeaText AI-Konto ist mit einer einzigen primären URL verknüpft. Diese URL ist die Shop-Domain, die mit dem Konto verbunden ist.

Wenn Sie versuchen, dasselbe Konto auf mehreren Domains zu verwenden, funktioniert die Verbindung nicht korrekt. Zum Beispiel müssen eine Entwicklungs-Domain und eine Produktions-Domain separate Konten haben.

Diese Regel schützt die Verkehrsmessung. SeaText muss wissen, welche Besuche zu Ihrem Shop gehören. Wenn eine Seite von einer anderen Domain als der primären URL geladen wird, wird das Skript zwar möglicherweise ausgeführt, aber SeaText ordnet diesen Datenverkehr möglicherweise nicht Ihrem Konto zu.

Entwicklungs-URLs wie localhost sind aus Sicherheitsgründen eingeschränkt. Sie sind keine gültigen Produktions-Shops, daher blockiert SeaText sie. Dynamische Entwicklungs-Domains können ebenfalls fehlschlagen, da SeaText den Datenverkehr nicht zuverlässig Ihrem Konto zuordnen kann.

Vergleichen Sie während der Überprüfung die Shop-Domain mit der primären URL in Ihrem SeaText-Konto. Wenn sie nicht übereinstimmen, ist die Verbindung nicht vollständig. Wenden Sie sich an den Anbieter, wenn Sie die primäre URL ändern müssen.

So beheben Sie häufige Ursachen für Verbindungsabbrüche

Verwenden Sie diese Checkliste in der angegebenen Reihenfolge. Sie isoliert die meisten Verbindungsprobleme.

1. Öffnen Sie Onlineshop, Themes, Aktionen, Code bearbeiten für das aktive Theme. Öffnen Sie Layout/theme.liquid. Suchen Sie nach dem SeaText-Snippet. Wenn es fehlt, fügen Sie es erneut ein und speichern Sie.
2. Bestätigen Sie, dass die primäre URL des Kontos mit der Shop-Domain übereinstimmt. Eine Nichtübereinstimmung ist eine häufige Ursache für eine unterbrochene Verbindung.
3. Stellen Sie sicher, dass Sie nicht auf localhost oder einer dynamischen Entwicklungs-Domain testen. Verwenden Sie eine gültige, echte Domain.
4. Öffnen Sie eine Produktseite, untersuchen Sie sie und suchen Sie nach data-seatext. Wenn das Attribut fehlt, hat das Skript dieses Element nicht verarbeitet.
5. Bestätigen Sie, dass die Produktbeschreibung im Produkt-Template mit dem SeaText-Tag umschlossen ist. Ohne das Tag wird das Skript möglicherweise geladen, hat aber nichts zu markieren.

Diese Checkliste funktioniert wie ein Entscheidungsbaum. Wenn das Snippet fehlt, fügen Sie es wieder hinzu. Wenn die URL falsch ist, korrigieren Sie das Konto oder wenden Sie sich an den Anbieter. Wenn die Domain eingeschränkt ist, wechseln Sie zu einer echten Domain. Wenn das Attribut immer noch fehlt, überprüfen Sie das Tag im Produkt-Template.

Einschränkungen der Überprüfungsmethode

Das data-Attribut erscheint nur bei Elementen, die SeaText verarbeitet hat. Wenn Ihre Produktbeschreibung nicht mit dem SeaText-Tag umschlossen ist, kann eine Produktseite das Skript zwar laden, zeigt aber dennoch kein Attribut an.

Entwicklungs-URLs wie localhost funktionieren nicht. Dynamische Entwicklungs-Domains funktionieren möglicherweise ebenfalls nicht. Verwenden Sie eine gültige, echte Domain für Verbindungstests.

Ein SeaText-Konto kann nicht mehrere Domains abdecken. Jedes Konto ist mit einer einzigen primären URL verknüpft. Wenn Sie das Skript auf einem zweiten Shop benötigen, erstellen Sie ein separates Konto für diese Domain.

Praxisbeispiel: Überprüfung nach einem Theme-Update

Ein Shop-Betreiber aktualisiert sein Shopify-Theme. Nach dem Update zeigen Produktbeschreibungen keine SeaText-Änderungen mehr an.

Zuerst öffnet der Betreiber den Onlineshop und wählt Themes aus. Er wählt „Code bearbeiten“ für das aktive Theme. In Layout/theme.liquid sucht er nach dem SeaText-Snippet. Es ist verschwunden, da das neue Theme die Datei ersetzt hat.

Er fügt das Snippet erneut ein und speichert die Datei. Dann öffnet er eine Produktseite in einem neuen Browser-Tab erneut. Er untersucht die Seite und sucht nach data-seatext. Das Attribut erscheint nun bei der Produktbeschreibung.

Der Betreiber prüft außerdem, ob die Shop-Domain mit der primären URL des Kontos übereinstimmt. Das tut sie. Die Verbindung ist verifiziert.

Wenn das Attribut immer noch gefehlt hätte, würde der Betreiber das Produkt-Template überprüfen und bestätigen, dass die Beschreibung mit dem SeaText-Tag umschlossen ist. Er würde außerdem vermeiden, localhost während des Tests zu verwenden.

Terminologie

Primäre URL

Die echte Domain, die mit einem SeaText-Konto verknüpft ist.

data-seatext

Ein HTML-Attribut, das SeaText zu verarbeiteten Elementen hinzufügt.

theme.liquid

Die globale Layout-Datei in einem Shopify-Theme, in die das SeaText-Snippet gehört.

Wichtige Fakten

FAQ

Was beweist das data-seatext-Attribut?

Es beweist, dass das SeaText-Skript auf der Seite geladen wurde und das Element verarbeitet hat. Das ist das zentrale Signal für eine funktionierende Verbindung.

Warum ist localhost blockiert?

SeaText schränkt Entwicklungs-URLs wie localhost aus Sicherheitsgründen ein. Verwenden Sie eine gültige, echte Domain, wenn Sie die Verbindung überprüfen.

Kann ich ein SeaText-Konto auf einer Entwicklungs-Domain und einer Produktions-Domain verwenden?

Nein. Jedes Konto ist mit einer primären URL verknüpft. Erstellen Sie für jede Domain ein separates Konto.

Was sollte ich nach dem Wechsel von Themes tun?

Öffnen Sie das neue aktive Theme, bearbeiten Sie theme.liquid und fügen Sie das SeaText-Snippet erneut ein. Überprüfen Sie dann eine Produktseite auf das data-Attribut.

Was ist, wenn das data-Attribut nicht erscheint?

Überprüfen Sie das Snippet in theme.liquid, bestätigen Sie, dass die primäre URL des Kontos mit dem Shop übereinstimmt, stellen Sie sicher, dass die Domain nicht localhost ist, und bestätigen Sie, dass die Produktbeschreibung mit dem SeaText-Tag umschlossen ist.

Garantiert ein gespeichertes Snippet, dass die Verbindung funktioniert?

Nein. Das Snippet muss im aktiven Theme vorhanden sein, die Produktbeschreibung muss umschlossen sein und die Domain muss mit der primären URL übereinstimmen.