Shoplotse English

Doku · Shoplotse Google

Einrichtung, Einstellungen und Neuigkeiten

Shoplotse Google verbindet JTL-Shop 5 mit Google Analytics 4, Google Ads, dem Tag Manager und der Google-Suche. Gemessen wird erst nach Zustimmung im Cookie-Banner. Du brauchst dafür keine KI und kein Claude-Abo.

In 10 Minuten startklar

  1. Plugin-ZIP über den persönlichen Link aus der Kauf-E-Mail laden und im Shop-Backend unter Plugins → Plugin-Manager → Hochladen hochladen und installieren.
  2. Plugins → Installierte Plugins → Shoplotse Google öffnen, Reiter „Einrichtung“: als Erstes den Lizenzschlüssel eintragen (beginnt mit SL-).
  3. Im Reiter „Einstellungen“ die GA4 Mess-ID eintragen und „Messung aktiv“ auf Ja stellen.
  4. Versandkosten je Land, Lieferzeit und Rückgabe eintragen, damit die Produktdaten für die Google-Suche erscheinen.
  5. Zurück im Reiter „Einrichtung“ die Schritte durchgehen, bis alles grün oder grau ist.
  6. Testkauf machen oder in Analytics unter „Echtzeit“ nachsehen, ob Besuche ankommen.

Voraussetzungen

JTL-Shop ab 5.2 (getestet mit 5.8.1), PHP 8.1 oder neuer (getestet mit 8.3 und 8.4). Für die Produktdaten NOVA oder ein NOVA-Child-Template, die Messung läuft mit jedem Template. Consent-Manager eingeschaltet (Darstellung → Standardelemente → Consent-Manager).

Datenschutz

Kundennamen, E-Mail-Adressen und Anschriften gehen nie an Google, außer SHA-256-verschlüsselt bei eingeschalteten Enhanced Conversions. Deine Datenschutzerklärung muss Google Analytics 4 nennen und, falls genutzt, Google Ads, Tag Manager, Enhanced Conversions und den Kauf über den Server. Template-Dateien werden nicht verändert. Das Plugin ersetzt keine Rechtsberatung.

Der Einrichtungsassistent

Der Reiter „Einrichtung“ prüft bei jedem Öffnen, ob alles startklar ist. Grün heißt erledigt, gelb bitte ansehen, blau selbst nachsehen, grau optional.

SchrittWas geprüft wird
1. LizenzschlüsselSchlüssel aus der Kauf-E-Mail eintragen (beginnt mit SL-). Ohne gültige Lizenz sendet das Plugin nichts an Google.
2. GA4 Mess-IDDie Mess-ID aus Analytics (beginnt mit G-) unter Einstellungen eintragen.
3. Cookie-BannerPrüft, ob der JTL Consent-Manager eingeschaltet ist und der Eintrag „Google Analytics und Google Ads“ erscheint.
4. Doppelte MessungWarnt, wenn ein anderes Plugin oder Code im Template schon misst. Sonst zählen Käufe doppelt.
5. DatenschutzerklärungPrüft, ob deine Datenschutzseite Google Analytics erwähnt.
6. TestenAnleitung für den Test in Analytics unter „Echtzeit“, mit und ohne Zustimmung.
7. ProduktdatenVersandkosten je Land, Lieferzeit und Rückgabe eintragen. Dann erscheinen sie als Produktdaten für die Google-Suche.
8. Google AdsOptional: Conversion-ID und Label für den Kauf. Alternativ den Kauf aus Analytics in Ads importieren.
9. Search ConsoleOptional: Bestätigungs-Tag einfügen, damit Google den Shop als deinen erkennt.
10. Google ShoppingOptional: prüft dein vorhandenes Exportformat auf typische Fehler.
11. Berichte im BackendOptional: Google-Dienstkonto mit reinen Leserechten für den Reiter „Berichte“.
12. Mehr messenOptional: Tag Manager, Enhanced Conversions und Kauf über den Server, mit Warnung vor doppelter Messung.

Einstellungen

Alle Felder im Reiter „Einstellungen“. Nur die GA4 Mess-ID (oder ein Tag-Manager-Container) ist Pflicht.

EinstellungBedeutung
Messung aktivNein = nichts an Google senden.
GA4 Mess-IDBeginnt mit G-. Kleinschreibung und Leerzeichen werden korrigiert.
Google Ads Conversion-ID / -LabelAW-…. Wer AW-123456789/AbCdEf einfügt, braucht das Label-Feld nicht.
Enhanced ConversionsJa/Nein, Standard Nein. In Google Ads bei den Conversion-Einstellungen ebenfalls einschalten.
Tag-Manager Container-IDGTM-…, auch der ganze Schnipsel geht. Ist GA4 im Container eingerichtet, die GA4 Mess-ID leer lassen.
Measurement-Protocol API-SecretAus Analytics → Verwaltung → Datenstreams → Web-Stream → „Measurement Protocol API-Secrets“.
Produktdaten ergänzenJa/Nein.
MarkeLeer = Shopname. Ein in der Wawi gepflegter Hersteller hat Vorrang.
Versandkosten je LandEine Zeile je Land, z. B. DE 4,90 frei ab 50 und AT 9,90.
Bearbeitungszeit, Laufzeit, Rückgabefrist, RücksendekostenIn Tagen. Versand und Rückgabe erscheinen erst, wenn alles ausgefüllt ist.
Search Console BestätigungGanzen HTML-Tag oder nur den Code einfügen.
Google-Schlüssel (Dienstkonto)Inhalt der JSON-Datei eines Google-Dienstkontos, nur für den Reiter „Berichte“.
Analytics Property-IDDie Zahl aus Analytics → Verwaltung → Property-Details (nicht die Mess-ID).
Search-Console-PropertyLeer = automatisch. Sonst sc-domain:deinshop.de oder https://www.deinshop.de/.

Was gemessen wird

Alle Ereignisse gehen im GA4-Format an Google und liegen beim Tag Manager im dataLayer. Ohne Zustimmung im Cookie-Banner geht nichts raus.

EreignisWann
page_viewJede Seite
view_item_listKategorieseite
searchSuchergebnis
view_itemArtikelseite
add_to_cart / remove_from_cartArtikel in den Warenkorb oder heraus
view_cartWarenkorb
begin_checkoutKasse betreten
add_shipping_info / add_payment_infoVersand- und Zahlungsart gewählt
purchaseBestellabschluss, mit Umsatz, Versand und Bestellnummer. Jede Bestellung genau einmal.

Berichte einrichten

Der Reiter „Berichte“ liest Zahlen aus Analytics und Search Console über ein eigenes Google-Dienstkonto mit reinen Leserechten. Google Cloud kostet dafür nichts. Die Klick-Anleitung steht auch im Reiter „Einrichtung“.

  1. In Google Cloud ein Projekt anlegen und die „Google Analytics Data API“ und die „Google Search Console API“ aktivieren.
  2. Ein Dienstkonto anlegen und dafür einen Schlüssel als JSON herunterladen.
  3. Den Inhalt der Datei im Plugin unter „Einstellungen“ einfügen, dazu die Analytics Property-ID.
  4. Die E-Mail-Adresse des Dienstkontos (endet auf .gserviceaccount.com) in Google Analytics als „Betrachter“ und in der Search Console mit Berechtigung „Eingeschränkt“ hinzufügen.

Hilfe bei Problemen

„SyntaxError“ beim Hochladen

Meist ist die Backend-Anmeldung abgelaufen oder der Hoster blockiert ZIP-Dateien mit PHP-Code. Seite neu laden (F5) und noch einmal hochladen, oder die ZIP entpacken und den Ordner shoplotse_google per FTP nach plugins/ kopieren. Oft ist das Plugin trotz der Meldung angekommen: im Reiter „Vorhanden“ nachsehen.

In Analytics kommt nichts an

Im Reiter „Einrichtung“ prüfen, ob Lizenz und Mess-ID grün sind. Dann den Shop in einem privaten Fenster öffnen, im Cookie-Banner zustimmen und in Analytics unter „Echtzeit“ nachsehen.

Käufe zählen doppelt

Ein zweites Plugin oder ein Google-Code im Template misst mit. Der Schritt „Doppelte Messung“ zeigt, wo. Nur eine Messung aktiv lassen.

Versand und Rückgabe fehlen in der Google-Suche

Alle Felder bei Versand und Rückgabe ausfüllen, sonst gibt das Plugin sie nicht aus. Google braucht danach oft einige Tage. Prüfen lässt es sich mit dem Rich-Results-Test von Google.

Lizenz zeigt einen Fehler

Der Schlüssel der KI-Brücke passt nicht, Shoplotse Google hat einen eigenen. Ein Schlüssel gilt für einen Shop. Nach einem Umzug schreib an info@shoplotse.net.

Changelog

Alle Versionen, neueste zuerst. Update immer über Plugin-Manager → Hochladen → „Aktualisieren“, nicht deinstallieren, sonst sind die Einstellungen weg.

1.2.0

19.10.2026

Neu

  • Lizenzschlüssel wie bei der KI-Brücke: Im Reiter Einrichtung steht als erster Schritt das Feld für den Schlüssel aus der Kauf-E-Mail (beginnt mit SL-). Ohne gültige Lizenz gibt das Plugin nichts im Shop aus und sendet nichts an Google. Eine Lizenz gilt für einen Shop. Beim Aktivieren schickt der Shop einmal Schlüssel, Produkt, Shop-Adresse und Plugin-Version an shoplotse.net; danach wird nur alle 30 Tage nachgefragt, und ist shoplotse.net nicht erreichbar, bleibt die Lizenz gültig.
  • Wichtig beim Update: Danach im Reiter Einrichtung den Lizenzschlüssel eintragen, sonst pausiert die Messung.

1.1.1

19.10.2026

Korrekturen nach einer unabhängigen Prüfung gegen den Quellcode von JTL-Shop 5.8.1.

Verbessert

  • Zahlungsarten, die vor dem Bestellabschluss bezahlt werden (z. B. manche PayPal- und Mollie-Einstellungen): Die vorläufige Bestellung zählt nicht mehr als Kauf. Vorher konnte ein Kauf doppelt in Google stehen, einmal mit einer Ersatz-Bestellnummer. Auch „Jetzt bezahlen“ für eine alte Bestellung meldet keinen zweiten Kauf.
  • Kauf über den Server nur noch, wenn der Kunde im Cookie-Banner zugestimmt hat, nicht schon wenn ein altes Google-Cookie da ist.
  • Shops mit mehreren Währungen: Preise und Umsatz werden in die Währung des Kunden umgerechnet.
  • Enhanced Conversions: Telefonnummern wie „+49 (0) 171 …“ werden richtig umgewandelt; die Anschrift geht nur vollständig mit.
  • Zieht ein Besucher die Zustimmung auf derselben Seite zurück, bekommt Google das sofort mit.
  • Suche zählt beim Blättern und Sortieren nicht mehrfach.
  • GTIN mit falscher Prüfziffer wird nicht ausgegeben (Google lehnt sie ab).
  • Robuster bei kaputten Zeichen in Artikelnamen und ungewöhnlichen Cookies.

1.1.0

19.10.2026

Alles, was die bekannten Google-Plugins für JTL-Shop können, jetzt auch hier.

Neu

  • Google Tag Manager: Container-ID eintragen, der Container lädt nach Zustimmung im Cookie-Banner. Alle Ereignisse liegen im GA4-Format im dataLayer. Geht auch ganz ohne GA4 Mess-ID.
  • Enhanced Conversions für Google Ads: E-Mail, Telefon, Name und Straße gehen beim Kauf mit SHA-256 verschlüsselt an Google, nur nach Zustimmung. Standardmäßig aus.
  • Kauf über den Server (GA4 Measurement Protocol): Mit einem API-Secret meldet der Shop-Server den Kauf selbst. Werbeblocker und abgebrochene Weiterleitungen nach der Zahlung verschlucken ihn nicht mehr.
  • Dynamisches Remarketing: Artikel tragen für Google Ads die Artikelnummer als id und die Branche „retail“.
  • Neue Ereignisse: Kategorieseiten (view_item_list), Suche (search), aus dem Warenkorb entfernt (remove_from_cart), Versand- und Zahlungsart in der Kasse (add_shipping_info, add_payment_info).
  • Produktdaten: GTIN (EAN) und Herstellernummer aus der Wawi, Sterne aus den Kundenbewertungen. Nur was das Template nicht schon selbst ausgibt.
  • Einrichtungsassistent: neuer Schritt 11 „Mehr messen“ für Tag Manager, Enhanced Conversions und Kauf über den Server, mit Warnung bei doppelter Messung durch GA4 und Tag Manager.

1.0.0

19.10.2026

Erste fertige Version.

Neu

  • Lizenzbedingungen (LICENSE.md): Der Plugin-Manager zeigt sie vor der Installation an.
  • Anleitung „Fehlermeldung beim Hochladen“ in der Doku: was hinter einem „SyntaxError“ steckt und wie man prüft, ob das Plugin trotzdem angekommen ist.

Verbessert

  • Getestet mit PHP 8.3 und PHP 8.4.

0.2.0

17.10.2026

Neu

  • Reiter Berichte: die wichtigsten Zahlen aus Google direkt im Shop-Backend, letzte 28 Tage im Vergleich zu den 28 Tagen davor.
    • Google Analytics: Besucher, Besuche, Bestellungen, Umsatz, Kaufrate, woher die Besucher kommen, Artikel (angesehen, in den Warenkorb, gekauft) und Einstiegsseiten.
    • Search Console: Klicks, Einblendungen, Klickrate und Position in der Google-Suche, die wichtigsten Suchbegriffe und Seiten.
    • Chancen: Suchbegriffe, bei denen der Shop oft gezeigt, aber knapp hinter den ersten Treffern selten angeklickt wird.
    • Zugang über ein eigenes Google-Dienstkonto mit reinen Leserechten. Die Search-Console-Property wird automatisch gefunden.
    • Fehlt eine Berechtigung oder ist eine Google-Schnittstelle nicht eingeschaltet, sagt der Reiter genau, wo man klickt.
  • Einrichtungsassistent: neuer Schritt 10 „Berichte im Backend“ mit Klick-Anleitung für Google Cloud, Analytics und Search Console.

0.1.2

16.10.2026

Verbessert

  • Herstellerseite auf shoplotse.net gesetzt.

0.1.1

16.10.2026

Verbessert

  • Herstellerseite auf shoplotse.shop gesetzt.

0.1.0

16.10.2026

Erste Verkaufsversion.

Neu

  • Google Analytics 4 mit Consent Mode v2: Ohne Zustimmung im JTL Consent-Manager wird nichts an Google gesendet.
  • E-Commerce-Messung: Artikelansicht, in den Warenkorb, Warenkorb, Kasse, Kauf mit Umsatz, Versand und Bestellnummer.
  • Google-Ads-Conversion „Kauf“ mit Bestellwert. ID und Label können zusammen aus dem Google-Snippet eingefügt werden.
  • Produkt-Strukturdaten: Marke, Versandkosten je Land mit „frei ab“, Lieferzeit und Rückgaberichtlinie (NOVA und NOVA-Child-Templates).
  • Bestätigung der Google Search Console per HTML-Tag.
  • Reiter Einrichtung mit 9 Prüfschritten und Klick-Anleitungen: Mess-ID, Cookie-Banner, doppelte Messung, Datenschutzerklärung, Test, Produktdaten, Google Ads, Search Console, Google-Shopping-Feed.
  • Prüfung des Google-Shopping-Exportformats auf typische Fehler (Platzhalter bei Zustand und Produktkategorie, fehlende Marke).
  • Cookie-Banner-Text auf Deutsch und Englisch.