# 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,… - Seite: - Sprache: de - Aktualisiert am: 2026-07-01 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfexportgoogleshopping/index.md), [en](https://www.datafirefly.com/en/documentation/dfexportgoogleshopping/index.md), [es](https://www.datafirefly.com/es/documentation/dfexportgoogleshopping/index.md), [it](https://www.datafirefly.com/it/documentation/dfexportgoogleshopping/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexportgoogleshopping/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexportgoogleshopping/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexportgoogleshopping/index.md) - Index: ## Ü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. Ein Feed pro Land/Sprache-Paar ist die richtige Granularität: ein DE-Feed für Deutschland, ein EN-Feed für Großbritannien, ein FR-Feed für Frankreich, jeweils mit eigener Währung. ## 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. Alle KI-Funktionen sind optional. Ohne API-Schlüssel bleibt das Modul ein vollständiger Google-Shopping-Exporteur. ## 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.