Dokumentation · Version 2.3.2

Produkt Feed Manager

Von der Installation bis zum laufenden Betrieb — alles, was Sie für den Produkt Feed Manager in JTL-Shop 5 wissen müssen.

Voraussetzungen

  • JTL-Shop: Version 5.6.0 oder höher
  • PHP: 7.4 oder höher (getestet bis 8.3)
  • Datenbank: MySQL 5.7+ / MariaDB 10.3+
  • Server: ausgehende HTTPS-Verbindungen für Lizenzprüfung, KI-Anbieter und Plattform-APIs; Schreibrechte auf dem export/-Verzeichnis des Shops (Feed-Cache)
  • Für KI-Funktionen: ein eigener API-Schlüssel von Anthropic (Claude) oder OpenAI — die KI-Funktionen sind optional, alle übrigen Funktionen laufen ohne

Installation

Über den JTL Extension Store (empfohlen)

  1. Plugin im JTL Extension Store erwerben und die Lizenz im JTL-Kundencenter an Ihre Shop-URL binden.
  2. Im Shop-Backend Plugins → Plugin-Manager öffnen — das Plugin erscheint unter Ihren Käufen.
  3. Installieren klicken. Die Vollversion ist über die Store-Lizenz automatisch freigeschaltet, ein Lizenzschlüssel ist nicht nötig.

Manuell per ZIP

  1. Plugin-Manager → Tab „Hochladen": ZIP-Datei auswählen und hochladen.
  2. Im Tab „Vorhanden" auf Installieren klicken.
  3. Direktkunden tragen anschließend im Plugin-Tab Lizenz ihren Lizenzschlüssel ein.
Hinweis: Ohne Lizenz startet automatisch die 14-tägige Testphase mit vollem Funktionsumfang (max. 50 Produkte je Feed, 3 Feeds). Es sind weder Zahlungsdaten noch eine Registrierung erforderlich.

Der 9-Schritt-Wizard

Der Wizard führt vom leeren Feed zum fertigen, abrufbaren Ergebnis. Jeder Schritt speichert seinen Zustand — Sie können jederzeit unterbrechen und später fortsetzen.

  1. Plattform & Kanal: Zielplattform wählen (Google Merchant Center, Google Shopping, Performance Max, Remarketing, DSA, idealo, Meta, Pinterest, TikTok, billiger.de, guenstiger.de). Die weiteren Schritte passen sich an. Der Feed-Name darf Umlaute enthalten — für die URL wird er automatisch umgewandelt („Grüne Dusche" → gruene-dusche).
  2. Kategorien: JTL-Kategorien im Baum auswählen; die Produktliste füllt sich automatisch.
  3. Produkte: Einzelprodukte an-/abwählen, Varianten prüfen.
  4. Regeln & Mapping: Transformationsregeln aktivieren, Google-Taxonomie zuordnen, Feld-Mapping anpassen.
  5. Felder & KI / Titel: KI-Titel generieren — für alle Produkte auf einmal oder einzeln, mit Vorher/Nachher-Vergleich.
  6. Beschreibungen: KI-Beschreibungen im Original/KI-Vergleich; Übernahme per Checkbox je Produkt.
  7. Labels: Custom Labels 0–4 setzen — manuell oder automatisch aus Lagerbestand und Preisregeln.
  8. Abschluss: Feed-Name bestätigen, Format wählen, Feed erzeugen.
  9. Fertig: Feed-URL kopieren und bei der Zielplattform hinterlegen.

Feed-URLs & Token-Schutz

Jeder Feed ist unter einer sauberen URL im Shop-Root erreichbar:

https://ihr-shop.de/google-feed-feedname.xml
https://ihr-shop.de/google-feed-feedname.json
https://ihr-shop.de/google-feed-feedname.csv

Optional lässt sich in den Grundeinstellungen ein Feed-Token setzen. Dann sind Feeds nur mit angehängtem Token abrufbar:

https://ihr-shop.de/google-feed-feedname.xml?token=IhrToken

Mit ?fresh=1 wird der Feed unter Umgehung des Caches live neu generiert — nützlich zum Testen nach Änderungen. Die Antwort-Header X-Feed-Cache und X-Feed-Products zeigen Cache-Status und Produktanzahl.

Cron einrichten

Ein Server-Cronjob hält Feeds und idealo-Preise auch dann aktuell, wenn niemand im Admin arbeitet. Die fertige Cron-URL inklusive automatisch generiertem Sicherheitsschlüssel finden Sie im Plugin unter idealo → Server-Cronjob — einfach anklicken zum Kopieren:

https://ihr-shop.de/?pfm_cron=1&key=IhrCronKey

Empfohlener Rhythmus: alle 15 Minuten. In Plesk: Geplante Aufgaben → Aufgabe hinzufügen → URL abrufen. Alternativ per Crontab:

# Alle 15 Minuten — Feeds & idealo-Wartung
*/15 * * * * curl -s "https://ihr-shop.de/?pfm_cron=1&key=IhrCronKey" > /dev/null
Fallback: Auch ohne Server-Cron stößt Aktivität im Plugin-Admin die anstehende Wartung an. Für zuverlässige, zeitgesteuerte Updates ist der Server-Cron aber der empfohlene Weg.

idealo-Preisupdates

Neben dem klassischen Feed bindet der Produkt Feed Manager die idealo-Direktkauf-API an: Preise und Lieferzeiten Ihrer Auswahl-Produkte werden automatisch per PATCH aktualisiert.

  1. Im Tab idealo die API-Zugangsdaten (Client-ID/Secret) hinterlegen.
  2. Das Intervall für „Automatische Preis-Updates (PATCH)" wählen: alle 6, 12 oder 24 Stunden. Bei häufigen Preisänderungen empfehlen wir 6 Stunden — idealo wertet Preisabweichungen zwischen Feed und Shop ab.
  3. Den Server-Cronjob einrichten (siehe oben).

Jeder Lauf erscheint im Aktivitäts-Log („idealo Auto-PATCH"). Die Preise werden zum Zeitpunkt der Übertragung frisch aus der JTL-Datenbank gelesen — es gehen immer die aktuellen Werte raus.

KI konfigurieren

Unter KI-Einstellungen hinterlegen Sie Ihren API-Schlüssel und wählen den Anbieter:

  • Claude (Anthropic): empfohlen für deutschsprachige, natürlich klingende Produkttexte
  • OpenAI (GPT-4o-mini): kostengünstige Alternative

Der Titel-Stil ist wählbar (z. B. Marke-First für SERP-Optimierung oder Material-First für Long-Tail). API-Schlüssel werden AES-256-verschlüsselt in der Plugin-Konfiguration gespeichert. Abgerechnet wird direkt beim KI-Anbieter über Ihren eigenen Schlüssel — das Plugin erhebt keine Zusatzkosten pro Text.

Datenumfang: An den KI-Anbieter gehen ausschließlich Produktdaten der Artikel, die Sie aktiv anreichern (Name, Beschreibung, Attribute, Kategorie). Kundendaten verlassen den Shop zu keinem Zeitpunkt.

PMax-Asset-Texte

Bei Feeds vom Typ Performance Max erzeugt die KI-Anreicherung neben der Beschreibung komplette Asset-Gruppen-Texte je Produkt:

  • 5 Headlines (max. 30 Zeichen)
  • 2 Descriptions (max. 90 Zeichen)
  • 2 Display-Paths (max. 15 Zeichen)

Sobald Assets vorliegen, erscheint im Tab Feeds die Karte „Performance-Max-Asset-Texte" mit CSV-Export (Excel-kompatibel). Die Texte lassen sich direkt in Google-Ads-Asset-Gruppen übernehmen — die Zeichenlimits sind bereits eingehalten.

DSA-Page-Feed

Dynamic Search Ads verwenden keinen Produktfeed, sondern einen Page-Feed. Ein Feed vom Typ DSA liefert deshalb beim CSV-Abruf automatisch das korrekte Google-Ads-Format:

"Page URL","Custom label"
"https://ihr-shop.de/produkt-a","Sommer; STOCK_HIGH"
"https://ihr-shop.de/produkt-b","Sale"

Produkt-URLs werden dedupliziert (Varianten teilen sich die Eltern-URL), gesetzte Custom Labels werden semikolon-getrennt übernommen. Den Feed in Google Ads unter Tools → Unternehmensdaten → Seitenfeed hinterlegen.

Health-Score & Changelog

Health-Score: Jedes Produkt wird nach Google-Regeln mit 0–100 Punkten bewertet (fehlende GTIN, zu kurze Titel, fehlende Bilder usw.), je Feed aggregiert und farbcodiert angezeigt. Das Review-Tool sammelt Problemfälle und bietet Einzel- oder Sammel-Verbesserung per KI.

Feed-Changelog: Jeder Feed-Lauf wird mit dem vorherigen Snapshot verglichen — neue Produkte, entfernte Produkte und Preisänderungen sind je Lauf nachvollziehbar.

Lizenzierung & Testphase

  • Testphase: 14 Tage ab Installation, voller Funktionsumfang, max. 50 Produkte je Feed und 3 Feeds. Nach Ablauf pausiert die Feed-Ausgabe — alle Feeds und Einstellungen bleiben erhalten und sind mit Lizenz sofort wieder aktiv.
  • JTL Extension Store: Die Store-Lizenz wird automatisch erkannt; Verwaltung, Verlängerung und Shop-Bindung laufen über das JTL-Kundencenter.
  • Direktlizenz: Lizenzschlüssel im Tab Lizenz eintragen. Die Prüfung erfolgt im 24-Stunden-Rhythmus mit 7 Tagen Offline-Toleranz.
  • Fair-Play-Prinzip: Eine einmal lizenzierte Installation wird nie nachträglich blockiert. Läuft eine Subscription aus, entfällt nur der Bezug neuer Updates.

Updates

Updates werden über den JTL-Plugin-Manager installiert (Plugins → Plugin-Manager → Verfügbare Updates). Konfiguration, Feeds und alle Plugin-Daten bleiben beim Update erhalten. Der Tab Updates im Plugin zeigt die installierte Version und prüft auf Wunsch, ob eine neue Version vorliegt — dabei wird nur die Versionsnummer abgefragt, es werden keine Daten übertragen.

Deinstallation & Daten

Bei der Deinstallation über den Plugin-Manager werden alle Plugin-Tabellen (Präfix gmf_) vollständig entfernt. Der Feed-Cache unter export/pfm_cache/ kann anschließend manuell gelöscht werden. Das Plugin nimmt keine Änderungen an JTL-Kerntabellen vor — Ihr Artikelbestand bleibt unberührt.

Achtung: Mit der Deinstallation gehen Feed-Definitionen, KI-Texte und Einstellungen unwiderruflich verloren. Für einen Serverumzug genügt es, das Plugin auf dem neuen System zu installieren — die gmf_-Tabellen können per Datenbank-Export mitgenommen werden.

Drittanbieter & Datenschutz

Der Produkt Feed Manager kommuniziert — je nach aktivierten Funktionen — mit folgenden externen Diensten:

  • Anthropic / OpenAI: nur bei hinterlegtem API-Schlüssel und aktiv angestoßener Anreicherung; übertragen werden ausschließlich Produktdaten der gewählten Artikel.
  • Google (Merchant Center, Taxonomie): beim GMC-Push per OAuth2 und beim Abruf der Google-Produkttaxonomie.
  • idealo: bei aktivierter Direktkauf-API für Preis- und Lieferzeit-Updates.
  • Lizenzserver (plugin-manager.de): Lizenzstatus-Prüfung im 24-Stunden-Rhythmus sowie optionale Versionsabfrage — ohne Übertragung von Shop- oder Kundendaten.

Kundendaten (Bestellungen, Adressen, Konten) werden zu keinem Zeitpunkt an externe Dienste übertragen. Das Admin-Interface lädt keine externen Ressourcen wie Web-Fonts oder CDN-Skripte.