DataFirefly Google Shopping — Vollständige Anleitung

Überblick

DataFirefly Google Shopping ist ein Modul für PrestaShop 8 und 9, das Merchant-Center-Feeds konform mit der Google Shopping Spec 2025 erzeugt und automatisch für 6 Kanäle anpasst (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Es enthält 5 KI-Assistenten (Anthropic Claude, OpenAI GPT-4o oder Mistral AI zur Wahl), einen 0-100 Qualitäts-Score, einen AJAX-Massenbearbeiter, KI-Vision-Bildaudit und Premium-Tools (Titel-A/B-Tests, saisonaler Forecaster, Google Ads Editor Export).

Das Modul erstellt 12 Tabellen mit dem Präfix dfgs_ und 9 Back-Office-Tabs unter dem Menü „Google Shopping“. Keine Core-Überschreibung, keine modifizierte PrestaShop-Datei.

Installation

1. Im PrestaShop-Back-Office: Module → Modul-Manager → Modul hochladen.
2. Laden Sie die Datei dfexportgoogleshopping.zip hoch.
3. Klicken Sie auf Installieren. Das Modul erstellt seine Tabellen, Admin-Tabs und Standard-Konfigurationswerte.

Voraussetzungen: PrestaShop 8.0 bis 9.x, PHP 8.1+, MySQL 5.7+ oder MariaDB 10.3+, cURL-Erweiterung aktiviert. Multistore und Mehrsprachigkeit werden nativ unterstützt.

Ihren ersten Feed erstellen

1. Gehen Sie zu Google Shopping → Feeds und klicken Sie auf Feed hinzufügen.
2. Geben Sie Name, Feed-Typ (Produkte, Local Inventory Ads oder Promotions), Shop, Sprache, Währung und Zielland an.
3. Wählen Sie den Zielkanal: Google Shopping (Standard), Bing, Meta Catalog, Kelkoo, Idealo oder LeGuide. Das XML-Format wird automatisch pro Kanal angepasst (Namespaces, Attribut-Renames, Längenlimits).
4. Konfigurieren Sie die Einschlussfilter: Kategorien, Hersteller, Ausschluss nicht vorrätiger Produkte.
5. Speichern und auf Generieren klicken. Die öffentliche Feed-URL (token-gesichert) erscheint in der Liste — diese hinterlegen Sie im Merchant Center.

Google-Kategorien-Mapping

Unter Google Shopping → Kategorien-Mapping ordnen Sie jede Shop-Kategorie einer Kategorie der Google-Taxonomie zu (rund 6.000 Einträge, 30 Tage gecacht). Zwei Methoden:

• Manuell: Autovervollständigungs-Suche in der Taxonomie.
• KI-Auto-Mapping: Der Button „Automatisch mappen“ sendet Ihre ungemappten Kategorien an den KI-Assistenten, der die beste Entsprechung vorschlägt. Vorschläge mit hoher Konfidenz werden angewendet; die übrigen warten auf Validierung.

Das Mapping vererbt sich auf ungemappte Unterkategorien. Das Attribut google_product_category und der product_type werden automatisch im Feed befüllt.

Produkt-Overrides

Der Tab Produkt-Overrides erlaubt, pro Produkt (und pro Sprache/Shop) jeden Feed-Wert zu erzwingen: Titel, Marke, GTIN, MPN, Zustand, Farbe, Größe, Material, Custom Labels 0-4, Google-Kategorie, Feed-Ausschluss usw. Overrides haben immer Vorrang vor den Katalogwerten.

Massenbearbeitung

Der Tab Massenbearbeitung zeigt ein AJAX-Grid mit 50 Produkten pro Seite und Suche nach Name, Referenz oder ID:

• Inline-Bearbeitung: Zelle anklicken, Wert eingeben, Enter — die Speicherung erfolgt sofort (grüner Hintergrund = Erfolg).
• Massenaktion: mehrere Produkte ankreuzen, Feld und Wert wählen, Anwenden klicken. Der Button „Overrides löschen“ entfernt die Overrides der ausgewählten Produkte.

CSV-Import / -Export und Vorschau

Der Tab Import / Export / Preview bündelt drei Werkzeuge:

• CSV-Export der Overrides oder Kategorie-Mappings (UTF-8 mit BOM, Semikolon-Trennzeichen, Excel-kompatibel).
• CSV-Import mit klarer Semantik: leere Zelle = keine Änderung, Sternchen (*) = Feld leeren.
• XML-Vorschau: Produkt-ID und Feed eingeben, das exakte XML dieses Produkts mit den erkannten Validierungsproblemen erhalten. Ideal, um ein abgelehntes Produkt zu debuggen.

KI-Assistenten

Konfigurieren Sie zuerst den Anbieter unter Google Shopping → Einstellungen: Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) oder Mistral AI, mit Ihrem API-Schlüssel und dem Modell. Empfohlene Modelle: claude-haiku-4-5-20251001 oder gpt-4o-mini (schnell, günstig); claude-sonnet-4-6 oder gpt-4o für maximale Qualität.

Der Tab KI-Assistenten steuert die 5 Assistenten:

• Kategorien-Mapping: ordnet Ihre Kategorien der Google-Taxonomie zu.
• Titel-Umschreibung: optimiert Titel nach der erkannten Branche (Apparel, Electronics, Books, Home, Beauty, Food) gemäß den von Google empfohlenen Mustern.
• Attributextraktion: leitet color, size, material, pattern, age_group, gender aus den Beschreibungen ab (Konfidenz ≥ 0.80).
• GTIN-Suche: ermittelt die GTIN aus Marke + MPN + Name, mit Modulo-10-Validierung (Konfidenz ≥ 0.85).
• Ablehnungs-Korrektur: analysiert jede Merchant-Center-Ablehnung und schlägt eine strukturierte Korrektur vor (oder wendet sie ab Konfidenz ≥ 0.85 automatisch an).

Jeder Aufruf wird in der Tabelle dfgs_ai_log protokolliert (Anbieter, Modell, Input-/Output-Tokens, Dauer): Sie verfolgen Ihr KI-Budget auf den Cent.

0-100 Qualitäts-Score

Bei jeder Generierung eines Produkt-Feeds sampelt das Modul 500 Items und berechnet 9 gewichtete Sub-Scores: GTIN-Abdeckung (15 Pkt.), Bild-Abdeckung (10), Bildqualität (10), Titelqualität (15), Beschreibungsqualität (10), Kategorien-Mapping (15), Highlight-Abdeckung (10), keine offenen kritischen Ablehnungen (10), Versandinfos vorhanden (5). Die Summe ergibt eine Note von A+ bis F im Dashboard, mit den 5 wirkungsstärksten Empfehlungen oben.

Slack- und E-Mail-Alerts

Hinterlegen Sie in den Einstellungen einen eingehenden Slack-Webhook und/oder eine E-Mail-Adresse. Drei Auslöser: neue kritische Ablehnungen während einer Generierung, Score-Abfall ≥ 10 Punkte gegenüber der vorherigen Generierung, Generierungsfehler. Anti-Spam: maximal 1 Alert pro Typ und 6 Stunden.

Premium-Funktionen

Der Tab Premium bündelt 5 Werkzeuge:

• Search-Console-Analyse: Laden Sie den CSV-Export der Suchanfragen hoch (Search Console → Suchergebnisse → Exportieren). Das Modul kreuzt jede Anfrage mit Ihren Produkttiteln und berechnet einen Opportunity-Score (Impressionen × im Titel fehlende Keywords × Positions-Multiplikator). Die Top 20 Chancen erscheinen mit dem vorgeschlagenen Produkt.
• Titel-A/B-Tests: Zwei Varianten wechseln sich in 7-Tage-Zyklen im Feed ab. Der Sieger wird erklärt, sobald jede Variante ≥ 500 Impressionen mit einer CTR-Differenz ≥ 5 % erreicht; er wird dann automatisch als Override angewendet.
• Saisonaler Forecaster: analysiert 24 Monate Bestellhistorie und taggt Produkte in custom_label_4 — upcoming_season (Saisonindex > 1.5 in den nächsten 2 Monaten), bestseller (Top 10 % des 30-Tage-Umsatzes), declining_trend (Rückgang ≥ 20 % über 6 Monate).
• Bildqualitäts-Audit: In Chargen von 25 erkennt die KI-Vision (Claude Vision oder GPT-4o — Mistral nicht unterstützt) Wasserzeichen, Werbetexte, Hintergrundtyp und mehrere Produkte. Score 0-10 pro Bild, 30-Tage-Cache.
• Google Ads Editor Export: direkt importierbares CSV mit nach Custom Labels hierarchisierten Anzeigengruppen und Gebotsmultiplikatoren pro Tag (bestseller ×1.5, upcoming_season ×1.3, on_sale ×1.2, declining_trend ×0.5).

Cron-Automatisierung

Jeder Feed stellt eine token-gesicherte Generierungs-URL bereit, sichtbar in der Feed-Liste. Crontab-Beispiel für eine Regenerierung alle 6 Stunden:

0 */6 * * * curl -s "https://ihrshop.com/module/dfexportgoogleshopping/cron?token=IHR_TOKEN&id_feed=1" > /dev/null

Die Generierung erfolgt im Streaming: Kataloge mit 100.000+ Produkten laufen ohne Speichersättigung durch.

Fehlerbehebung

• Der Feed ist leer: Prüfen Sie die Feed-Filter (Kategorien, Bestand) und dass die Produkte aktiv und im mit dem Feed verknüpften Shop sichtbar sind.
• Produkte bei der Generierung ausgeschlossen: Konsultieren Sie den Tab Diagnose — jeder Ausschluss ist begründet (ungültige GTIN, fehlendes Bild, Preis Null…). Nutzen Sie die XML-Vorschau für die Details eines bestimmten Produkts.
• KI-Aufruffehler: Prüfen Sie API-Schlüssel und Modell in den Einstellungen. Das Journal dfgs_ai_log zeichnet Fehlschläge mit ihrer Ursache auf.
• Das Bildaudit schlägt mit Mistral fehl: erwartet — Vision benötigt Anthropic oder OpenAI.
• Ein Tab verschwindet nach einem PrestaShop-Update: Setzen Sie das Modul zurück (Module → dfexportgoogleshopping → Zurücksetzen), um die Admin-Tabs neu zu erstellen, ohne Ihre Daten zu verlieren.

Deinstallation

Die Deinstallation entfernt die 12 dfgs_-Tabellen, die Admin-Tabs und die DFGS_-Konfigurationswerte. Exportieren Sie Ihre Overrides und Mappings vorher als CSV, wenn Sie sie behalten möchten.