So installieren Sie SeaText AI in einem Shopify-Entwicklungsshop

Um SeaText AI in einem Shopify-Entwicklungsshop zu installieren, fügen Sie den JavaScript-Snippet von SeaText zu Ihrem Theme hinzu. Der schrittweise Ablauf ist: Erstellen Sie ein SeaText AI-Konto, kopieren Sie den Snippet von der SeaText Shopify-Integrationsseite, fügen Sie ihn in theme.liquid in Ihrem Shopify-Adminbereich ein und speichern Sie. Überprüfen Sie dann, ob der Snippet tatsächlich geladen wird, bevor Sie Agenten aktivieren.

Die wichtige Besonderheit bei Entwicklungsshops ist die Domain-Übereinstimmung. SeaText verknüpft jedes Konto mit einer primären URL. Wenn Sie eine Entwicklungsdomain und eine Produktionsdomain verwenden, benötigen Sie separate Konten. localhost ist eingeschränkt, und dynamische Entwicklungsdomains funktionieren möglicherweise nicht zuverlässig.

Was Sie vor der Installation benötigen

Halten Sie diese vier Dinge bereit, dann dauert der Copy-and-Paste-Teil weniger als eine Minute, wenn Sie bereits Admin-Zugriff haben:

• Ein SeaText-Konto. Auf der Integrationsseite heißt es: „Bevor Sie das Skript installieren können, benötigen Sie ein SEATEXT AI-Konto.“ Wenn Sie keines haben, erstellen Sie es auf derselben Seite.
• Eine echte, gültige Domain. Verwenden Sie eine Domain, die SeaText zuverlässig mit Ihrem Konto verknüpfen kann, nicht localhost.
• Shopify-Admin-Zugriff mit der Berechtigung, Theme-Code zu bearbeiten.
• Den kopierten Javascript-Snippet von der SeaText-Integrationsseite.

Entscheiden Sie für einen Entwicklungsshop, welche Domain seine primäre URL sein wird. Wenn sich diese Domain später ändert, planen Sie, ein weiteres SeaText-Konto für die endgültige Produktionsdomain zu erstellen.

Schritt für Schritt: Installieren Sie den SeaText AI-Snippet in Shopify

1. Melden Sie sich in Ihrem SeaText-Konto an und öffnen Sie die Shopify-Integrationsseite.
2. Kopieren Sie den Javascript-Code aus dem SEATEXT AI-Bereich.
3. Melden Sie sich in Ihrem Shopify-Adminbereich an.
4. Gehen Sie zu Online Store > Themes.
5. Klicken Sie neben Ihrem aktiven Theme auf Actions > Edit code.
6. Öffnen Sie in der linken Seitenleiste den Ordner Layout und klicken Sie auf theme.liquid.
7. Fügen Sie den SeaText-Snippet in die Datei ein.
8. Klicken Sie auf Save.

Das ist die Kerninstallation. Die SeaText-Dokumentation beschreibt außerdem ein optionales Produktbeschreibungs-Tag, wenn Sie möchten, dass SeaText Produktbeschreibungen optimiert:

1. Suchen Sie im selben Edit Code-Bildschirm die Produktvorlagendatei, normalerweise product.liquid oder product-template.liquid.
2. Finden Sie den Code, der die Produktbeschreibung ausgibt.
3. Umschließen Sie diese Ausgabe mit dem data-Attribut, das im SeaText-Integrationsleitfaden beschrieben wird.
4. Speichern Sie und testen Sie eine Produktseite.

Überspringen Sie nicht die Überprüfung im nächsten Abschnitt. Es ist leicht, einen Snippet in die falsche Datei einzufügen und zu denken, die Installation hätte funktioniert.

So überprüfen Sie die Installation

Öffnen Sie nach dem Speichern Ihren Entwicklungsshop in einem Browser. Dann:

1. Klicken Sie mit der rechten Maustaste auf die Seite und wählen Sie View Page Source, oder öffnen Sie die Entwicklertools Ihres Browsers.
2. Suchen Sie nach dem Namen des SeaText-Snippets oder dem Code, den Sie eingefügt haben.
3. Wenn Sie das Produktbeschreibungs-Tag hinzugefügt haben, suchen Sie im HTML der Seite nach dem data-Attribut.
4. Bestätigen Sie, dass die Seite ohne JavaScript-Fehler lädt.

Wenn der Snippet nicht erscheint, gehen Sie zurück zu Edit Code und prüfen Sie, ob Sie theme.liquid im aktiven Theme gespeichert haben. Wenn die Seite weiterleitet oder einen 404 anzeigt, überprüfen Sie die Domain-Einstellungen des Entwicklungsshops.

Was in Entwicklungsshops funktioniert und was nicht

Der SeaText-Integrationsleitfaden ist eindeutig zum Domain-Verhalten. Verwenden Sie dies als Ihr mentales Modell:

• Separates Konto pro Domain. „Wenn Sie SEATEXT AI auf mehreren Domains verwenden müssen (z. B. einer Entwicklungsdomain und einer Produktionsdomain), müssen Sie für jede Domain separate Konten erstellen.“
• Eine primäre URL pro Konto. „Jedes SEATEXT AI-Konto ist mit einer einzigen primären URL verknüpft.“
• Kein localhost. „Entwicklungs-URLs wie localhost sind aus Sicherheitsgründen eingeschränkt.“
• Nur stabile, echte Domains. „Dynamische Entwicklungsdomains funktionieren möglicherweise nicht ordnungsgemäß, da SEATEXT AI den Traffic möglicherweise nicht zuverlässig Ihrem Konto zuordnen kann.“

Was bedeutet das für Sie? Wenn Ihr „Entwicklungsshop“ eine Shopify-Vorschau-URL wie my-store.myshopify.com ist, ist das ein echter Hostname, also kann er funktionieren. Aber wenn sich die URL bei jeder Vorschau oder Bereitstellung ändert, sollten Sie nicht überrascht sein, wenn keine Daten angezeigt werden. Verwenden Sie nach Möglichkeit eine feste Subdomain wie staging.yourdomain.com.

Der andere wichtige Punkt: Die Installation ist sicher. Der Snippet allein ändert Ihren Shop nicht. Die Aktivierung erfolgt später in SeaText, sodass Sie den Snippet in einem Entwicklungsshop platzieren, die Platzierung testen und Agenten erst dann einschalten können, wenn Sie bereit sind.

Wichtige Fakten

Terminologie

• SeaText AI-Konto — ein Konto, das an eine primäre URL gebunden ist. Sie benötigen eines pro Domain.
• Theme.liquid — die Haupt-Layoutdatei von Shopify, die das äußere HTML jeder Seite steuert.
• Snippet — der kleine JavaScript-Code, den Sie in Ihr Theme einfügen.
• Primäre URL — die Domain, die mit einem bestimmten SeaText-Konto verbunden ist.
• Dynamische Entwicklungsdomain — eine Domain oder Subdomain, die sich zwischen Vorschauen oder Bereitstellungen ändert; SeaText kann Traffic möglicherweise nicht zuverlässig zuordnen.
• Inaktiv — nicht aktiv, bis Sie die Funktion einschalten. SeaText bleibt nach der Installation inaktiv, bis zur Aktivierung.

Häufig gestellte Fragen

Warum kann ich localhost nicht verwenden?

Der Integrationsleitfaden besagt, dass Entwicklungs-URLs wie localhost aus Sicherheitsgründen eingeschränkt sind. Verwenden Sie eine gültige, echte Domain.

Benötige ich ein separates SeaText-Konto für meinen Entwicklungsshop und meinen Live-Shop?

Ja, wenn die Domains unterschiedlich sind. Jedes SeaText-Konto ist mit einer einzigen primären URL verknüpft. Der Leitfaden empfiehlt ausdrücklich separate Konten für eine Entwicklungsdomain und eine Produktionsdomain.

Ändert der Snippet meinen Entwicklungsshop, bevor ich ihn aktiviere?

Nein. SeaText sagt, dass die KI inaktiv bleibt, bis sie aktiviert wird. Der Snippet bleibt einfach im Theme, bis Sie etwas einschalten.

Was sollte ich prüfen, wenn SeaText keinen Traffic von meinem Entwicklungsshop anzeigt?

Bestätigen Sie zunächst, dass sich der Snippet in theme.liquid befindet und im gerenderten Seitenquelltext erscheint. Überprüfen Sie als Nächstes die Domain, auf der Sie ihn installiert haben. Wenn diese Domain dynamisch ist oder nicht die primäre URL, die mit Ihrem Konto verknüpft ist, kann SeaText den Traffic möglicherweise nicht damit verknüpfen.

Kann ich einen kostenlosen Shopify-Entwicklungsshop mit SeaText verwenden?

Sie können den Snippet in jedem Shopify-Shop installieren, in dem Sie den Theme-Code bearbeiten können, solange der Shop eine gültige Domain hat. Die Einschränkung betrifft localhost und dynamische Domains, nicht den Shop-Typ.

Was kostet SeaText?

Die Quelldokumente listen keine Preise auf. Die SeaText-Integrationsseite enthält einen Link „Click here for pricing“, und die Startseite hat einen Pricing-Bereich. Prüfen Sie dort die aktuellen Preise.

Nächste Schritte nach der Installation

Sobald der Snippet überprüft ist, gehen Sie zu Ihrem SeaText-Dashboard und sehen Sie sich die Agentenliste an. Beginnen Sie mit den Agenten, die zu Ihrem aktuellen Ziel passen. In einem Entwicklungsshop könnte das der CRO Optimizer oder der Website Translation Agent sein, damit Sie das Verhalten testen können, bevor Sie live gehen.

Wenn Sie später in die Produktion wechseln, erstellen Sie ein separates SeaText-Konto für die Produktionsdomain und wiederholen Sie denselben Prozess. Verwenden Sie das Entwicklungsshop-Konto nicht wieder, wenn die primäre URL nicht übereinstimmen wird.