PS PrestaShop Mittel

DataFirefly Google Shopping — Vollständige Anleitung

Installation, Feeds pro Land / Sprache / Währung, Google-Kategorien, Regeln, Überschreibungen, Probleme, optionale Merchant API und KI-Vorschläge, Cron und Fehlerbehebung des Google Shopping-Moduls für PrestaShop 1.7.8, 8 und 9.

Aktualisiert Modulversion 2.0.0

Überblick

DataFirefly Google Shopping generiert Ihre Google Merchant Center-Feeds aus PrestaShop: Produkte, lokales Inventar und Aktionen, ein Feed pro Shop, Land, Sprache und Währung. Das Modul prüft jeden Artikel anhand der Google-Produktdatenspezifikation, zeigt, was es gefunden hat, und ermöglicht Ihnen, dies mit Kategorien, Regeln und Überschreibungen zu korrigieren, bevor Google den Feed liest. Die Merchant API und die KI-Vorschläge sind optional.

Das Modul fügt unter Verbessern ein Menü Google Shopping mit 10 Seiten hinzu: Übersicht, Feeds, Google-Kategorien, Regeln, Produkte, Probleme, KI-Vorschläge, Analysen, Import / Export und Einstellungen. Es erstellt 18 Tabellen mit dem Präfix dfgs_, überschreibt keine PrestaShop-Klasse und ändert keine Core-Datei.

Das Modul folgt der Google-Spezifikation, aber allein Google entscheidet über die Freigabe und die Anzeige Ihrer Produkte. Der Qualitätsindikator des Dashboards ist eine interne Vollständigkeitsprüfung, keine Google-Bewertung.

Voraussetzungen

  • PrestaShop 1.7.8, 8.x oder 9.x.
  • PHP 7.4 bis 8.5 mit den Erweiterungen xmlwriter und zlib (openssl und curl für die Merchant API und die KI).
  • Ein Google Merchant Center-Konto.

Installation

  1. Öffnen Sie im Back Office Module → Modulmanager und klicken Sie auf Modul hochladen.
  2. Wählen Sie dfexportgoogleshopping-2.0.0.zip aus. PrestaShop installiert das Modul.
  3. Öffnen Sie Verbessern → Google Shopping. Der Einrichtungsassistent startet beim ersten Aufruf.

Upgrade von Version 1.x

Laden Sie das 2.0.0-Zip über das installierte Modul hoch (gleiches Vorgehen wie bei der Installation). Das Upgrade:

  • behält Ihre Feeds, ihre öffentliche URL, ihr Token und die Artikel-IDs von Version 1.x, sodass Merchant Center Ihre Produkte behält;
  • übernimmt Kategoriezuordnungen, Produktüberschreibungen und Einstellungen;
  • verschlüsselt die von Version 1.x gespeicherten API-Schlüssel;
  • lässt die Merchant API-Synchronisierung deaktiviert, bis Sie sie konfigurieren (die von 1.x verwendete Content API for Shopping wurde von Google eingestellt);
  • entfernt die alten Dateien von 1.x, einschließlich des Ordners feeds/.

Version 2.0.0 erzeugt nur Google-Feeds. Wenn ein 1.x-Feed für Bing, Meta, Kelkoo, Idealo oder LeGuide eingestellt war, liefert seine URL jetzt das Google-Format: Prüfen Sie ihn, bevor Sie ihn in diesem Kanal behalten.

Öffnen Sie nach dem Upgrade das Übersicht: Die Feeds werden beim ersten Cron-Lauf oder beim Klick auf Generieren neu generiert.

Einrichtungsassistent

Vier Schritte: Länder, Sprache und Währung, Versand, dann die Google-Kategorien Ihrer Hauptkategorien. Der Assistent erstellt einen Feed pro ausgewähltem Land. Alles lässt sich später unter Feeds und Google-Kategorien ändern.

Feeds

Unter Feeds zeigt jede Karte das Land, die Sprache, die Währung, die gesendeten und ausgeschlossenen Artikel, den Qualitätsindikator und die Feed-URL (maskiert; URL kopieren kopiert sie). Aktionen: Generieren, Vorschau, Verlauf, Einstellungen, Deaktivieren, Duplizieren.

Die Feed-Einstellungen haben fünf Tabs:

  • Ziel: Feed-Typ (Produkte, lokales Inventar, Aktionen), Name, Shop, Zielland, Sprache, Währung, Preise (automatisch: ohne Steuern für die Vereinigten Staaten und Kanada, mit MwSt. in allen anderen Ländern), Format der Artikel-ID, Ziele und ausgeschlossene Ziele. Behalten Sie das Format der Artikel-ID eines bestehenden Feeds bei: Eine Änderung führt dazu, dass Merchant Center neue Produkte sieht.
  • Produkte: nur bestimmte oder alle außer bestimmten Kategorien und Marken, Mindest- und Höchstpreis, ausgeschlossene Produkt-IDs, nicht vorrätige Produkte.
  • Titel und Texte: Titelmuster mit den Tokens {name}, {brand}, {attributes}, {color}, {size}, {material}, {category}, {reference}, {feature:Name} und einer Live-Vorschau mit den Produkten des Feeds; Kombinationswerte im Titel; Entfernen von Werbewörtern und hervorhebenden Großbuchstaben; Quelle der Beschreibung, Highlights aus den Aufzählungslisten der Beschreibung, Produktdetails aus den Eigenschaften, Marke für Produkte ohne eigene Marke.
  • Versand: keiner, ein Pauschalpreis mit Schwelle für kostenlosen Versand oder ein PrestaShop-Versanddienst; optionaler Dienstname und Lieferzeiten.
  • Erweitert: gesendete Bildgröße, an die Links angehängte Tracking-Parameter und Öffentliche URL ändern.

Den Feed in Merchant Center anmelden

  1. Klicken Sie auf der Feed-Karte auf URL kopieren.
  2. Fügen Sie in Merchant Center eine Produktquelle aus einer Datei mit geplantem Abruf hinzu und fügen Sie die URL ein.
  3. Wählen Sie dasselbe Land und dieselbe Sprache wie für den Feed.

Die URL enthält ein Token mit 40 Zeichen. Falls es offengelegt wurde, verwenden Sie Öffentliche URL ändern im Tab Erweitert: Die alte URL funktioniert sofort nicht mehr und muss in Merchant Center ersetzt werden. Die Feed-Dateien werden in var/dfgs_feeds/ unter einem nicht erratbaren Namen gespeichert und nur über diese URL ausgeliefert, unter Apache wie unter nginx.

Artikelvorschau

Vorschau berechnet bei einem Feed für das von Ihnen gewählte Produkt, was dieser Feed jetzt senden würde: eine Karte im Shopping-Stil, den Preis und den Sonderpreis, die gefundenen Probleme und jedes Attribut. Verwenden Sie sie, um ein Produkt vor oder nach einer Änderung zu prüfen.

Generierung, Verlauf und Cron

Die Generierung läuft in Stapeln. Wird sie unterbrochen, setzt der nächste Lauf dort fort, wo sie aufgehört hat; eine Sperre verhindert zwei gleichzeitige Läufe desselben Feeds. Am Ende prüft das Modul, ob das XML wohlgeformt ist, schreibt eine gzip-Kopie und vergleicht die Artikel mit der vorherigen Generierung.

Verlauf listet die letzten 30 Generierungen (Auslöser, gesendete und ausgeschlossene Artikel, Indikator, Unterschiede, Dauer, Speicher, Größe, XML-Prüfung) und die Unterschiede eines Artikels Feld für Feld.

Um die Feeds automatisch neu zu generieren, rufen Sie die unter Einstellungen angezeigte Cron-URL auf (zum Beispiel stündlich); Jeden Feed neu generieren, höchstens alle legt fest, wie oft ein Feed fällig ist (1 bis 24 Stunden). Jeder Aufruf generiert die fälligen Feeds innerhalb von etwa 25 Sekunden und setzt bei Bedarf beim nächsten Aufruf fort; wenn die Merchant API aktiviert ist, sendet er außerdem die Produktänderungen aus der Warteschlange.

0 * * * * curl -s "https://www.example.com/index.php?fc=module&module=dfexportgoogleshopping&controller=cron&token=YOUR_CRON_TOKEN" > /dev/null

Google-Kategorien

Die Google-Produkttaxonomie (Version 2021-09-21) ist in 8 Sprachen enthalten: Die Suche läuft lokal, ohne Aufruf bei Google. Geben Sie für jede Shop-Kategorie einige Wörter ein und wählen Sie die Google-Kategorie. Eine Unterkategorie übernimmt die Auswahl ihrer übergeordneten Kategorie, bis Sie eine eigene festlegen. Legen Sie für Bekleidung das Geschlecht und die Altersgruppe fest: Sie sind in mehreren Ländern erforderlich.

Regeln

Eine Regel hat Bedingungen (Kategorie, Marke, Preis, Menge, Titel, Artikelnummer, Zustand, GTIN vorhanden, Google-Kategorie vorhanden, im Angebot, Verfügbarkeit) und eine Aktion: den Artikel ausschließen, ein benutzerdefiniertes Label 0 bis 4 festlegen, dem Titel ein Präfix oder Suffix hinzufügen, Wörter ersetzen oder entfernen. Regeln werden bei jeder Generierung von oben nach unten angewendet, für alle Feeds oder einen Feed. Vorschau zeigt die betroffenen Artikel vor und nach der Regel.

Produkte und Überschreibungen

Produkte listet Ihre Produkte mit dem gesendeten Titel, GTIN, Marke, MPN, Zustand, Google-Kategorie und Status. Doppelklicken Sie auf eine Zelle, um sie zu bearbeiten; wählen Sie Produkte aus, um eine Aktion als Massenbearbeitung anzuwenden (von Google ausschließen, einschließen, Zustand, Geschlecht, Altersgruppe, Marke, Google-Kategorie, benutzerdefiniertes Label, Überschreibungen entfernen).

Details öffnet die Überschreibungen eines Produkts, für das gesamte Produkt oder eine Kombination, und für jede Sprache: Titel, Beschreibung, Highlights, Farbe, Größe, Material, Produkttyp, GTIN, MPN, Marke, Google-Kategorie, benutzerdefinierte Labels. Rechts zeigt die Vorschau, was Google erhalten wird. Überschreibungen ändern nur den Feed, niemals Ihren Katalog. Eine GTIN wird abgelehnt, wenn ihre Länge, ihre Prüfziffer oder ihr Präfix ungültig ist.

Probleme

Probleme listet, was das Modul bei der letzten Generierung erkannt hat, nach Typ (ausgeschlossen, Warnung, Information), mit dem, was zu tun ist, und den betroffenen Artikeln. Die GTIN-Prüfung prüft jede GTIN des Katalogs. Wenn die Merchant API aktiviert ist, erscheinen die von Google gemeldeten Probleme in einem eigenen Abschnitt.

Merchant API (optional)

  1. Erstellen Sie in Google Cloud ein Projekt, aktivieren Sie die Merchant API und erstellen Sie ein Dienstkonto mit einem JSON-Schlüssel.
  2. Fügen Sie in Merchant Center die E-Mail-Adresse des Dienstkontos als Nutzer hinzu.
  3. Geben Sie unter Einstellungen → Merchant API Ihre Merchant Center-Konto-ID und den JSON-Schlüssel ein (verschlüsselt gespeichert, nie wieder angezeigt) und klicken Sie dann auf Verbindung testen, Projekt registrieren (einmalig) und API-Datenquelle erstellen.
  4. Aktivieren Sie Produktänderungen über die Merchant API senden (mit dem Cron).

Das Speichern eines Produkts fügt es nur einer Warteschlange hinzu; der Cron sendet die Warteschlange und ruft die Artikelstatus ab. Bei Kontingentfehlern wird später mit zunehmender Verzögerung ein neuer Versuch unternommen.

KI-Vorschläge (optional)

Wählen Sie unter Einstellungen → KI den Anbieter (Anthropic, OpenAI oder Mistral) und geben Sie Ihren API-Schlüssel (verschlüsselt gespeichert), das Modell und eine monatliche Obergrenze ein. Wählen Sie unter KI-Vorschläge Titel, Google-Kategorien oder Attribute, die Produkte und die Sprache: Die Kosten werden vor dem Lauf geschätzt.

Jeder Vorschlag landet unter Wartet auf Bestätigung, mit dem aktuellen Wert und dem vorgeschlagenen Wert, den Sie bearbeiten können, bevor Sie auf Anwenden klicken. Ohne Ihren Klick wird nichts angewendet. KI-Titel werden, wie von Google verlangt, als KI-generierte Inhalte gesendet. Die KI wird nie nach einer GTIN gefragt.

Analysen

  • Titeltests: Zwei Titel wechseln sich für ein Produkt zeitraumweise ab. Geben Sie die Impressionen und Klicks aus Ihren Merchant Center- oder Google Ads-Berichten ein. Ein Ergebnis gilt nur dann als signifikant, wenn mindestens 1.000 Impressionen pro Titel, insgesamt 30 Klicks und p < 0,05 vorliegen; selbst dann können andere Faktoren (Saison, Wettbewerb, Gebote) den Unterschied erklären.
  • Suchanfragen: Importieren Sie die CSV-Datei Ihrer Search Console-Suchanfragen; das Modul ordnet jede Suchanfrage einem Produkt zu und zeigt die Suchanfragen, deren Wörter im Titel fehlen.
  • Saisonalität: Produkte, deren bisherige Verkäufe sich auf die nächsten zwei Monate konzentrieren und die Sie mit einem benutzerdefinierten Label kennzeichnen können.
  • Bildprüfung: Produktbilder, die zu klein (unter 100 oder 500 Pixel an der kurzen Seite), zu langgestreckt oder größer als 16 MB sind.

Benachrichtigungen

Geben Sie unter Einstellungen → Benachrichtigungen eine E-Mail-Adresse und/oder einen Slack-Webhook ein und wählen Sie die Ereignisse: Generierung fehlgeschlagen, Rückgang des Qualitätsindikators, neue von Google gemeldete Probleme.

Import / Export

Exportieren und importieren Sie die Überschreibungen als CSV (Semikolon, UTF-8). Zellen, die mit =, +, - oder @ beginnen, werden beim Export neutralisiert. Diese Seite enthält außerdem die Geschäftsliste des Feeds für lokales Inventar und die Aktionen des Aktionsfeeds.

Strukturierte Daten (JSON-LD)

Standardmäßig deaktiviert. Unter Einstellungen fügt Strukturierte Daten auf Produktseiten im automatischen Modus der Produktseite nur dann einen Product-Block hinzu, wenn die Seite keinen hat (Theme, SEO- oder Bewertungsmodul), mit dem auf der Seite angezeigten Preis. Wenn Ihr Theme bereits einen ausgibt, lassen Sie die Option deaktiviert.

Weitere DataFirefly-Module

Wenn sie installiert sind, berücksichtigt der Feed: das Geschenkverpackungsprodukt (nie gesendet), durch eine Auktion blockierte Produkte, abgelaufene Mindesthaltbarkeitslose, den Zustand „generalüberholt“ und die Zustandsklasse, den Grundpreis und die Produktgruppen der Produktverknüpfung (item_group_id).

Multistore und Berechtigungen

Jeder Feed gehört zu einem Shop und sieht nur dessen Produkte und Überschreibungen; in einem Shop-Kontext lassen sich die Feeds anderer Shops nicht öffnen. Schreibaktionen erfordern die Bearbeitungsberechtigung für die Seite: Ein Mitarbeiter, der nur die Ansichtsberechtigung hat, kann sich alles ansehen, aber nichts ändern.

Fehlerbehebung

  • Der Feed ist leer: Prüfen Sie die Kategorien und Filter des Feeds und ob die Produkte im Shop des Feeds aktiviert, sichtbar und bestellbar sind. Die Seite Probleme nennt den Grund jedes Ausschlusses.
  • Die URL liefert 404: Der Feed ist deaktiviert, das Token wurde erneuert oder das Modul ist deaktiviert.
  • Die Preise weichen vom Shop ab: Prüfen Sie Land und Währung des Feeds sowie die Steueroption unter Erweitert; Google erwartet für die Vereinigten Staaten und Kanada Preise ohne Steuern.
  • Merchant API: Authentifizierungsfehler: Prüfen Sie, ob das Dienstkonto ein Nutzer des Merchant Center-Kontos ist und ob das Projekt registriert ist.
  • KI: Nichts passiert: Prüfen Sie den Schlüssel, das Modell und die monatliche Obergrenze unter Einstellungen → KI; das Protokoll zeigt die Ursache jedes fehlgeschlagenen Aufrufs.

Deinstallation

Die Deinstallation entfernt die 18 dfgs_-Tabellen, die DFGS_-Einstellungen, die Admin-Seiten und die generierten Feed-Dateien. Exportieren Sie vorher Ihre Überschreibungen, wenn Sie sie behalten möchten.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren