Vorwort

Wir freuen uns, dass Sie sich für unser Shopware 6-Plugin Google Shopping Professional interessieren oder sich sogar bereits dafür entschieden haben. Damit haben Sie einen ersten wichtigen Schritt zum erfolgreichen Verkaufen auf der Shopping-Plattform von Google gemacht.

Seit 2014 wurde unser Plugin mehr als 500 Mal aus dem ShopwareStore heruntergeladen und läuft seit dem erfolgreich in zahlreichen Onlineshops. Das Feedback unserer Kunden war stets positiv, was uns dazu motivierte, das Google Shopping Professional Plugin immer weiter zu verbessern.

Wir konnten erreichen, dass alle für Google Shopping derzeit relevanten Produktdaten über die API in das Google Merchant Center übergeben werden. Sie haben nun die Möglichkeit, Ihren Artikeln und Artikelvarianten mehr als 20 wichtige Attribute mitzugeben. Je detaillierter die Produkte beschrieben und mit Daten versehen werden, desto höher ist die Chance, dass die Produkte auf der Google Shopping-Plattform im Zusammenspiel mit Ihrer aktiven Google Shopping-Kampagne platziert werden.

Weiterhin lässt sich das Plugin auch für Sub- und Sprachshops einsetzen. Dabei bietet es länderspezifische Google-Taxonomien (Deutschland/Österreich/Schweiz, Frankreich, Niederlande, Polen, Italien, Spanien, Portugal, Norwegen, Türkei, Großbritannien/USA, Russland, China) an, um Ihnen das Werben in fremden Zielländern zu erleichtern und erfolgreicher zu gestalten. Für internationale Shopware-Nutzer ist das Google Shopping Professional-Plugin in zahlreichen Backend-Sprachen (Englisch, Französisch, Spanisch, Schwedisch, Norwegisch, Niederländisch, Polnisch, Finnisch, Italienisch, Bulgarisch) verfügbar.

Sollten Sie Vorschläge zur Weiterentwicklung des Plugins haben oder individuelle Anpassungen wünschen, zögern Sie nicht, uns zu kontaktieren. Registrieren Sie sich hierzu unter https://www.synergy-networks.de/konto#show-registration und erstellen ein Ticket für unser Entwicklerteam. Wir setzen uns anschließend umgehend mit Ihnen in Verbindung.

Anleitung

Wie Sie das Plugin Google Shopping Professional für Shopware 6 Ihren Anforderungen entsprechend anpassen, zeigen wir Ihnen Schritt für Schritt in dieser Dokumentation.

Inhaltsverzeichnis

1. Installation und Update

1.1 Plugin testen/ mieten

Sie haben die Möglichkeit, das Plugin vor der Miete ausgiebig zu testen. Wir stellen Ihnen einen Shopware-Demoshop zur Verfügung, um das Plugin im Backend und im Frontend zu testen.

• Sie erreichen das Frontend unter demo6.synergynetworks.de und das Backend unter https://demo6.synergynetworks.de/admin

• Benutzername: google

• Passwort: shopping

Nach Abschluss der Bestellung der Mietversion im Shopware-Store befinden sich Downloads und Lizenzen in der Lizenz-Verwaltung Ihres Shopware-Accounts.

1.2 Plugin installieren/updaten

Zur Installation des Plugins:

• öffnen Sie Erweiterungen > Meine Erweiterungen in der Shopware-Administration,

• installieren bzw. updaten Sie das Plugin,

• falls nicht bereits geschehen, aktivieren Sie das Plugin.

2. Plugin-Konfiguration

• Öffnen Sie in Ihrer Shopware-Administration den Menüpunkt Erweiterungen > Meine Erweiterungen. Wählen Sie das Plugin Google Shopping Professional aus und klicken Sie auf Konfiguration, um die Einstellungen des Plugins zu bearbeiten.

• In der Grundeinstellung Sprache (1) wählen Sie die Sprache der Google Shopping-Kategorien aus und aktualisieren Sie die Google Shopping Kategorien (2).

• Die Sprachänderung wird am Artikel oder in der Kategorie beim setzten der Google-Kategorie sichtbar.

3. Merchant-Konto Konfiguration

3.1 Einstellungen im Merchant-Manager

• Öffnen Sie in der Shopware-Administration den Menüpunkt Kataloge > Merchant Manager (1),

• klicken Sie auf die Schaltfläche Neues Konto erstellen (2).

• In den Basisinformationen (1) geben Sie den Konto-Namen (Merchant Namen) (1) ein, um Ihre Google Merchant Konto-API Verbindung zu Shopware zu benennen.

• Stellen Sie den Status auf Aktiv (3).

• Fahren Sie fort bei der Einstellung API-Authentifizierung (4).

3.2 API-Authentifizierung

3.2.1 API-Informationen von der Google Cloud Plattform

Um mit dem Google Merchant Center zu kommunizieren, benötigen Sie die API-Informationen von der Google Cloud-Plattform, welche Sie in der Einstellung API-Authentifizierung hinterlegen müssen. Haben Sie noch kein Dienstkonto erstellt, gehen Sie wie folgend beschrieben vor. (Sollten Sie schon ein Dienstkonto eingerichtet haben, führen Sie die Schritte ab Punkt 6 aus:

1. Gehen auf Ihre Google Cloud-Plattform (1) und wählen Sie IAM und Verwaltung (2).

2. Wählen Sie Dienstkonten (1) aus.

3. Wählen Sie Dienstkonto erstellen (1) aus.

4. Füllen Sie die Felder der Dienstkontodetails (1) aus.

Name des Dienstkontos (2): Vergeben Sie hier einen eindeutigen Namen. (Im Beispiel: Google Merchant API). Aus diesem Namen wird die Dienstkonto-ID (3) generiert. Fügen Sie eine kurze Beschreibung des Dienstkontos (4) (Im Beispiel: Google Merchant API Verbindung) hinzu. Klicken Sie auf Erstellen und fortfahren (5).

5. Optional können Sie nun noch Zugriff auf das Dienstkonto erteilen (1). Wählen Sie Rolle auswählen (2) > Basis (3) > Bearbeiter (4).

5.1 Fügen Sie die Rollen für Dienstkontonutzer (1) und Dienstkontoadministrator (2) hinzu. Klicken Sie auf Fertig (3).

6. In der Dienstkonto-Übersicht erscheint nun Ihr (neu) angelegtes Dienstkonto (1). Wählen Sie nun das Dienstkonto aus.

7. In den Dienstkontodetails des ausgewählten Dienstkontos wählen nun Schlüssel (1) aus. Klicken Sie auf Schlüssel hinzufügen (2) und dann auf Neuen Schlüssel erstellen (3).

8. Nun erscheint das Auswahlfenster Privaten Schlüssen für “Name Ihres Dienstkontos” erstellen (1). Wählen Sie den Schlüsseltyp JavaScript Object Notation (JSON)(2) aus und klicken Sie abschließend auf Erstellen (3).

3.2.2 API-Authentifizierung im Merchant Manager

• Um die API-Informationen im Merchant Manager Ihrer Shopware-Administration einzugeben, klicken Sie auf den Button Lokale JSON-Datei verwenden (1). Anschließend sollte sich der File Explorer (Windows) oder das Finder-Programm (MAC) öffnen. Navigieren Sie zu Ihrem Download-Ordner und wählen Sie die heruntergeladene JSON-Datei aus, die beim Erstellen des API-Schlüssels auf der Google Cloud Plattform erstellt wurde.

• Nachdem die JSON-Datei ausgewählt wurde, sollten die Felder Client ID (2), Client-Email (3) und Privat-Key (4) automatisch mit den entsprechenden Werten ausgefüllt sein.

• Tragen Sie nun Ihre Merchant-ID (5) ein. (Die Merchant-ID finden Sie in Ihrem im Google Merchant Center.)

• Nachdem Sie Ihre Informationen eingegeben haben, können Sie diese mit der Schaltfläche Validieren (6) überprüfen.

• Nach der Eingabe der API-Authentifizierungsdaten können Sie die Informationen mit dem Speichern-Button oben auf der Seite sichern.

3.3 Google Merchant Einstellungen im Merchant Manager

Nach dem Speichern Ihrer Einstellungen sollte in der Konfiguration der Abschnitt Google Merchant Einstellungen (1) erscheinen.

Vervollständigen Sie nun die Einstellungsoptionen:

• Im Feld Verkaufskanal (2) wählen Sie die Domain aus, die mit Ihrem Google Merchant Center verknüpft werden soll.

• Im Feld Zieland (3) wählen Sie das Land aus, für das der Verkauf über die ausgewählte Domain bevorzugt wird.

• Im Feld Sprache (4) legen Sie die Sprache fest, die im Verkaufskanal genutzt wird.

• Verknüpfen (5) Sie den Verkaufskanal mit Ihrem Google Merchant-Center-Konto.

Das Google Merchant Center lässt keine unterschiedlichen Domains zu. Definieren Sie daher nur Domains in verschiedenen Unterordnern für jedes Konto wie im folgenden Beispiel.

3.4 Eigenschaftseinstellungen

Nachdem Sie die Merchant-Konto Konfiguration vorgenommen haben, wird nun in der Grundeinstellungsübersicht der Bereich Eigenschaftseinstellungen (1) angezeigt. In diesem Abschnitt können Sie einige der von Google Merchant angeforderten Informationen auswählen, ohne sie erneut im Google Shopping-Plugin einzugeben zu müssen. Voraussetzung dafür ist, dass Sie die Eigenschaften in Ihrer Shopware-Administration (Kataloge > Eigenschaften) vorher definiert haben. Sind die entsprechenden Eigenschaften vorhanden, greift das Plugin auf diese Daten zurück.

4. Produktdaten (Attribute) für Google

Bevor Sie mit der Pflege der Produktdaten auf Kategorie- und Produktebene fortfahren, möchten wir Ihnen an dieser Stelle eine kurze Übersicht zu den Produktdaten für Google geben.
Ihre Produktdaten werden an Google mithilfe von Attributen eingereicht. Diese Attribute bilden die Grundlage für die Erstellung erfolgreicher Anzeigen sowie von Produkteinträgen für Ihre Produkte. (Aber: Nicht für jedes Produkt ist die Angabe der zur Verfügung stehenden Attribute erforderlich.) In dieser Übersicht (Stand April 2025) sehen Sie:

• die aktuelle Auflistung der möglichen Produktdaten, die Google vorgibt (Spalte 1),

• zu jedem Attribut ist die entsprechende Google-Seite verlinkt, damit Sie die entsprechenden Google-Anforderungen nachlesen können,

• die Übersicht, welche Produktdaten zwingend erforderlich oder optional für die Anzeige Ihrer Produkte sind (Spalte 2),

• einige Produktdaten, die von Google verlangt werden, sind bereits im Shopware-Standard definiert (Spalte 3),

• im Google Shopping Professional Plugin sind eine Vielzahl der Produktdaten enthalten (Spalte 4).

***Das Plugin greift auf die Daten aus dem Shopware-Standard zurück.

5. Kategorie- und Produktdaten-Einstellungen

5.1 Definieren der Google-Produktkategorie für Kategorien

Wenn Sie möchten, dass Google-Produktkategorien für Produkte einer Kategorie vordefiniert werden, können Sie diese auf den Kategorieseiten definieren.

• Wählen Sie in Ihrer Shopware-Administration die gewünschte Kategorie aus.

• Innerhalb der Kategorieeinstellung Allgemein können Sie im Abschnitt Google Shopping Professional die Google-Produktkategorie für diese Kategorie definieren.

• Damit legen Sie die Google-Produktkategorie für alle Produkte, die sich in dieser Kategorie befinden, fest.

5.2 Pflege der Produktdaten auf der Produktdetailseite

5.2.1 Anzeige der Google Shopping Professional-Felder am Produkt

• Überprüfen Sie, ob auf der Produktdetailseite die zusätzlichen Google Shopping Professional-Felder (1) hinzugefügt wurden,

• wenn das Plugin richtig installiert und konfiguriert wurde, sind nun alle Attributfelder bzw. Einstellungen (2) zu sehen,

• nun können Sie mit dem Einpflegen der entsprechenden Daten in die Attributfelder beginnen.

5.2.2 Statuseinstellungen

Produktstatus (1)
Definieren Sie hier den Produktstatus für das Google Merchat Center. Wählen Sie den entsprechenden Produktstatus aus: 

• Merchant Standard-Einstellungen (Übernimmt den Standardproduktstatus, der im Merchant Manager hinterlegt worden ist.)

• Nicht an Google Merchat übertragen

• An Google Merchant übertragen
  

Verkaufskanal auswählen für das Produkt (2)
Wählen Sie den Verkaufskanal aus, der im Merchant Manager hinterlegt worden ist.

5.2.3 Grundeinstellungen

Google-Produktkategorie (1)
Wählen Sie eine Google-Produktkategorie aus.

Produkttitel (2)
Wählen sie einen Produkttitel aus. Sie haben die Auswahl zwischen: Standardprodukttitel verwenden, SEO-Titel verwenden oder Benutzerdefinierter Titel verwenden. 

Benutzerdefinierter Titel verwenden (3)
Geben Sie einen benutzerdefinierten Titel an. Dieser Wert ist erforderlich, wenn Sie bei Produkttitel  die Auswahl für ein benutzerdefinierten Titel gewählt haben. (Max. 150 Zeichen).

Produktbeschreibung (4)
Wählen sie eine Produktbeschreibung aus. Sie haben die Auswahl zwischen: Standardbeschreibung verwenden, SEO-Beschreibung verwenden oder Benutzerdefinierte Beschreibung verwenden. 

Benutzerdefinierte Beschreibung (5)
Geben Sie einen benutzerdefinierten Beschreibung an. Dieser Wert ist erforderlich, wenn Sie bei Produktbeschreibung die Auswahl für ein benutzerdefinierte Beschreibung gewählt haben. (Max. 5000 Zeichen).

Alte Google-Produkt-ID (6)
Optional können Sie die Alte Google-Produkt-ID angeben, wenn diese verfügbar ist. Diese wird dann anstelle der Shopware-Produktnummer verwendet.

5.2.4 Elektronikeinstellungen

Energieeffizienzklasse (1)
Sollten Sie die Eigenschaft zur Energieeffizienzklasse in den Produkt-Eigenschaften noch nicht definiert haben, können Sie in dieser Auswahl die entsprechende Engergieeffizienzklasse definieren.

Minimale Energieeffizienzklasse (2)
Die minimale Energieeffizienzklasse wird in der Regel zusammen mit der Energieeffizienzklasse (die spezifische Klasse des Produkts) und der maximale Energieeffizienzklasse angegeben. Diese drei Attribute definieren den gesamten Bereich der Energieeffizienzklassen, innerhalb dessen sich das Produkt bewegt.

Beispiel: Wenn ein Wäschetrockner in den Energieeffizienzklassen von D (minimal) bis A+++ (maximal) erhältlich ist und das spezifische Produkt, die Klasse A+ hat, dann wären die Werte im Google Merchant Center:

• Energieeffizienzklasse: A+

• Minimale Energieeffizienzklasse: D

• Maximale Energieeffizienzklasse: A+++
  

Maximale Energieeffizeinzklasse (3)
Die maximale Energieeffizienzklasse wird in der Regel zusammen mit der Energieeffizienzklasse (die spezifische Klasse des Produkts) und der minimalen Energieeffizienzklasse angegeben. Diese drei Attribute definieren den gesamten Bereich der Energieeffizienzklassen, innerhalb dessen sich das Produkt bewegt.

Beispiel: Wenn ein Wäschetrockner in den Energieeffizienzklassen von D (minimal) bis A+++ (maximal) erhältlich ist und das spezifische Produkt, die Klasse A+ hat, dann wären die Werte im Google Merchant Center:

• Energieeffizienzklasse: A+

• Minimale Energieeffizienzklasse: D

• Maximale Energieeffizienzklasse: A+++

5.2.5 Textile Eigenschaften

Zustand (1)
Wählen Sie hier den Zustand Ihres Produktes aus. Zur Auswahl stehen Neu, Erneuert, Gebraucht.

Altersgruppe (2)
Wählen Sie die demographische Zielgruppe, für die Ihr Produkt bestimmt ist, aus. Zur Auswahl stehen: Neugeborene (0-3 Monate), Säugling (3-12 Monate), Kleinkind (1-5 Jahre), Kinder (5-13 Jahre), Erwachsene (ab 13 Jahren).

Geschlecht (3)
Wählen Sie das Geschlecht, für das Ihr Produkt bestimmt ist, aus. Zur Auswahl stehen: Männlich, Weiblich, Unisex.

Farbe (4)
Geben Sie die Farbe Ihres Produktes an. (Maximal 100 alphanumerische Zeichen (maximal 40 Zeichen pro Farbe)).

Material (5)
Geben Sie den Stoff oder das Materials Ihres Produktes an. (z.B. Leder) (Max. 200 Zeichen).

Muster (6)
Geben Sie das Muster Ihres Produktes an (z.B. gestreift oder gepunktet). (Max. 100 Zeichen).

Größe (7)
Geben Sie die Größe Ihres Produktes an (z.B. XL). (Max. 100 Zeichen).

Größentyp (8)
Wählen Sie den Größentyp Ihres Produktes aus. Zur Auswahl stehen: Normalgröße, Petite-Größe, Übergöße (für Frauen, Übergröße (für Männer), Überlänge, Umstandsgröße. 

Größensystem (9)
Wählen Sie das Größensystem für das Land, in dem das Produkt verwendet wird. Zur Auswahl stehen: AU, BR, CN, DE, EU, FR, IT, JP, MEX, UK, US.

5.2.6 Zusätzliche Einstellungen

Nicht jugendfrei (1)
Die Einstellung weist auf ein Produkt mit sexuell anzüglichen Inhalten hin und ist erforderlich, wenn ein Produkt nur Inhalte für Erwachsene enthält.

Set (2)
Wählen Sie aus, ob das Produkt aus einer zusammengestellten Gruppe unterschiedlicher Produkte, darunter einem Hauptprodukt, besteht. 

Multipack (3)
Mit dieser Einstellung weisen Sie aus, wenn Sie eine Gruppe identischer Produkte zusammengestellt haben und diese als Einheit verkaufen. Geben Sie die Anzahl der Produkte in ihrem Multipack an. (Beispiel: Sie bieten sechs Stück Seife an, dann tragen Sie eine 6 ein).

Promotion-ID (4)
Eine Kennzeichnung, mit der Sie Produkte und Angebote abgleichen können. Verwenden Sie eine eindeutige ID ohne Leerzeichen und Symbole, achten Sie auf Groß- und Kleinschreibung. (Max. 50 Zeichen).

Artikelgruppen-ID (5)
Die Artikelgruppen-ID wird verwendet, um Varianten des selben Produktes zu gruppieren und dient dazu, Google mitzuteilen, dass diese einzelnen Varianten eines Produktes zusammengehören. Beispiel: Sie verkaufen ein T-Shirt, das in verschiedenen Größen (S, M, L) und Farben (Rot, Blau, Grün) erhältlich ist. Jede dieser spezifischen Kombinationen (z.B. rotes T-Shirt in Größe M) ist eine Variante des gleichen Basisprodukts (des T-Shirts). Sie geben allen Varianten desselben Produkts denselben Wert für die Artikelgruppen-ID. (Max. 50 alphanumerische Zeichen)

Steuerkategorie (6)
Verwenden Sie diese Einstellung damit Ihr Produkt in den USA mit dem korrekten Steuersatz angezeigt wird. Mithilfe der Einstellung Steuerkategorie können Sie Ihre Produkte nach benutzerdefinierten Steuerregeln organisieren. Zum Beispiel ist bestimmte Bekleidung in einigen Bundesstaaten der USA von der Steuer befreit und für einige Produkte gelten niedrigere Steuersätze als der normale Steuersatz. (Max. 100 Zeichen).

Kennzeichnung existiert (GTIN, MPN, Marke) (7)
Wählen Sie mit der Einstellung Kennzeichnung existiert aus, wenn für Ihr Produkt keine eindeutige Produktkennzeichnung (unique product identifier, UPI) verfügbar ist. UPIs werden mit den Attributen GTIN, MPN und Marke eingereicht.

Highlights (8)
Beschreiben Sie die wichtigsten Highlights Ihres Produktes. Erstellen Sie eine Aufzählungsliste mit den wichtigsten Merkmalen. Erläutern Sie kurz und verständlich. Vermeiden Sie eine Aufzählung von Keywörtern, Suchbegriffen oder Werbetext.

Hinweis: Schreiben Sie Ihre Highlights Zeile für Zeile. (Max. 150 Zeichen).

5.2.7 Versandeinstellungen

Minimale Bearbeitungszeit (1)
Die minimale Bearbeitungszeit gibt die kürzeste Zeitspanne zwischen dem Zeitpunkt der Bestellung und dem Versand des Produkts an.
Hinweis: Wenn Sie einen Zeitraum angeben, reichen Sie diesen in Kombination mit der maximalen Bearbeitungszeit ein.

Maximale Bearbeitungszeit (2)
Die maximale Bearbeitungszeit gibt die längste Zeitspanne zwischen dem Zeitpunkt der Bestellung und dem Versand des Produkts an. Reichen Sie dieses Attribut ein, wenn Sie die Gesamtdauer anzeigen möchten, die benötigt wird, bis ein Produkt am Zielort ankommt. (Ganze Zahl, größer oder gleich 0. Geben Sie 0 an, wenn die Produkte am Tag der Bestellung verschickt werden.) 
Hinweis: Wenn Sie einen Zeitraum angeben, reichen Sie diesen in Kombination mit der minimalen Bearbeitungszeit ein.

Versandlänge (3)
Die Länge des Produkts (Paketlänge), die herangezogen wird, um die Versandkosten anhand des Volumengewichts zu berechnen. (1–150 für in; 1–400 für cm, unterstütze Einheiten: in oder cm).

Versandbreite (4)
Die Breite des Produkts (Paketbreite), die herangezogen wird, um die Versandkosten anhand des Volumengewichts zu berechnen. (1–150 für in; 1–400 für cm, unterstütze Einheiten: in oder cm).

Versandhöhe (5)
Die Höhe des Produkts (Pakethöhe), die herangezogen wird, um die Versandkosten anhand des Volumengewichts zu berechnen. (1–150 für in; 1–400 für cm, unterstütze Einheiten: in oder cm). 

Versandgewicht (6)
Geben Sie das Gewicht Ihres Produktes, das zur Berechnung der Versandkosten herangezogen wird, an. (0–2.000 lbs für angloamerikanisches Maßsystem, 1–1.000 kg für metrisches Maßsystem, unterstützte Einheiten lb, oz, g, kg).

5.2.8 Benutzerdefinierte Label

Benutzerdefinierte Label (1)
Die Benutzerdefinierten Labels 0–4 sind optionale Attribute im Google Merchant Center, die es Ihnen ermöglichen, Ihre Produkte nach Ihren eigenen Kriterien zu organisieren und zu segmentieren. Sie können diese Labels verwenden, um Produkte basierend auf Informationen zu kennzeichnen, die in Ihren Produktdaten nicht direkt durch andere Standardattribute abgedeckt sind, z.B. Saisonal, Ausverkauf, Feiertag, Angebot, Preisspanne. (Max. 100 Zeichen pro Label)

5.2.9 Zieleinstellungen

Zieleinstellungen

Die Einstellungen Eingeschlossenes Ziel (1) und Ausgeschlossenes Ziel (2) ermöglichen es Ihnen, präzise zu steuern, wo Ihre Produkte auf Google erscheinen sollen. Sie geben an, für welche Google-Oberflächen (sogenannte "Ziele") Ihre Produkte aktiviert oder deaktiviert werden sollen.

Grundlegendes Prinzip:

• Eingeschlossenes Ziel: Definiert explizit, wo Ihre Produkte erscheinen dürfen. Wenn Sie dieses Attribut verwenden, werden Ihre Produkte nur für die hier angegebenen Ziele aktiviert.

• Ausgeschlossenes Ziel: Definiert explizit, wo Ihre Produkte nicht erscheinen dürfen. Wenn Sie dieses Attribut verwenden, werden Ihre Produkte für die hier angegebenen Ziele deaktiviert.

Als verfügbare Ziele stehen zur Auswahl:

• Shopping-Anzeigen (Shopping_ads)

• Display-Anzeigen (Display_ads)

• Anzeigen lokales Inventar (Local_inventory_ads)

• Produkteinträge (Free_listings)

• Lokale Einträge (Free_local_Listings)

• Cloud Retail (cloud_retail)

• Lokaler Cloud-Einzelhandel (local_cloud_retail)

5.2.10 Produktprobleme

Anzeige, ob Probleme mit diesem Produkt auftreten.

5.2.11 Aktionen für Google Merchant Produktfeeds

• Bei erfolgreicher API-Verbindung werden Produkte bei jeder Änderung automatisch an das Google Mercant Center gesendet.

• Wenn Sie den Feed manuell aktualisieren möchten, können Sie dies auf jeder Produktdetailseite oder in den Einstellungen im Merchant Manager tun.

Aktualisierung auf der Produktdetailseite

Aktualisierung im Merchant Manager Ihrer Shopware-Administration

5.3 Varianten

Um die Produktdaten von Varianten Ihrer Produkte zu pflegen, gehen Sie wie folgt vor:

• Öffnen Sie die gewünschte Variante und pflegen auf der Produktdetailseite der Variante die notwendigen Produktdaten so weit wie nötig.

5.4 Sprachshops

• Das Google Shopping Professional Plugin überträgt die Funktionen des Produkts entsprechend der Sprache der Zieldomäne. Ist die Angabe der jeweiligen Sprache leer, werden die Features in die Systemsprache des Produkts übertragen.

• Wählen Sie auf der Produktdetailseite die Sprache aus, in der Sie die Informationen eingeben.

• pflegen Sie in den Google Shopping Professional-Feldern (1) die Produktdaten (2) in die entsprechenden Attributfelder ein.

6. Google Merchant Center

Wir gehen davon aus, dass Sie bereits ein Google Merchant Center-Konto angelegt haben. Ist dies nicht der Fall, folgen Sie bitte der Anleitung der Google Merchant Center-Hilfe unter Google Merchant Center.

6.1 Anlegen des Produkt-Feeds

6.2 Erstellung von API-Anmeldedaten über Google Cloud

Um API-Anmeldedaten erstellen zu können, besuchen Sie zuerst den folgenden Link.

https://console.cloud.google.com/marketplace/product/google/shoppingcontent.googleapis.com

6.3 Merchant-ID

Ihre Merchant-ID finden Sie im Google Merchant Center (wie im Bild angezeigt). Im Beispielbild heißt die ID „113XXXXXX".

7. Verwendung eines anderen Queue-Kanals für das Plugin

Dies ist eine Einstellung in der Datei config/packages/framework.yaml. Wenn Sie für Plugin-Messages einen anderen Message Queue-Kanal verwenden möchten, können Sie das GoogleShoppingMessageInterface verwenden. Wenn Sie Klassen definieren, die das AsyncMessageInterface implementieren, werden Messages sowohl asynchron als auch an den neu erstellten Kanal gesendet. Daher sollten Sie nur das GoogleShoppingMessageInterface definieren. Ein Anwendungsbeispiel finden Sie unten:

framework:
  lock: "%env(string:LOCK_DSN)%"
  mailer:
    message_bus: "messenger.default_bus"
  messenger:
    transports:
      syn_google_shopping:
        dsn: '%env(MESSENGER_TRANSPORT_SYN_GOOGLE_SHOPPING)%'
    routing:
      'Syn\GoogleShopping\MessageQueue\CustomTransportMessage\GoogleShoppingMessageInterface': 'syn_google_shopping'

8. Changelog

3.5.3

• Der Vorgang zur automatischen Aktualisierung von Merchant-Domainnamen bei Produktaktualisierungen wurde verbessert.

3.5.2

• Ein Problem, dass die Produkte einiger Merchants nicht aktualisiert wurden, wurde behoben. In dem Context, der zum Abrufen der Produkte erstellt wurde, wird nicht mehr die in der Merchant-Domain definierte Sprache verwendet, sondern die Sprache der Sales-Channel-Domain.

3.5.1

• Bei den Produktaktualisierungen wurde geprüft, ob der Merchant aktiv ist oder nicht.

3.5.0

• Leistungsverbesserungen wurden vorgenommen.

• Es wurde sichergestellt, dass Domainnamen bei Produktaktualisierungen und Produkterstellungen automatisch und korrekt, entsprechend den Merchant-Einstellungen, hinzugefügt werden.

3.4.2

• Ein Problem mit fehlenden Versanddaten für ausverkaufte Produkte beim Senden an Google Merchant wurde durch die Verwendung der Standardversandmethode und -preise gelöst.

3.4.1

• Die für den MessageService erforderlichen Routing-Daten werden nun durch den neu erstellten CompilerPass anstelle des MessageBus bereitgestellt.

3.4.0

• Ein GoogleShoppingMessageInterface wurde erstellt, für diejenigen, die einen anderen Queue-Kanal für Plugin-Nachrichten verwenden.

• Das neue Interface verhindert die Duplizierung von Nachrichten.

• Eine neue Message-Log-Entität wurde erstellt.

• Ein standardmäßiger 1-Minuten-Delay wurde für Produktaktualisierungsnachrichten hinzugefügt, um die Leistung und Quota-Nutzung zu verbessern.

• Ein Algorithmus wurde entwickelt, um zu verhindern, dass eine Produktaktualisierungsnachricht erneut zur Queue hinzugefügt wird, wenn die Nachricht bereits in der Queue wartet.

• Wenn ein Fehler beim Senden von Produktinformationen an Google auftritt, wird die Aktualisierungsnachricht mit einem Delay erneut zur Queue hinzugefügt.

• Im Falle eines Quota-Fehlers wird die Nachricht so zur Queue hinzugefügt, dass sie am nächsten Tag (nach pazifischer Zeitzone) ausgeführt wird.

• Eine neue Seite wurde erstellt, um die Quota-Informationen für den Händler anzuzeigen.

• Eine geplante Aufgabe wurde erstellt, um nicht löschbare oder fehlerhafte Nachrichtenprotokolle zu löschen.

3.3.2

• Inaktive Produkte, die vom Kunden nicht in den Warenkorb gelegt und deren Preis nicht berechnet werden können, werden nicht gesendet oder als "Nicht auf Lager" aktualisiert.

3.3.1

• Das neu hinzugefügte Zusatzfeld "old google product id" wurde in den Abschnitt "globale Zusatzfelder" hinzugefügt.

3.3.0

• Das Zusatzfeld Alte Google-Produkt-IDs verwenden wurde innerhalb der Plugin-Einstellungen auf den Produktdetailseiten neu hinzugefügt. Nun können auch ältere Google-Produkt-IDs verwenden werden.

3.2.1

• Ein Problem, das beim Anzeigen von Produktproblemen (auf den Produktdetailseiten) mit nur aus Ziffern bestehenden Produktnummern auftrat, wurde behoben.

• Ein Fehler, bei dem zuvor ausgewählte Kategorien beim Auswählen der Google-Produktkategorie nicht entfernt wurden, wurde behoben.

3.2.0

• Um die korrekte Schreibweise von Maßeinheiten im Kurzformat sicherzustellen und verschiedene Sprachen zu unterstützen, wurde den Maßeinheiten ein neues benutzerdefiniertes Feld hinzugefügt.

• Um die Fehlermeldung "Bild zu groß" beim Senden von Produktbildern zu vermeiden, wird anstelle des Originalbildes das größte Thumbnail gesendet.

3.1.0

• Die Mengeneinheit für das Grundpreis-Feature hinzugefügt.

3.0.3

• Rechtschreibfehler wurden korrigiert und zusätzliche erläuternde Texte hinzugefügt.

3.0.2

• Die durch Änderungen im Google API SDK verursachten Probleme in den Bereichen Authentifizierung und Problemliste wurden behoben.

3.0.1

• Ein Fehler, bei dem einige Eingaben in den Merchant-Manager-Einstellungen nicht gespeichert wurden, wurde behoben.

• Ein Fehler, bei dem die Statistik- und Issue-Seite nicht geladen wurden, wenn die Händlerinformationen falsch waren, wurde behoben.

• Ein Fehler, bei dem die Sprache für die Google-Produktkategorie nicht ausgewählt werden konnte, wurde behoben.

3.0.0

• DIe Kompatibilität mit Shopware 6.6. wurde hergestellt.

2.3.6

• Korrektur eines Fehlers beim Hinzufügen von nicht varianten Produkten.

2.3.5

• Die Links der Produktbilder wurden korrigiert.

• Ein Fehler bei der falschen Auflistung der Google-Produktkategorien in deutscher Sprache wurde behoben. Bitte aktualisieren Sie die Google-Produktkategorien.

2.3.4

• Ein Fehler, dass unvollständige Länderinformationen in den Lieferdetails gesendet wurden, wurde behoben.

2.3.3

• Ein Fehler, der beim Hinzufügen von benutzerdefinierten Feldern während der Installation und Aktualisierung auftrat, wurde behoben.

2.3.2

• Ein Fehler wurde behoben, bei dem der alte benutzerdefinierte Feldsatz nicht verwendet werden konnte.

2.3.1

• Mit dem Update wurde ein Fehler behoben, dass keine benutzerdefinierten Felder hinzugefügt werden konnten.

2.3.0

• Verbesserungen

• **Massenbearbeitung für benutzerdefinierte Felder**: Wir haben unsere Infrastruktur für benutzerdefinierte Felder, die speziell für Google Shopping Professional entwickelt wurden, verbessert. Mit dieser Änderung können Sie nun alle für Google Shopping Professional erstellten benutzerdefinierten Felder in Massen bearbeiten. Bitte beachten Sie, dass durch diese Modifikationen alle Produktbenutzerfelder während des Updates der Erweiterung automatisch aktualisiert werden. Die Dauer dieses Updates kann je nach Anzahl der Produkte und Kategorien, die Sie haben, variieren.

• **Eigenschaftseinstellungen im Merchant Manager in den Händlereinstellungen**: Im Merchant Manager in Ihrer Shopware-Administration wurde ein neuer Bereich für die Eigenschaftseinstellungen hinzugefügt. Dieses Update macht es unnötig, zuvor festgelegte Produkteigenschaften auf Ihrer Erweiterungsseite neu zu definieren, indem Sie direkt die Standard-Eigenschaften auswählen können.

• Fehlerbehebungen

• **Problem mit beständigen Domainnamen gelöst**: Ein Problem, bei dem die definierten Domainnamen gelöschter Händler nicht wie erwartet entfernt wurden, konnte behoben werden.

• **Produktnamengenerierung für Varianten**: Ein Fehler bei der automatischen Generierung von Produktnamen für Variantenprodukte, unter Verwendung des Namens des Hauptprodukts, wurde korrigiert. Diese Funktion kann nun von der Seite der Händlereinstellungen aktiviert oder deaktiviert werden.

• Weitere Änderungen:

• **Entfernung der automatischen Produktlöschung**: Die Funktion zum automatischen Löschen von Produkten aus Google Merchant Center wurde entfernt. Nun verbleiben Produkte, die inaktiv oder nicht auf Lager sind, im Google Merchant Center und spiegeln ihren aktualisierten Status wider.

2.2.5

• Ein Problem, dass Produkt-Zusatzfelder nicht angezeigt werden konnten, wurde behoben.

2.2.4

• Ein Fehler beim Erstellen eines neuen Produkts wurde behoben.

2.2.3

• Ein Fehler - bei der Durchführung einer Massenaktualisierung-, beim Senden oder Löschen von Daten an das Google Merchant Center wurde behoben.

2.2.2

• Ein Fehler bei der Erstellung eines nicht autorisierten Kontexts wurde behoben.

2.2.1

• Die automatische Löschfunktion aus dem Merchant Center, wenn der Merchant-Domainname von der Produktdetailseite entfernt wird, wurde behoben.

2.2.0

• Die Einstellung Standardproduktstatus in den Feed-Einstellungen des Merchant-Managers wurde hinzugefügt.

• Auf der Produkt-Detailseite wurden zusätzliche Felder hinzugefügt: Anzeige des Produktstatus und Anzeige des Verkaufskanals für das Produkt.

• Wenn der Produktstatus auf der Produkt-Detailseite nicht festgelegt ist, wird die Einstellung des Standardproduktstatus im Merchant-Managers verwendet. Wenn beide inaktiv sind, wird das Produkt nicht an das Google Merchant Center übertragen.

2.1.8

• Die Zusatzfelder für Kategorien und Produkte wurden optimiert.

2.1.7

• Ein Fehler bei der Produktverknüpfung behoben.

2.1.6

• Einige benutzerdefinierte Felder wurden für alle Sprachen angepasst.

• Ein Fehler im Attribut Produkttitel wurde korrigiert.

2.1.5

• Die Funktion Löschanforderung für inaktive Produkte während der Kategorie- oder Händleraktualisierung wurde entfernt.

2.1.4

• Der Google API-Client aktualisiert.

2.1.3

• Ein Fehler wurde behoben, bei dem Klassen doppelt enthalten waren, bei Nutzern, die mit Composer installiert haben.

2.1.2

• Das System zur Kontexterstellung wurde geändert.

2.1.1

• Das Problem Null-Kontext für GoogleProductDeleteMessage wurde behoben.

2.1.0

• Standardmäßig ist nun ein Produktaktivstatus hinzugefügt worden.

• Produkte, ohne Google Produkt Kategorie ID, werden nun nicht mehr an Google Merchant gesendet.

• Indem Sie einer Shop-Kategorie eine entsprechende Google Produktkategorie zuweisen, können Sie alle Produkte, die zu dieser Shop-Kategorie gehören, an Google Merchant senden, ohne, dass Sie an jedem einzelnen Produkt dieser Shop-Kategorie eine Google Produktkategorie zuweisen zu müssen.

2.0.0

• Die Kompatibilität mit Shopware 6.5 wurde hergestellt.

1.0.18

• Die Funktion getBatchResponseErrors wurde korrigiert.

1.0.17

• Die Funktion getPrice wurde korrigiert.

1.0.16

• Die Funktion getShippingCosts wurde korrigiert.

1.0.15

• Produkt- und Versandpreise wurden vollständig von Regeln abhängig gemacht. Es werden Versandmethoden unterstützt, die anhand von Produktpreis, Gewicht usw. definiert sind.

• Eine Schaltfläche zum Löschen von Merchant-Logs wurde hinzugefügt.

1.0.14

• Ein Speicherproblem auf der Händlerdetailseite wurde behoben.

1.0.13

• Produktlinks wurden nach Verkaufskanälen korrigiert.

1.0.12

• Allgemeine Verbesserungen wurden vorgenommen.

1.0.11

• Das Plugin wurde so eingestellt, dass nur Varianten gesendet werden, wenn das Produkt auch Varianten besitzt.

1.0.10

• An den Produktdetails wurden Verbesserungen vorgenommen.

# 1.0.9

• Die Links von Produkttitelbildern wurden korrigiert.

1.0.8

• Preise für Varianten wurden korrigiert.

1.0.7

• Das Problem mit ShippingMethodEntity behoben.

1.0.6

• Es wurden Verbesserungen beim Produktversand vorgenommen.

1.0.5

• Es wurden Verbesserungen beim Produktversand vorgenommen.

• Bis zum nächsten Update werden nur die Statistiken für den Shopping-Kanal angezeigt.

1.0.4

Fixed

• Zu viele Werte (Dienstleistungen) [Versand]

• Beim Versenden von Produktinformationen werden jetzt nur Versandinformationen gemäß dem Zielland des jeweiligen Domainnamens gesendet.

1.0.3

• Ein Fehler wurde behoben, der durch den Befehlstyp Changeset-Trigger Ereignis verursacht wurde.

1.0.2

• Ein Problem wurde behoben, bei dem die Kategorien beim Definieren der Google-Produktkategorie-ID nicht gespeichert wurden.

1.0.1

• DIe Kompatibilität mit Shopware 6.4.15.0. wurde hergestellt.

• Jetzt direkt kompatibel mit minor Updates.

1.0.0

• Erste Veröffentlichung von Google Shopping Professional für Shopware 6.

9. Kompatibilität für Shopware Versionen

min. 6.4.14.0

10. Allgemeiner Hinweis

Die Einrichtung und Konfiguration des Plugins Google Shopping Professional, der Produktübertragung und des Produkt-Feeds im Google Merchant Center ist damit abgeschlossen.

Wir hoffen, dass wir Ihnen mit dieser umfangreichen Dokumentation das Einrichten und Konfigurieren des Plugins erleichtern konnten und Sie schon bald erste Erfolge bei Google Shopping erreichen können.

Sollten Sie trotz der gewissenhaften Studie dieser Dokumentation Fragen haben, stehen wir Ihnen gerne zur Verfügung.

Ihr SYNERGY-NETWORKS-Team!