Seatext library

So fügen Sie das SeaText-Snippet mit dem Google Tag Manager zu Shopify hinzu

Fügen Sie das SeaText-Snippet über den GTM zu Shopify hinzu, indem Sie das GTM-Container-Snippet in theme.liquid installieren und dann ein benutzerdefiniertes HTML-Tag im GTM erstellen, das das SeaText-JavaScript enthält und auf allen Seiten ausgelöst...

So fügen Sie das SeaText-Snippet mit dem Google Tag Manager zu Shopify hinzu

Fügen Sie das SeaText-Snippet mit dem Google Tag Manager zu Shopify hinzu, indem Sie zuerst das GTM-Container-Snippet in Ihrem Theme installieren und dann ein benutzerdefiniertes HTML-Tag innerhalb des GTM erstellen, das das SeaText-JavaScript enthält. Lösen Sie dieses Tag auf allen Seiten aus. Bevor Sie dies tun können, benötigen Sie ein SeaText-Konto und eine Kopie des JavaScript-Snippets aus dem SEATEXT AI-Integrationsbereich.

Dieser Leitfaden führt Sie in geordneten Schritten durch die Einrichtung, einschließlich des Produktbeschreibungs-Tags und der Überprüfung, ob alles ordnungsgemäß funktioniert.

Was Sie vor dem Start benötigen

Sie benötigen fünf Dinge, bevor Sie beginnen:

  • Ein SeaText-Konto. Die SeaText-Integrationsseite besagt, dass Sie eines benötigen, bevor Sie das Skript installieren können.
  • Das SeaText-JavaScript-Snippet. Sie kopieren es aus dem SEATEXT AI-Integrationsbereich.
  • Administratorzugriff auf Ihren Shopify-Shop, damit Sie den Theme-Code bearbeiten können.
  • Ein Google Tag Manager-Konto mit einem erstellten Container. Sie benötigen die Container-ID, normalerweise GTM-XXXXXXX.
  • Eine gültige, echte Domain. Entwicklungs-URLs wie localhost sind eingeschränkt.

Schritt 1: Holen Sie sich Ihr SeaText-Snippet und Ihr Konto

Wenn Sie noch kein SeaText-Konto haben, erstellen Sie zuerst eines. Die Integrationsanweisungen besagen, dass Sie ein Konto benötigen, bevor Sie das Skript installieren können.

Looking to implement this for your website?
Öffnen Sie den SeaText Shopify-Integrationsleitfaden →

Sobald Sie eingeloggt sind, gehen Sie zum SEATEXT AI-Integrationsbereich und kopieren Sie den dort angezeigten JavaScript-Code. Speichern Sie ihn an einem sicheren Ort. Dies ist das Snippet, das Sie dem Google Tag Manager geben werden.

Beachten Sie die Domain-Regel: Jedes SeaText-Konto ist mit einer einzigen primären URL verknüpft. Wenn Sie auf einer Entwicklungs-Domain testen und auf einer Produktions-Domain live gehen möchten, erstellen Sie für jede ein separates Konto. Localhost ist blockiert und dynamische Entwicklungs-Domains funktionieren möglicherweise nicht zuverlässig, da SeaText den Datenverkehr möglicherweise nicht Ihrem Konto zuordnen kann.

Schritt 2: Fügen Sie den GTM-Container zu Shopify hinzu

Der Google Tag Manager kann nichts laden, bis sein eigenes Container-Snippet in Ihrem Theme vorhanden ist. Dies ist eine einmalige Code-Bearbeitung.

  1. Loggen Sie sich in Ihren Shopify-Adminbereich ein.
  2. Gehen Sie zu „Onlineshop“ und öffnen Sie „Themes“.
  3. Klicken Sie neben Ihrem aktiven Theme auf „Aktionen“ und wählen Sie „Code bearbeiten“.
  4. Öffnen Sie den Ordner „Layout“ und klicken Sie auf „theme.liquid“.
  5. Fügen Sie das erste GTM-Snippet direkt nach dem öffnenden head-Tag ein.
  6. Fügen Sie das zweite GTM-Snippet, die noscript-Version, direkt nach dem öffnenden body-Tag ein.
  7. Klicken Sie auf „Speichern“.

Fügen Sie SeaText an dieser Stelle nicht in theme.liquid ein. Der nächste Schritt verknüpft SeaText stattdessen mit dem GTM. Auf diese Weise können Sie das Snippet aktualisieren, ohne den Theme-Code erneut bearbeiten zu müssen.

Schritt 3: Erstellen Sie das benutzerdefinierte HTML-Tag für SeaText im GTM

Öffnen Sie nun den Google Tag Manager und fügen Sie das SeaText-Snippet als Tag hinzu.

  1. Öffnen Sie Ihren GTM-Arbeitsbereich.
  2. Klicken Sie auf „Tags“ und dann auf „Neu“.
  3. Klicken Sie auf „Tag-Konfiguration“ und wählen Sie „Benutzerdefiniertes HTML“.
  4. Fügen Sie das SeaText-JavaScript-Snippet ein, das Sie in Schritt 1 kopiert haben.
  5. Klicken Sie auf „Trigger“ und wählen Sie „All Pages“ (Alle Seiten). Für eine reine Produkt-Einrichtung verwenden Sie einen Seitenpfad-Trigger für Produktseiten.
  6. Klicken Sie auf „Speichern“ und geben Sie dem Tag einen klaren Namen, wie z. B. SeaText - Alle Seiten.

Ein Tag im GTM wird erst ausgeführt, wenn Sie den Container übermitteln und veröffentlichen. Verwenden Sie den Vorschaumodus, bevor Sie veröffentlichen.

Schritt 4: Fügen Sie das Produktbeschreibungs-Tag von SeaText hinzu (falls erforderlich)

Die Shopify-Integration von SeaText enthält auch ein Tag für Produktbeschreibungen. Fügen Sie dieses nicht in den GTM ein. Es gehört in das Theme-Template, das die Produktbeschreibung rendert.

  1. Gehen Sie im Shopify-Adminbereich zu „Onlineshop“ und öffnen Sie „Themes“.
  2. Klicken Sie auf „Aktionen“ und wählen Sie „Code bearbeiten“.
  3. Suchen Sie das Produkt-Template. Die SeaText-Quelle nennt product.liquid oder product-template.liquid als typische Speicherorte.
  4. Suchen Sie den Code für die Ausgabe der Produktbeschreibung.
  5. Umschließen Sie diese Ausgabe mit dem Datenattribut oder Wrapper, den SeaText in seiner Dokumentation bereitstellt.
  6. Klicken Sie auf „Speichern“.

Nach dem Speichern zeigen Sie eine Produktseite in der Vorschau an und untersuchen Sie den HTML-Quellcode mit den Entwicklertools Ihres Browsers. Überprüfen Sie, ob das data-Attribut in der Ausgabe erscheint.

Schritt 5: Überprüfen Sie, ob das SeaText-Snippet geladen wird

Die Überprüfung ist der Schritt, bei dem die meisten Fehler entdeckt werden. Überspringen Sie ihn nicht.

  • Klicken Sie im GTM auf „Vorschau“, um den Tag Assistant zu öffnen.
  • Öffnen Sie Ihren Shopify-Shop in einem anderen Tab und laden Sie die Seite neu.
  • Überprüfen Sie, ob das Tag „SeaText - Alle Seiten“ ausgelöst wird.
  • Öffnen Sie die Entwicklertools des Browsers und wechseln Sie zum Tab „Netzwerk“. Suchen Sie nach einer Anfrage des SeaText-Skripts.
  • Wenn Sie das Produktbeschreibungs-Tag hinzugefügt haben, öffnen Sie eine Produktseite und untersuchen Sie den HTML-Quellcode auf das data-Attribut.

Wenn das GTM-Tag ausgelöst wird, aber kein Skript im Netzwerk-Tab erscheint, überprüfen Sie den Trigger und bestätigen Sie, dass die Container-Version veröffentlicht wurde. Wenn das Skript erscheint, aber das Produktattribut fehlt, liegt das Problem im Produkt-Template, nicht im GTM.

Häufige Fehler und wie man sie vermeidet

  • Installation ohne Konto. SeaText sagt, dass Sie ein SEATEXT AI-Konto benötigen, bevor Sie das Skript installieren.
  • Verwendung desselben Kontos für mehrere Domains. Jedes Konto ist mit einer primären URL verknüpft. Verwenden Sie separate Konten für separate Domains.
  • Testen auf localhost. Entwicklungs-URLs sind eingeschränkt, verwenden Sie also eine gültige, echte Domain.
  • Veröffentlichen des GTM ohne Vorschau. Immer zuerst eine Vorschau anzeigen, dann veröffentlichen.
  • Einfügen von SeaText sowohl in theme.liquid als auch in den GTM. Dies kann dazu führen, dass das Snippet zweimal geladen wird. Wählen Sie eine Methode.
  • Bearbeiten des falschen Themes. Stellen Sie sicher, dass Sie das Live-Theme bearbeiten, nicht eine Kopie.
  • Versuch, Produktbeschreibungen innerhalb des GTM zu umschließen. Dieser Wrapper gehört in product.liquid oder product-template.liquid.

Wichtige Fakten: SeaText-Installation und Domain-Regeln

Die folgende Tabelle listet die Fakten von der SeaText Shopify-Integrationsseite auf.

FaktDetail
KontovoraussetzungSie benötigen ein SEATEXT AI-Konto, bevor Sie das Skript installieren.
Snippet-QuelleKopieren Sie den JavaScript-Code aus dem SEATEXT AI-Integrationsbereich.
Domain-BindungJedes SEATEXT AI-Konto ist mit einer einzigen primären URL verknüpft.
Mehrere DomainsErstellen Sie separate Konten für jede Domain.
Entwicklungs-URLsLocalhost ist eingeschränkt; verwenden Sie eine gültige, echte Domain.
SicherheitDer Installationsprozess ist sicher und die KI bleibt inaktiv, bis sie aktiviert wird.
Produktbeschreibungs-TagUmschließen Sie die Ausgabe der Produktbeschreibung und überprüfen Sie das data-Attribut im HTML-Quellcode.

Einschränkungen und wann dieser Leitfaden nicht gilt

Dieser Leitfaden setzt ein Standard-Shopify Online Store 2.0-Theme mit einer theme.liquid-Datei voraus. Die meisten Themes funktionieren auf diese Weise, aber Headless-Setups oder stark angepasste Themes platzieren Skripte möglicherweise anders.

Der GTM löst Tags asynchron aus. Wenn die SeaText-Dokumentation einen bestimmten Trigger erfordert, wie z. B. „DOM Ready“ oder „Window Loaded“, verwenden Sie diesen Trigger anstelle von „All Pages“. Der richtige Trigger hängt davon ab, worauf das Skript auf der Seite zugreifen muss.

Die Domain-Regel gilt auch bei der Verwendung des GTM. Ein SeaText-Konto ist mit einer primären URL verknüpft, und Entwicklungs-URLs wie localhost sind eingeschränkt. Wenn Sie von einer Staging-Subdomain auf Ihre Produktions-Domain umziehen, planen Sie die Erstellung eines separaten Kontos ein, anstatt davon auszugehen, dass dasselbe Snippet funktioniert.

Wenn Sie den GTM überhaupt nicht verwenden möchten, können Sie das SeaText-Snippet direkt in theme.liquid einfügen, indem Sie die Shopify-Integrationsschritte von SeaText befolgen. Der GTM ist eine Verwaltungsebene, keine Voraussetzung für SeaText.

SeaText und GTM: Terminologie in einfachem Deutsch

  • Snippet: Ein kleines Stück JavaScript, das Sie einer Seite hinzufügen.
  • Container: Ihr Google Tag Manager-Arbeitsbereich und seine Einstellungen.
  • Tag: Ein Codeblock im GTM, der ausgelöst wird, wenn Bedingungen erfüllt sind.
  • Trigger: Die Bedingung, wie z. B. „Alle Seiten“, die einem Tag mitteilt, wann es ausgeführt werden soll.
  • theme.liquid: Die Haupt-Layout-Datei in Ihrem Shopify-Theme, die jede Seite umschließt.

Häufig gestellte Fragen

Benötige ich ein separates SeaText-Konto für meinen Entwicklungs-Shop?

Ja. Jedes SeaText-Konto ist mit einer einzigen primären URL verknüpft und localhost ist eingeschränkt. Verwenden Sie für jede Umgebung eine echte Domain.

Kann ich SeaText ohne GTM installieren?

Ja. Fügen Sie das Snippet direkt in theme.liquid ein oder folgen Sie den Shopify-Integrationsschritten von SeaText. Der GTM macht es nur einfacher, das Snippet zu verwalten.

Warum den GTM verwenden, wenn ich das Snippet in theme.liquid einfügen kann?

Mit dem GTM können Sie das Snippet aktualisieren, Trigger hinzufügen und andere Skripte von Drittanbietern an einem Ort verwalten, ohne jedes Mal den Theme-Code bearbeiten zu müssen.

Wo füge ich den GTM-Container in Shopify ein?

In theme.liquid. Fügen Sie den ersten Teil nach dem öffnenden head-Tag und den noscript-Teil nach dem öffnenden body-Tag hinzu.

Woher weiß ich, ob das SeaText-Snippet funktioniert?

Verwenden Sie den GTM-Vorschaumodus, um zu bestätigen, dass das Tag ausgelöst wird, und überprüfen Sie dann den Netzwerk-Tab auf das Skript. Untersuchen Sie für das Produktbeschreibungs-Tag den HTML-Quellcode der Seite auf das data-Attribut.

Benötigt das Produktbeschreibungs-Tag den GTM?

Nein. Es gehört in das Produkt-Template, normalerweise product.liquid oder product-template.liquid.

Weiterführende Literatur und Vergleichsquellen

Diese externen Quellen bieten zusätzlichen Kontext zur Bewertung des Themas. Ihre Aufnahme stellt keine Empfehlung dar.

Wie SeaText helfen kann

Wie SeaText helfen kann

SeaText bietet Ihnen ein JavaScript-Snippet, das speziell für Ihren Shopify-Shop entwickelt wurde. Der Installationsprozess ist sicher und die KI bleibt inaktiv, bis Sie sie aktivieren. Erstellen Sie vor der Installation ein SeaText-Konto und verwenden Sie eine gültige, echte Domain, da jedes Konto an eine primäre URL gebunden ist. Für Produktbeschreibungen bietet SeaText auch ein separates data-Attribut-Tag, das Sie um die Ausgabe der Produktbeschreibung in Ihrem Theme-Template legen.

Verwenden Sie den offiziellen Integrationsleitfaden, um den genauen Code zu sehen, den Ihr Konto generiert, und um zu vermeiden, dass das Snippet in der falschen Datei platziert wird.

Recommended Solution

Ready to Take the Next Step?

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