PrestaShop Google Merchant Feed XML

PrestaShop-Dokumentation Google Merchant Feed

1. Einführung
2. Installation und Systemanforderungen
3. Aktivierung des Moduls
4. Grundlegende Konfiguration des Feeds
5. Erweiterte Konfiguration
6. Struktur des XML-Feeds
7. Produktfilter
8. Integration mit Google Merchant Center
9. Automatische Aktualisierung (CRON)
10. Sicherheit und Token
11. Anmeldung und Debugging
12. Bildgrößen
13. Lösung von Problemen
14. FAQ

1. Einleitung

• Automatische Generierung eines XML-Feeds für Google Merchant Center
• Unterstützung aller erforderlichen und optionalen Felder von Google Shopping
• Erweiterte Produktfilterung (Kategorien, Hersteller, Menge, Sonderangebote)
• Unterstützung mehrerer Sprachen und Währungen im Shop
• Zusätzliche Produktbilder (bis zu 10 pro Produkt)
• Automatische Aktualisierung des Feeds durch CRON
• Sicherer Zugriff mit Tokens
• Caching des Feeds zur Leistungsoptimierung
• Datenstandardisierung – Entfernen von HTML, Hervorhebungen und Leerzeichen
• Validierung von URLs und Datenformaten
• Kompatibel mit PrestaShop 1.7.x, 8.x und 9.x
• Vollständiges Übersetzungssystem (Polnisch, Englisch, Deutsch, Spanisch, Französisch)

2 Installation und Systemanforderungen

• PrestaShop 1.7.0.0 oder höher (getestet bis Version 9.0)
• PHP 7.4 oder höher
• Zugriff auf das PrestaShop-Admin-Panel
• Google Merchant Center-Konto (kostenlos)
• Möglichkeit, Dateien auf dem Server zu speichern
• Zugriff auf CRON (optional, für automatische Aktualisierung)

1. Laden Sie die ZIP-Datei des Moduls von der offiziellen Website herunter. cocos.codes
2. Loggen Sie sich in das PrestaShop-Administrationspanel ein
3. Gehen Sie zu: Module → Modul-Manager
4. Klicken Sie oben rechts auf „Modul hochladen”.
5. Wählen Sie die heruntergeladene ZIP-Datei aus und klicken Sie auf „Dieses Modul hochladen”.”
6. Wenn die Installation abgeschlossen ist, klicken Sie auf "Konfigurieren".
7. Das Modul ist bereit für die Konfiguration.

3. Aktivierung des Moduls

1. Gehen Sie zu Module → Modul-Manager
2. Finden Sie das Modul „CC Google Merchant Feed”
3. Klicken Sie auf „Konfigurieren”.”
4. Wählen Sie die Registerkarte „Konfiguration”
5. Füllen Sie die Grundeinstellungen des Feeds aus.
6. Klicken Sie auf „Speichern und XML-Feed generieren”.”

4. Grundlegende Konfiguration des Feeds

1. Wählen Sie in der Modulkonfiguration „Feed-Sprache” aus.”
2. Wählen Sie aus der Dropdown-Liste die Sprache für Produktnamen und -beschreibungen aus.
3. Klicken Sie auf „Speichern und XML-Feed generieren”.”

• Alle Produkte aus der ausgewählten Sprache werden aus dem Shop geladen.
• Der XML-Feed wird automatisch generiert und gespeichert.
• Die Datei ist unter der URL verfügbar, die im Reiter „Anweisungen” zu sehen ist.”
• Google Merchant Center kann den neuen Feed sofort herunterladen.

5. Erweiterte Konfiguration

1. Geben Sie den Namen der Marke/Firma ein, den Sie für Produkte ohne Hersteller verwenden möchten.
2. Wenn Sie das Feld leer lassen, wird der Name des Shops aus den PrestaShop-Einstellungen verwendet.
3. Die Marke ist für Produkte ohne GTIN erforderlich.

1. Geben Sie das Präfix für den MPN-Code ein (z. B. „MPN-” oder „SKU-„).
2. Das Präfix wird zur Produktreferenznummer hinzugefügt.
3. Wenn das Produkt eine Referenznummer hat, wird das Präfix darauf angewendet.
4. Wenn keine Referenz vorhanden ist, wird dem Produkt-ID ein Präfix hinzugefügt.

• Produktlimit – Standardwert 0 (ohne Begrenzung). Ändern Sie den Wert auf z. B. 1000, wenn der Feed zu groß ist.
• Maximale Anzahl zusätzlicher Bilder – Standardmäßig 10. Verringern Sie diesen Wert, um die Größe des Feeds zu reduzieren.

6. Struktur des XML-Feeds

 http://example.com
    Produkt-Feed für Google Merchant Center  123 Produktname Produktbeschreibung 

123 Blaues T-Shirt Größe L Hochwertiges Baumwoll-T-Shirt in Blau, Größe L
  http://example.com/produkt/niebieski-t-shirt http://example.com/images/tshirt-blue-large.jpg
  http://example.com/images/tshirt-blue-1.jpg 99,99 PLN 79,99 PLN
  auf Lager neu 5901234123457 Fashion Brand MPN-123

7. Produktfilter

1. Im Abschnitt „Kategorien” sehen Sie eine Liste aller Kategorien aus dem Shop.
2. Markieren Sie die Kontrollkästchen neben den Kategorien, die Sie exportieren möchten.
3. Um mehrere Kategorien auszuwählen, halten Sie die STRG-Taste (Cmd auf Mac) gedrückt und klicken Sie auf die Kategorien.
4. Lassen Sie das Feld unmarkiert, wenn Sie alle Kategorien exportieren möchten.

1. Im Abschnitt „Hersteller” finden Sie eine Liste aller Hersteller/Marken.
2. Markieren Sie die Kontrollkästchen neben den Herstellern, deren Produkte Sie exportieren möchten.
3. Um mehrere Hersteller auszuwählen, halten Sie die STRG-Taste (Cmd auf Mac) gedrückt und klicken Sie.
4. Lassen Sie das Feld unmarkiert, wenn Sie alle Hersteller exportieren möchten.

1. Geben Sie die Mindestmenge der Produkte im Lager ein.
2. Produkte mit geringeren Mengen werden im Feed übersprungen.
3. Geben Sie 0 ein, um nicht nach Menge zu filtern (Standard).
4. Nützlich, um nur verfügbare Produkte zu exportieren

1. Wählen Sie die Option „Nur Produkte mit Sonderangeboten”, wenn Sie nur Sonderangebote exportieren möchten.
2. Deaktivieren Sie diese Option, wenn Sie alle Produkte unabhängig von Sonderangeboten exportieren möchten.
3. Das Modul fügt automatisch das Feld „sale_price” für Produkte mit Rabatten hinzu.

8. Integration mit Google Merchant Center

1. Gehen Sie im PrestaShop-Admin-Panel zu Module → Modul-Manager.
2. Klicken Sie auf „Konfigurieren” beim Modul CC Google Merchant Feed.
3. Gehen Sie zur Registerkarte „Anleitungen”.”
4. Im Abschnitt „Link zum XML-Feed” sehen Sie die vollständige URL zum Feed.
5. Klicken Sie auf die Schaltfläche „Kopieren”, um die URL in die Zwischenablage zu kopieren.

1. Anmelden bei Google Merchant Center
2. Gehen Sie zum Abschnitt „Produkte” → „Kanäle”.”
3. Klicken Sie auf „Neuer Kanal”.”
4. Wählen Sie „Shopping-Anzeigen” oder den entsprechenden Kanaltyp aus.
5. Geben Sie den Namen des Kanals ein (z. B. „PrestaShop XML-Feed”).
6. Wählen Sie im Abschnitt „Produkte” die Option „Feed-URL” aus.”
7. Fügen Sie die kopierte URL in den Feed ein.
8. Klicken Sie auf „Weiter” und schließen Sie die Konfiguration des Kanals ab.

1. Nach dem Hinzufügen des Feeds wird Google ihn automatisch herunterladen und validieren.
2. Gehen Sie zu „Produkte” → „Diagnostik”
3. Überprüfen Sie, ob der Feed erfolgreich indexiert wurde.
4. Wenn es Fehler gibt, zeigt das Modul an, welche Produkte Probleme haben.

1. Google Merchant Center ruft den Feed manchmal automatisch ab.
2. Um eine sofortige Aktualisierung zu erzwingen, klicken Sie auf das Symbol „Aktualisieren“ neben dem Kanal.
3. Oder konfigurieren Sie die automatische Aktualisierung über CRON (siehe unten).

9. Automatische Aktualisierung (CRON)

• Tool zur automatischen Ausführung von Aufgaben auf dem Server
• Ermöglicht die Planung regelmäßiger Aktivitäten (alle 6 Stunden, täglich usw.)
• Ideal zum Aktualisieren des Google Merchant Center-Feeds
• Erfordert Zugriff auf das Hosting-/Server-Panel.

1. Wählen Sie in der Modulkonfiguration die Option „Automatische Aktualisierung” aus.”
2. Wenn Sie diese Option deaktivieren, wird der Feed für eine bestimmte Anzahl von Stunden zwischengespeichert.
3. Lassen Sie die Option aktiviert, um den Feed bei jedem Aufruf neu zu generieren.

0 */6 * * * curl -s "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 */6 * * * – startet die Aufgabe alle 6 Stunden zur vollen Stunde
• curl -s – lädt die URL im Hintergrundmodus (ohne Meldungen) herunter
• http://example.com – ersetzen Sie dies durch die Adresse Ihres Shops
• GENERATED_TOKEN – Sicherheitstoken aus der Modulkonfiguration
• > /dev/null 2>&1 – verbirgt Meldungen und Fehler

0 */6 * * * wget -q -O - "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 * * * * – jede Stunde
• 0 */6 * * * – alle 6 Stunden (empfohlen)
• 0 0 * * * – jeden Tag um Mitternacht
• 0 */12 * * * – alle 12 Stunden

10. Sicherheit und Tokens

• Einzigartiger Code, der bei der Installation des Moduls zufällig generiert wird
• Erforderlich bei jedem Aufruf des Feeds durch CRON
• Verhindert, dass Unbefugte den Feed aktualisieren können.
• Ändert sich bei jeder Regeneration

1. Gehen Sie im PrestaShop-Admin-Panel zu Module → Modul-Manager.
2. Klicken Sie auf „Konfigurieren” bei CC Google Merchant Feed.
3. Gehen Sie zur Registerkarte „Anleitungen”.”
4. Im Abschnitt „Automatische Regenerierung (CRON)” sehen Sie das Token
5. Ein Token ist eine lange Folge von alphanumerischen Zeichen.

http://example.com/modules/cc_ps_google_merchant/feed.xml http://example.com/modules/cc_ps_google_merchant/feed.xml?token=abc123def456ghi789jkl

1. Klicken Sie unter der Registerkarte „Anweisungen” auf die Schaltfläche „Neuen Sicherheitstoken generieren”.”
2. Ein Bestätigungsfenster erscheint – klicken Sie auf OK.
3. Ein neuer Token wird generiert und angezeigt.
4. Der alte Token wird sofort ungültig.
5. Wenn Sie CRON verwenden, müssen Sie den Befehl mit dem alten Token aktualisieren.

11. Anmeldung und Debugging

1. Öffnen Sie die URL des Feeds in Ihrem Webbrowser.
2. Sie sollten den rohen XML-Code mit den Produkten sehen.
3. Klicken Sie mit der rechten Maustaste und wählen Sie „Seitenquelle anzeigen”.”
4. Überprüfen Sie, ob die XML-Struktur korrekt ist.
5. Überprüfen Sie, ob alle erforderlichen Felder für jedes Produkt vorhanden sind.

1. Gehe zu XML-Validator
2. Kopieren Sie den Inhalt des Feeds und fügen Sie ihn in den Validator ein.
3. Der Validator zeigt an, ob die XML-Syntax korrekt ist.
4. Wenn es Fehler gibt, beachten Sie bitte die Zeilennummer, in der das Problem auftritt.

1. Weiter zu Google Merchant Center
2. Öffnen Sie den Feed-Kanal
3. Gehen Sie zu „Diagnose”.”
4. Überprüfen Sie „Fehler” und „Warnungen”.”
5. Google zeigt, welche Produkte Probleme haben und was daran falsch ist.

• Wenn der Feed nicht generiert wird, überprüfen Sie die PHP-Fehlerprotokolle auf dem Server.
• Fehler im Modul cc_ps_google_merchant suchen
• Überprüfen Sie, ob der Server Schreibrechte im Verzeichnis des Moduls hat.
• Überprüfen Sie, ob PHP die Erweiterung SimpleXML installiert hat.

12. Bildgrößen

1. Gehen Sie in der Modulkonfiguration zu „Bildgröße”.”
2. Wählen Sie die gewünschte Größe aus der Dropdown-Liste aus.
3. Klicken Sie auf „Speichern und XML-Feed generieren”.”

• Mindestgröße: 100 x 100 Pixel
• Empfohlene Größe: 800 x 800 Pixel oder größer
• Maximale Dateigröße: keine Beschränkung, aber Google lädt nur die ersten 10 MB herunter.
• Formate: JPG, PNG, GIF, BMP, TIFF, ICO, CUR, SVG, WEBP

• Das Modul kann bis zu 10 zusätzliche Fotos zu jedem Produkt hinzufügen.
• Erhöht die Wahrscheinlichkeit, dass das Produkt in der Google-Bildersuche erscheint.
• Sie können diese Option deaktivieren, um die Größe des Feeds zu verringern.
• Mit der Option „Maximale Anzahl zusätzlicher Bilder” können Sie die Anzahl kontrollieren.

13 Fehlersuche

1. Überprüfen Sie, ob das Modul im Modul-Manager aktiv ist.
2. Überprüfen Sie, ob der Server über Schreibrechte im Verzeichnis verfügt. /modules/cc_ps_google_merchant/
3. Melden Sie sich im Administrationsbereich an und klicken Sie auf „Speichern und XML-Feed generieren”.”
4. Überprüfen Sie die Server-Fehlerprotokolle (error.log PHP).
5. Stellen Sie sicher, dass PHP die SimpleXML-Erweiterung installiert hat.
6. Versuchen Sie, das Modul zu deaktivieren und erneut zu aktivieren.

1. Überprüfen Sie, ob die Produkte in PrestaShop aktiv sind.
2. Überprüfen Sie, ob den Produkten eine Kategorie zugewiesen ist.
3. Wenn Sie Filter verwenden, überprüfen Sie, ob die Produkte die Filterbedingungen erfüllen.
4. Überprüfen Sie die Mindestmenge auf Lager – Produkte, die nicht auf Lager sind, können ignoriert werden.
5. Öffnen Sie den XML-Feed in Ihrem Browser und suchen Sie die Produkte manuell (STRG+F).

1. Gehen Sie zum Google Merchant Center und öffnen Sie die Registerkarte „Diagnose”.”
2. Lesen Sie die genaue Fehlermeldung.
3. Überprüfen Sie, welche Felder fehlen – Google verlangt bestimmte Felder.
4. Das Modul ignoriert automatisch Produkte, bei denen erforderliche Daten fehlen.
5. Stellen Sie sicher, dass die Produkte Folgendes enthalten: Titel, Beschreibung, Link, Foto, Preis, Verfügbarkeit, GTIN oder Marke.

1. Überprüfen Sie, ob der Preis in PrestaShop korrekt eingestellt ist.
2. Überprüfen Sie, ob die Währung des Shops korrekt konfiguriert ist.
3. Wenn es Rabatte gibt, sollte das Modul den Preis mit Rabatt auswählen.
4. Überprüfen Sie, ob die Mehrwertsteuer korrekt angewendet wurde (der Preis sollte inklusive Mehrwertsteuer angegeben sein).

1. Überprüfen Sie, ob die Option „Zusätzliche Bilder” in der Konfiguration aktiviert ist.
2. Stellen Sie sicher, dass den Produkten in PrestaShop zusätzliche Fotos zugeordnet sind.
3. Überprüfen Sie, ob die maximale Anzahl zusätzlicher Bilder nicht auf 0 gesetzt ist.
4. Öffnen Sie den XML-Feed und überprüfen Sie, ob die Elemente g:additional_image_link vorhanden sind.

1. Überprüfen Sie, ob die CRON-Aufgabe im Hosting-Panel korrekt hinzugefügt wurde.
2. Überprüfen Sie, ob die URL im CRON-Befehl korrekt ist.
3. Überprüfen Sie, ob der Token in der URL aktuell ist (manchmal ändert er sich bei Updates).
4. Versuchen Sie, die URL manuell in den Browser einzugeben, um zu überprüfen, ob sie funktioniert.
5. Überprüfen Sie die CRON-Protokolle im Hosting-Panel – sie können Informationen zu Fehlern enthalten.

14. HÄUFIG GESTELLTE FRAGEN (FAQ)