Google Shopping Professional für Shopware 6

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 SYNERGY NETWORKS GmbH 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 Shopware Administration (c) shopware AG

• 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 wählen Sie die Sprache der Google Shopping-Kategorien aus.

Open

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

Open

3.1 Merchant-Konto Konfiguration

Open

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

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

Open

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

• Stellen Sie den Status auf Aktiv.

• Fahren Sie fort bei der Einstellung API-Authentifizierung.

Open

• Um mit dem Google Merchant Center zu kommunizieren, benötigen Sie die API-Informationen aus dem Merchant Center. Die Sie dann in der Einstellung API-Authentifizierung eintragen müssen.

• Gehen Sie dazu in die Einstellungen des Google Merchant Centers , klicken Sie auf "Content API" und erstellen Sie einen neuen API-Schlüssel.

Open

• Dieser Vorgang generiert eine JSON-Datei, die heruntergeladen wird. Es ist wichtig, diese Datei sicher zu speichern, da sie sensible Informationen enthält und nicht nochmal abgerufen werden kann.

• Um die API-Informationen einzugeben, klicken Sie auf den Button "Lokale JSON-Datei verwenden".

Open

• Klicken Sie auf den Button "Lokale JSON-Datei verwenden", und dann 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 im Google Merchant Center erstellt wurde.

Open

• Nachdem die JSON-Datei ausgewählt wurde, sollten die Felder "Client ID", "Client-Email" und "Privat-Key" automatisch mit den entsprechenden richtigen Werten befüllt sein.

• Tragen Sie nun Ihre Merchant-ID ein, die Sie ebenfalls im Google Merchant Center finden können.

Open

• Nachdem Sie Ihre Informationen eingegeben haben, können Sie diese mit der Schaltfläche „Validieren“ testen.

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

• Falls Sie weitere Anleitungen zur Erstellung des API-Schlüssels benötigen und wissen möchten, welche Einstellungen anschließend im Google Merchant Center vorgenommen werden müssen, finden Sie entsprechende Informationen im Abschnitt Google Merchant Center dieser Dokumentation.

• Nun sollte in der Konfiguration der Abschnitt “Google Merchant Einstellungen” erscheinen.

Open

• Die Einzelnen Felder füllen Sie nun aus

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

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

• “Sprache”, welche Sprache wird im jweiligen Verkaufskanal genutzt Haupteil der Texte

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

Open

3.1 Eigenschaftseinstellungen

Nachdem Sie die Merchant-Informationen erstellt haben, sehen Sie im Bereich „Eigenschaftseinstellungen“ in den Merchant-Einstellungen. In diesem Abschnitt können Sie einige der von Google Merchant angeforderten Informationen eingeben, ohne sie erneut im Google Shopping-Plugin einzugeben, indem Sie vorhandene Eigenschaften definieren. Wenn die entsprechenden Eigenschaften vorhanden sind, verwendet das Plugin die Daten aus diesen Eigenschaften.

Open

Definieren der Google-Produktkategorie für Kategorien

Wenn Sie möchten, dass Google-Produktkategorien vordefiniert werden, können Sie diese auf den Kategorieseiten definieren.

• Wählen Sie die gewünschte Kategorie aus

• Unten auf der Tab „Allgemein“ können Sie Ihre Kategorie im Abschnitt „Google Shopping Professional“ definieren.

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

Open

Produktdaten für Google Shopping/Artikelpflege

• überprüfen Sie anhand eines Beispielartikels, ob sowohl in den Stammdaten als auch auf Variantenebene, die zusätzlichen Google Shopping-Felder hinzugefügt wurden

• wenn das Plugin richtig installiert und konfiguriert wurde, sind nun alle Attributfelder am Stammartikel und auf Variantenebene zu sehen

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

Open

Definition der Attributfelder

Einige Attribute, die von Google Shopping verlangt werden, sind in den meisten Fällen bereits im Shopware-Administration eingepflegt.

Das Plugin greift automatisch auf folgende Informationen im Shopware-Administration zu:

• die meisten Attribute, die von Google Shopping verlangt werden, können direkt am Artikel/ an der Variante manuell gepflegt werden

• einige dieser Attributfelder müssen (diese sind im Folgenden rot gekennzeichnet) andere können (grün) ausgefüllt werden

• einige müssen nur unter bestimmten Bedingungen (bspw. Artikel, die zur Google ShoppingKategorie Bekleidung gehören) gesetzt werden (blau)

Artikel-Beschreibung

Titel

• individueller Google Shopping-Produkttitel

• genaue Bezeichnung des Artikels

• keine Werbetexte erlaubt (Bsp.: kostenloser Versand, durchgängige Großschreibung)

• bei Varianten: Unterscheidungsmerkmale wie Größe oder Farbe nennen

• maximal 150 Zeichen

• erfolgt hier kein Eintrag, wird automatisch die Artikel-Bezeichnung aus dem Shopware Backend genutzt

• für jede Variante individualisierbar

Beschreibung

• individuelle Google Shopping-Produktbeschreibung

• korrekte und detaillierte Beschreibung des Artikels

• keine Werbetexte erlaubt (Bsp.: kostenloser Versand, durchgängige Großschreibung)

• keine weiteren Links oder andere unpassende Informationen erlaubt

• ausschließlich Informationen zum Artikel

• maximal 5000 Zeichen

• erfolgt hier kein Eintrag, wird automatisch die Shopware-Backend-Beschreibung des Artikels (Langbeschreibung) gesetzt

• für jede Variante individualisierbar

Kategorie

• auswählen der passenden Google Shopping-Kategorie

• tiefste Kategorie-Ebene auswählen

• relevanteste Kategorie angeben

• vollständigen Pfad angeben

• für jede Variante individualisierbar

Zielgruppe

Altersgruppe

• gemeint ist die demografische Zielgruppe des Artikels

• vorgeschrieben beispielsweise bei Bekleidungsartikeln und Artikeln mit ausgewiesener Altersbeschränkung

• folgende Werte werden unterstützt:

  • [Neugeborene] (international: [newborn]; Alter: bis 3 Monate)

  • [Säuglinge] (international: [infant]; Alter: zwischen 3 und 12 Monaten)

  • [Kleinkinder] (international: [toddler]; Alter: zwischen 1 und 5 Jahren)

  • [Kinder] (international: [kids]; Alter: zwischen 5 und 13 Jahren)

  • [Erwachsene] (international: [adult]; Alter: in der Regel ab 13 Jahren)

• ist die Angabe der Altersgruppe unnötig: Keine Auswahl setzen

• für jede Variante individualisierbar

Nur für Erwachsene

• zeigt an, ob es sich um Artikel mit Inhalten nur für Erwachsene handelt

• ist das Produkt nur für Erwachsene bestimmt: [Ja] (international: [yes]) auswählen

• ist das Produkt jugendfrei [Nein] (international: [no]) auswählen

• ist eine Angabe unnötig: Keine Auswahl einstellen (dann wird automatisch der Standardwert ist jugendfrei gesetzt)

• für jede Variante individualisierbar

Geschlecht

• gibt die geschlechtsspezifische Zielgruppe des Artikels an

• erforderlich vor allem bei Bekleidungsartikeln, aber auch bei allen anderen geschlechtsspezifischen Artikeln (Bsp.: Kosmetik/Parfüm)

• unterstützte Werte:

  • [Herren] (international: [male])

  • [Damen] (international: [female])

  • [Unisex] (international: [unisex])

• ist eine genaue Bezeichnung unnötig: Keine Auswahl einstellen

• für jede Variante individualisierbar

Artikel-Eigenschaften

Material

• beschreibt den Stoff bzw. das Material des Produkts

• handelt es sich bei einem Artikel um mehrere Materialien: Primärmaterial gefolgt von maximal 2 Sekundärmaterialien getrennt durch Schrägstriche (Bsp.: Baumwolle/Polyester/Elastan) angeben

• maximal 200 Zeichen

• für jede Variante individualisierbar

Muster

• beschreibt das grafische Druckdesign bzw. Muster des Produkts (zum Beispiel: Streifen oder Punkte)

• Abkürzungen (bspw. Pkt.) vermeiden

• maximal 100 Zeichen

• für jede Variante individualisierbar

Energieeffizienzklasse

• erforderlich meist nur bei elektronischen Artikeln

• unterstützte Werte sind:

  • [A+++]

  • [A++]

  • [A+]

  • [A]

  • [B]

  • [C]

  • [D]

  • [E]

  • [F]

  • [G]

Farbe

• erforderlich für Bekleidungsartikel und alle Produkte, die in unterschiedlichen Farben erhältlich sind

• der Name der Farbe sollte derselbe sein wie auf der Zielseite (Artikel-Detailseite im Shop)

• bei mehrfarbigen Artikeln: bis zu drei Farbwerte können übergeben werden: Hauptfarbe gefolgt von 2 sekundären Farben getrennt durch Schrägstriche (Bsp.: Schwarz/Rot/Blau)

• maximal 100 Zeichen (40 Zeichen je Farbe)

• Ziffern oder nicht-alphanumerische Zeichen sind nicht erlaubt

• verwenden von Nicht-Farbwerten ist nicht erlaubt (bspw.: verschiedene, unbekannt)

• bei Nicht-Bekleidungsartikeln kann auch bunt oder mehrfarbig eingetragen werden

• für jede Variante individualisierbar

Bedingung

• beschreibt den Zustand des Produkts und ist für alle Artikel erforderlich

• unterstützte Werte sind:

  • [neu] (international: [new]; Bedeutung: brandneu, original, ungebraucht, ungeöffnete Originalverpackung)

  • [erneuert] (international: [refurbished]; Bedeutung: nicht neu, aber professionell generalüberholt, wirkt wie neu und wird mit einer Garantie geliefert, möglicherweise mit Originalverpackung, aufbereitet, aufgearbeitet)

  • [gebraucht] (international: [used]; Bedeutung: bereits benutzt, die Originalverpackung wurde bereits geöffnet oder fehlt ganz)

• für jede Variante individualisierbar

Größenangaben

Größensystem

• Länder haben unterschiedliche Größensysteme

• hier kann das Größensystem des Ziellandes gesetzt werden

• unterstützte Werte/Länder sind

  • [AU] Australien

  • [BR] Bulgarien

  • [CN] China

  • [DE] Deutschland

  • [EU] Europäische Union

  • [FR] Frankreich

  • [IT] Italien

  • [JP] Japan

  • [MEX] Mexiko

  • [UK] Großbritannien

  • [US] USA

• bei keiner Angabe: es wird automatisch das Zielland des Produktexports als Standardwert gesetzt

• für jede Variante individualisierbar

Größe

• hier die genaue Größe des Artikels angeben

• erforderlich für Bekleidungsartikel und Schuhe

• verschiedene Werte möglich (Bsp.: XS oder 36 oder 40/86 Übergröße > entspricht: Kragenweite 40 cm, Ärmellänge 86 cm, Passform Übergröße)

• handelt es sich um eine Einheitsgröße, dann Werte wie Einheitsgröße, EG oder Einheitliche Größe angeben

• maximal 100 Zeichen erlaubt

  für jede Variante individualisierbar

Größentyp

• empfohlen für Bekleidungsartikel

• hier wird der Schnitt des Produkts präzisiert

• mögliche Werte:

  • [Normalgröße] (international: [regular])

  • [Petite-Größe] (international: [petite]

  • [Übergröße] (für Frauen) (international: [plus])

  • [Übergröße] (für Männer) (international: [big and tall])

  • [Umstandsgröße] (international: [maternity])

• wird Keine Auswahl angegeben: Standardwert Normalgröße wird gesetzt

Versandeinstellungen

Bearbeitungszeit

• Erforderlich für Buy on Google – sofern nicht auf Kontoebene konfiguriert

• Optional für Shopping-Anzeigen und kostenlose Einträge

• Wenn Sie möchten, dass in Anzeigen und kostenlosen Einträgen die Versandgeschwindigkeit angegeben wird, empfehlen wir die Verwendung der Versand-Unterattribute „minimale Bearbeitungszeit“ und „maximale Bearbeitungszeit“ anstelle eigenständiger Attribute.

• Sie werden in Kombination mit den Versand-Unterattributen „minimale Laufzeit“ und „maximale Laufzeit“ verwendet, um die voraussichtliche Lieferdauer anzeigen zu lassen.

Laufzeitlabel

• Wenn die Laufzeit je nach Gruppe von Produkten variiert, können Sie das Attribut „Laufzeitlabel“ auf die entsprechenden Produkte in Ihrem Feed anwenden.

• Durch Laufzeitlabels erhalten Ihre Kunden einen genaueren voraussichtlichen Liefertermin, was ihre Kaufentscheidung beeinflussen kann.

• Mindestanforderungen:

  • Verwenden Sie keine ungültigen Unicode-Zeichen. Ungültige Unicode-Zeichen sind unter anderem:

    • Steuerzeichen (z. B. U+200D)

    • Funktionszeichen

    • Zeichen des privat nutzbaren Bereichs

    • Ersatzzeichenpaare

    • Nicht zugeordnete Codepunkte

• Beispiele:

  • Die meisten Ihrer Produkte werden schnell per Luftfracht geliefert. Sie bieten jedoch einige Elektroartikel mit Lithiumbatterien an, die auf dem Landweg versandt werden müssen. Verwenden Sie ein Lieferzeitlabel wie „Elektronik“ und geben Sie eine längere Lieferzeit an, damit Kunden wissen, wie lange die Lieferung dieser Produkte dauert.

Weitere Einstellungen (Adwords, Filter)

Eingeschlossenes Ziel

• Wenn Sie Ihr Produkt für bestimmte Standorte (zusätzlich zu den Standorten in Ihren Feedeinstellungen) hinzufügen möchten, verwenden Sie das Attribut „eingeschlossenes Ziel“

• unterstützte Werte:

  • [Shopping-Anzeigen]: Ihre Produktangebote in Shopping-Anzeigen anzeigen

  • [Buy on Google]: Produktangebote als aktive Buy on Google-Einträge angezeigt werden

  • [dynamischem Remarketing für den Einzelhandel]: Produktangebote in dynamischen Remarketing-Anzeigen erscheinen. Hinweis: Wenn Sie Displayanzeigen ausschließen, werden dynamische Remarketing-Anzeigen in einem verknüpften Merchant Center-Feed trotzdem in smarten Shopping-Kampagnen und Kampagnen für maximale Performance ausgeliefert.

  • [Anzeigen für lokales Inventar]: Produktangebote erscheinen in Anzeigen für lokales Inventar.

  • [Kostenlosen Produkteinträgen auf Google]: Produkte erscheinen in kostenlosen Einträgen auf Google.

  • [Kostenlosen lokalen Produkteinträgen auf Google]: Produkte erscheinen in kostenlosen lokalen Produkteinträgen auf Google.

• Wenn Sie widersprüchliche Informationen für die Attribute „Ausgeschlossenes Ziel“ [excluded_destination] und „Eingeschlossenes Ziel“ [included_destination] einreichen, hat der Wert für „Ausgeschlossenes Ziel“ immer Vorrang vor dem Wert für „Eingeschlossenes Ziel“.

Ausgeschlossenes Ziel

• mit dieser Einstellung kann verhindert werden, dass ein Artikel in bestimmten Arten von Werbekampagnen verwendet wird bzw. in welcher Art von Anzeigen der Artikel erscheinen soll

• unterstützte Werte:

  • [Shopping-Anzeigen]: Verhindern, dass Ihre Produktangebote in Shopping-Anzeigen erscheinen

  • [Buy on Google]: Verhindern, dass Ihre Produktangebote als aktive Buy on Google-Einträge angezeigt erscheinen

  • [dynamischem Remarketing für den Einzelhandel]: Verhindern, dass Ihre Produktangebote in dynamischen Remarketing-Anzeigen erscheinen. Hinweis: Wenn Sie Displayanzeigen ausschließen, werden dynamische Remarketing-Anzeigen in einem verknüpften Merchant Center-Feed trotzdem in smarten Shopping-Kampagnen und Kampagnen für maximale Performance ausgeliefert.

  • [Anzeigen für lokales Inventar]: Verhindern, dass Ihre Produktangebote in Anzeigen für lokales Inventar erscheinen.

  • [Kostenlosen Produkteinträgen auf Google]: Verhindern, dass Ihre Produkte in kostenlosen Einträgen auf Google erscheinen

  • [Kostenlosen lokalen Produkteinträgen auf Google]: Verhindern, dass Ihre Produkte in kostenlosen lokalen Produkteinträgen auf Google erscheinen.

• ist Keine Auswahl eingestellt: beide Arten von Werbekampagnen sind möglich

Filter (custom_label_0 bis custom_label_4)

• hier können benutzerdefinierte Filter für Ihre Google Shopping-Kampagnen erstellt werden

• die Filter können für Berichte und Gebote für Artikelgruppen genutzt werden

• diese Informationen werden dem potentiellen Käufer/Kunden nicht angezeigt

• pro Artikel können bis zu 5 Label (0 bis 4) definiert werden

• maximal können für ein Google Merchant Konto 5000 Labels eingerichtet werden

• maximal 100 Zeichen pro Label

• Beispielwerte: Ausverkauf, Sonderangebot, Jahreszeit, Saisonware, Preisspanne, Marge

• Google Shopping unterstützt die Attributwerte entweder in der jeweiligen Sprache des Shops bzw. des Werbeziellands oder allgemeingültig in Englisch

Varianten

• öffnen Sie die gewünschte Variante und pflegen Sie die Daten in alle Attributfelder soweit wie möglich ein

• Wenn das Feld nicht ausgefüllt wird, wird es mit den Informationen des Stammartikel gefüllt.

Sprach- und Subshops

• Google Shopping Professional ü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.

Open

• pflegen Sie die Produktdaten in die entsprechenden Attributfelder ein

Open

Feed-Aktualisierung

• 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 die Schaltfläche „Aktualisieren“ auf der Plug-in-Seite jedes Produkts verwenden oder den gesamten Feed auf der Seite „Händler“ aktualisieren.

Open

Produktseite

Open

Konto-Grundeinstellungsseite

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.

Anlegen des Produkt-Feeds

 

Open

Klicken Sie im Google Merchant Center auf das Zahnrad-Symbol in der oberen rechten Ecke des gewünschten Merchant-Kontos. Wählen Sie im daraufhin geöffneten Menü den Eintrag Datenquellen aus.

Open

Klicken Sie auf der Datenquellen-Seite auf die Schaltfläche Produktquelle hinzufügen.

Open

Wählen Sie die Option Produkte über die API hinzufügen aus und geben Sie der Datenquelle einen Namen. Klicken Sie anschließend auf die Schaltfläche Weiter, um das Feed hinzuzufügen.

 

Falls Sie zuvor bereits ein Feed für die API erstellt haben, wird diese Option nicht zur Auswahl stehen.

Open

Nachdem Sie die Datenquelle erstellt haben, wird Ihnen eine solche Seite angezeigt.

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

Open

Wenn Sie den Link besuchen, wird Ihnen ein Bildschirm wie im Screenshot angezeigt. Oben auf dem Bildschirm befindet sich ein Bereich zur Projektauswahl. Wählen Sie dort Ihr Projekt aus.

Open

Wählen Sie im Projekt-Auswahl-Modal Ihr vorhandenes Projekt aus. Falls Sie noch kein Projekt haben, klicken Sie auf die Schaltfläche Neues Projekt oben rechts im Modal.

Open

Nachdem Sie einen Projektnamen festgelegt haben, erstellen Sie Ihr Projekt durch Klicken auf die Schaltfläche Erstellen. Wählen Sie anschließend Ihr Projekt aus dem Projekt-Auswahl-Modal aus.

Open

Ausgewählter Projektzustand. Klicken Sie auf dieser Seite auf die Schaltfläche Aktivieren.

Open

Klicken Sie auf der Seite Content API for Shopping auf die Schaltfläche Anmeldedaten erstellen auf der rechten Seite.

Open

Klicken Sie im oben angezeigten Menü auf Dienstkonto, nachdem Sie auf Anmeldedaten erstellen geklickt haben.

Open

Geben Sie einen Namen für das Dienstkonto ein und klicken Sie anschließend auf die Schaltfläche Fertig.

Open

Wie Sie in der Dienstkonten-Tabelle sehen, wurde das Dienstkonto erstellt. Klicken Sie darauf, um einen Schlüssel zu erstellen.

Open

Klicken Sie auf der Detailseite des Dienstkontos auf den Reiter Schlüssel.

Open

Klicken Sie auf der geöffneten Seite auf Schlüssel hinzufügen und wählen Sie im erscheinenden Menü Neuen Schlüssel erstellen aus.

Open

Wählen Sie für den zu erstellenden Schlüssel den JSON-Datentyp aus und klicken Sie anschließend auf die Schaltfläche Erstellen.

Open

Nach der Erstellung des Schlüssels wird Ihnen diese Seite angezeigt, und während des Erstellungsprozesses wird automatisch eine .json-Datei auf Ihren Computer heruntergeladen. In den Merchant-Einstellungen des Shopware-Plugins können Sie diese JSON-Datei direkt verwenden.

Open

 

Nachdem der API-Schlüssel erstellt wurde, muss die E-Mail-Adresse des Dienstkontos, die mit dem API-Schlüssel verknüpft ist, im Merchant Center unter dem Menüpunkt "Einstellungen" im Abschnitt "Personen und Zugriff" hinzugefügt werden.

Open

 

Im Bereich "Personen" klicken wir auf die Schaltfläche "Person hinzufügen", geben die E-Mail-Adresse ein und wählen im nächsten Bildschirm die Optionen "Standard" und "Leistung und Statistiken" aus, bevor wir die Änderungen speichern.

Erfahren die Merchant-ID

Ihre Merchant-ID finden Sie oben rechts im Google Merchant Center. Im Beispielbild heißt es „552346XXX".

Open

Verwendung eines anderen Queue-Kanals für das Plugin

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:

Änderungen

3.5.3

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

3.5.2

• Das 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 im 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 entsprechend den Händlereinstellungen korrekt hinzugefügt werden.

3.4.2

• Das 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

• Eine 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 zu 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 sie 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

• Nicht aktive Produkte, die vom Kunden nicht in den Warenkorb gelegt werden können und deren Preis nicht berechnet werden kann, 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

• Ein neues Zusatzfeld wurde hinzugefügt, in dem du alte Google-Produkt-IDs verwenden kannst.

3.2.1

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

• Der 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

• Mengeneinheit für 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

• Der Fehler, bei dem einige Eingaben in den Händlereinstellungen nicht gespeichert wurden, wurde behoben.

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

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

3.0.0

• Es wurde für Shopware 6.6 kompatibel gemacht.

2.3.6

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

2.3.5

• Die Links der Produktbilder wurden korrigiert.

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

2.3.4

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

2.3.3

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

2.3.2

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

2.3.1

• Mit dem Update wurde der Fehler behoben, dass keine benutzerdefinierten Felder hinzugefügt wurden.

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.

• **Eigenschaftsauswahl in den Händlereinstellungen**: Auf der Seite der Händlereinstellungen wurde ein neuer Bereich für die Eigenschaftsauswahl eingeführt. 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**: Wir haben das Problem behoben, bei dem die definierten Domainnamen gelöschter Händler nicht wie erwartet entfernt wurden.

• **Produktnamengenerierung für Varianten**: Der 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 zur automatischen Löschung von Produkten aus Google Merchant wurde entfernt. Jetzt bleiben Produkte, die inaktiv oder nicht auf Lager sind, bei Google Merchant und spiegeln ihren aktualisierten Status wider.

2.2.5

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

2.2.4

• Der Fehler beim Erstellen eines neuen Produkts wurde behoben.

2.2.3

• Fehler beim Senden oder Löschen durch den Google Merchant bei der Durchführung einer Massenaktualisierung behoben.

2.2.2

• Der 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

• Das Produktstandardstatus-Einstellung wurde zur Merchant-Detailseite hinzugefügt.

• Auf der Produkt-Detailseite wurden Felder hinzugefügt, um die Auswahl des Produktstatus und für welche Domainnamen das Produkt verwendet wird, zu ermöglichen.

• Wenn der Status des Produkts nicht festgelegt ist, wird die Standard-Einstellung des Merchants verwendet. Wenn beide inaktiv sind, wird das Produkt nicht an Google Merchant

2.1.8

• Zusatzfelder für Kategorien und Produkte wurden verbessert.

2.1.7

• Fehler bei der Produktverknüpfung behoben.

2.1.6

• Einige benutzerdefinierte Felder wurden in allen Sprachen gleich gemacht.

• Der Fehler im Produkttitel wurde korrigiert.

2.1.5

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

2.1.4

• Google API-Client aktualisiert.

2.1.3

• Der Fehler wurde behoben, bei dem Klassen für diejenigen, die mit Composer installierten, zweimal enthalten waren.

2.1.2

• Das Kontexterstellungssystem wurde geändert.

2.1.1

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

2.1.0

• Standardmäßiger Produktaktivstatus hinzugefügt

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

• Indem Sie einer Kategorie eine Google Produkt Kategorie zuweisen, können Sie alle Produkte, die zu dieser Kategorie gehören, an Google Merchant senden, ohne jeder einzelnen Produkt individuell eine Google Produkt Kategorie zuweisen zu müssen.

2.0.0

• Kompatibilität mit Shopware 6.5

1.0.18

• Funktion getBatchResponseErrors korrigiert.

1.0.17

• Funktion getPrice korrigiert.

1.0.16

• Funktion getShippingCosts 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.

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

1.0.14

• Speicherproblem auf der Händlerdetailseite behoben.

1.0.13

• Produktlinks wurden nach Verkaufskanälen korrigiert.

1.0.12

• Verbesserungen wurden vorgenommen.

1.0.11

• Es ist so eingestellt, dass nur Varianten gesendet werden, wenn das Produkt Varianten hat.

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

• 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 Land des jeweiligen Domainnamens gesendet.

1.0.3

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

1.0.2

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

1.0.1

• Kompatibilität mit Shopware 6.4.15.0

• Jetzt direkt kompatibel mit minor Updates

1.0.0

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

Kompatibilität für Shopware Versionen

min. 6.4.14.0

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.

Schreiben Sie dazu bitte eine E-Mail an plugin@synergy-networks.de!