M0025 LoadBee-Integration für Gambio
Handbuch
1. WAS DIESES MODUL LEISTET
Viele Markenhersteller stellen für ihre Artikel fertig gestaltete Produktwelten bereit: bebilderte Beschreibungen, technische Datenblätter, Anwendungsbeispiele, Videos und Vergleichstabellen – also genau die Inhalte, die ein Shopbetreiber sonst mühsam selbst erstellen müsste. Der Dienstleister loadbee bündelt diese Herstellerinhalte und liefert sie an angeschlossene Shops aus.
Unser Modul verbindet Ihren Gambio-Shop mit diesem Angebot. Es meldet für jeden aufgerufenen Artikel dessen EAN an loadbee, und wenn der Hersteller für genau diesen Artikel Inhalte hinterlegt hat, erscheinen sie automatisch auf der Artikeldetailseite – wahlweise oberhalb oder unterhalb Ihrer eigenen Artikelbeschreibung. Sie pflegen nichts nach: Aktualisiert der Hersteller seine Inhalte, ändert sich die Darstellung in Ihrem Shop von allein mit.
Zusätzlich kann das Modul die EAN eines Artikels in den Artikeldaten auf der Detailseite ausgeben – eine Angabe, die Gambio von Haus aus zwar speichert, im Shop aber nicht anzeigt.
- Herstellerinhalte automatisch auf der Artikeldetailseite, gesteuert über die EAN
- Anzeige wahlweise oberhalb oder unterhalb Ihrer eigenen Beschreibung
- Optionale Anzeige der EAN in den Artikeldaten
- Funktioniert auch bei Artikeln, die gar keine eigene Beschreibung haben
- Keine laufende Pflege, kein Import, keine zusätzlichen Dateien im Shop
2. VORAUSSETZUNGEN
Damit Herstellerinhalte erscheinen, müssen drei Dinge zusammenkommen:
- Ein eigener API-Schlüssel von loadbee. Den erhalten Sie direkt beim Anbieter unter www.loadbee.com. Zum Zeitpunkt der Modulveröffentlichung wurde er in der Regel kostenfrei vergeben; die aktuellen Bedingungen nennt Ihnen der Anbieter.
- Gepflegte EANs an Ihren Artikeln. Ohne EAN kann kein Inhalt zugeordnet werden.
- Der Hersteller muss Inhalte bereitstellen. Das Angebot umfasst vor allem Markenartikel. Für Eigenmarken, Ersatzteile oder No-Name-Ware gibt es üblicherweise keine Herstellerinhalte.
3. WO SIE DAS MODUL IM BACKEND FINDEN
Das Setup erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „Xycons LoadBee“. Eine eigene Arbeitsoberfläche braucht das Modul nicht – es arbeitet nach der Einrichtung vollständig im Hintergrund.
4. DAS SETUP IM DETAIL
Richten Sie das Modul zuerst vollständig ein und schalten Sie es danach frei. So sehen Ihre Kunden nie einen Zwischenzustand.
4.1 GRUNDEINSTELLUNG
Modulstatus - LoadBee – der Hauptschalter. Solange er auf „Ausgeschaltet“ steht, greift das Modul an keiner Stelle in Ihren Shop ein: weder Herstellerinhalte noch EAN-Anzeige. Schalten Sie ihn erst ein, wenn der Zugangsschlüssel hinterlegt und die Anzeigeposition gewählt ist. (Standard: Ausgeschaltet)
Ihre Lizenz: – eine reine Anzeige. Hier steht, welchen Lizenztyp das Modul für Ihren Shop erkannt hat. Daneben zeigt das Setup Ihre Version und die Lizenzstufe; beide Angaben brauchen Sie nur, wenn Sie sich mit einer Rückfrage an uns wenden.
4.2 IHR ZUGANG ZU DEN HERSTELLERINHALTEN
API-Key – Ihr persönlicher Zugangsschlüssel von loadbee. Ohne ihn werden keine Inhalte abgerufen, auch wenn das Modul eingeschaltet ist. Tragen Sie den Schlüssel genau so ein, wie Sie ihn vom Anbieter erhalten haben. (Standard: leer)
4.3 ANZEIGE IM SHOP
Anzeige – hier legen Sie fest, wo der Herstellerinhalt auf der Artikeldetailseite erscheint. Zur Wahl stehen „Oberhalb der regulären Artikel-Beschreibung“ und „Unterhalb der regulären Artikel-Beschreibung“. In beiden Fällen sitzt der Inhalt im Beschreibungsbereich der Artikelseite, Ihre eigene Beschreibung bleibt also vollständig erhalten. (Standard: Unterhalb der regulären Artikel-Beschreibung)
Welche Position die bessere ist, hängt von Ihren eigenen Texten ab: Pflegen Sie ausführliche eigene Beschreibungen, steht Ihr Text besser oben und die Herstellerwelt darunter. Sind Ihre eigenen Texte knapp, wirkt die bebilderte Herstellerwelt oben stärker.
EAN anzeigen – blendet die EAN des Artikels in den Artikeldaten neben Artikelnummer, Lieferzeit und Lagerbestand ein. Das ist unabhängig davon, ob der Hersteller Inhalte liefert: Angezeigt wird, was Sie am Artikel gepflegt haben. (Standard: Nein, nicht anzeigen)
4.4 ALLE WERTE AUF EINEN BLICK
| Einstellung | Bedeutung | Standard |
|---|---|---|
| Modulstatus - LoadBee | Hauptschalter des Moduls | Ausgeschaltet |
| Ihre Lizenz: | Anzeige des erkannten Lizenztyps | – |
| API-Key | Ihr Zugangsschlüssel von loadbee | leer |
| Anzeige | Herstellerinhalt oberhalb oder unterhalb Ihrer Beschreibung | Unterhalb |
| EAN anzeigen | EAN in den Artikeldaten ausgeben | Nein |
5. SO WIRKT DAS MODUL IM SHOP
5.1 DER HERSTELLERINHALT AUF DER ARTIKELSEITE
Ruft ein Besucher einen Artikel auf, zu dem Herstellerinhalte vorliegen, erscheinen diese im Beschreibungsbereich – mit Bildern, Zwischenüberschriften und oft mehreren Bildstrecken. Die Darstellung gestaltet der Hersteller; sie passt sich der Breite Ihres Shops an und ist auch auf Mobilgeräten lesbar.
Besonders hilfreich ist das bei Artikeln ohne eigene Beschreibung: Früher blieb der Beschreibungsbereich dort leer, heute übernimmt der Herstellerinhalt diesen Platz und die Artikelseite wirkt vollständig.
5.2 DIE EAN IN DEN ARTIKELDATEN
Ist die EAN-Anzeige eingeschaltet, erscheint die EAN in derselben Aufstellung wie Artikelnummer, Lieferzeit und Lagerbestand – in gleicher Schrift und gleicher Ausrichtung.
6. DIE EAN - DER SCHLÜSSEL ZUM INHALT
Die Zuordnung zwischen Ihrem Artikel und dem Herstellerinhalt läuft ausschließlich über die EAN. Sie pflegen sie in der Artikelbearbeitung im Feld EAN. Damit die Zuordnung gelingt, sollte die EAN vollständig und ohne Zusätze eingetragen sein – also die reine Ziffernfolge, ohne Leerzeichen, Bindestriche oder Anmerkungen.
Erscheinen bei einzelnen Artikeln keine Inhalte, liegt das fast immer an einem dieser drei Punkte: Es ist keine EAN gepflegt, die EAN gehört zu einer anderen Verpackungseinheit als die des Herstellers, oder der Hersteller stellt für diesen Artikel schlicht keine Inhalte bereit. Eine schnelle Gegenprobe: Prüfen Sie einen bekannten Markenartikel, von dem Sie sicher wissen, dass der Hersteller Produktwelten pflegt.
Wenn Sie Ihre Artikel über einen CSV-Import oder ein Warenwirtschaftssystem befüllen, achten Sie darauf, dass das EAN-Feld dabei mitgefüllt wird. Je vollständiger Ihre EAN-Pflege ist, desto mehr Artikelseiten profitieren vom Modul – ganz ohne weiteren Aufwand.
7. MEHRSPRACHIGE SHOPS
Das Modul übergibt dem Dienst zusammen mit der EAN auch die Sprache, in der Ihr Besucher den Shop gerade ansieht. Liegen die Herstellerinhalte in dieser Sprache vor, erscheinen sie übersetzt; andernfalls bleibt der Bereich leer. Ihre eigene Artikelbeschreibung ist davon nicht betroffen – sie wird wie gewohnt in der jeweiligen Shopsprache ausgegeben.
8. TEXTE ÄNDERN
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Admin-Bereich an eigene Bedürfnisse anpassen. Das betrifft hier vor allem die Beschriftung der EAN-Zeile auf der Artikeldetailseite: Wenn Sie statt „EAN“ lieber „GTIN“ oder „Artikelkennung“ ausgeben möchten, ändern Sie das dort – ohne Eingriff in Dateien und ohne unsere Hilfe.
9. SHOPUPDATE
Bevor Sie Ihren Shop auf eine neue Version aktualisieren, prüfen Sie bitte auf unserer Internetseite, ob das Modul für diese Shopversion freigegeben ist. Module greifen an genau den Stellen in den Shop ein, die sich bei einem Update verändern können.
Installieren Sie beim Shopupdate immer auch die neuesten Fassungen des Moduls und der Modulumgebung – nicht nur den Shop selbst. Ein älteres Modul passt sich einer neuen Shopversion nicht von allein an; die Folge wären Darstellungsfehler, deren Ursache man erfahrungsgemäß an der falschen Stelle sucht. Lassen Sie die Aktualisierung durch uns durchführen, werden Modul und Modulumgebung automatisch mitgezogen.
10. HÄUFIGE STOLPERSTEINE
Es erscheinen gar keine Herstellerinhalte. Prüfen Sie der Reihe nach: Ist der Hauptschalter eingeschaltet? Ist der Zugangsschlüssel hinterlegt? Ist am Testartikel eine EAN gepflegt? Erst wenn alle drei Punkte erfüllt sind, kann überhaupt etwas erscheinen.
Inhalte erscheinen nur bei einem Teil der Artikel. Das ist der Normalfall und kein Fehler. Herstellerinhalte gibt es vor allem für Markenartikel; für Eigenmarken, Zubehör und Ersatzteile in aller Regel nicht.
Nach dem Einschalten ändert sich zunächst nichts. Shops halten gestaltete Seiten zwischengespeichert. Leeren Sie nach der Einrichtung einmal den Shop-Cache und laden Sie die Artikelseite neu.
Die EAN-Zeile fehlt bei einem Artikel. Dann ist an diesem Artikel keine EAN hinterlegt. Die Zeile wird bewusst nur dann ausgegeben, wenn es etwas anzuzeigen gibt.
Die Herstellerinhalte sehen anders aus als in Ihrem Shopdesign. Das ist beabsichtigt: Gestaltung und Inhalt stammen vom Hersteller und werden von diesem vorgegeben. Sie können die Position im Setup wählen, nicht aber die Gestaltung der Inhalte selbst.
Der Inhalt sitzt an der falschen Stelle. Stellen Sie die gewünschte Position im Setup unter „Anzeige“ um; die Änderung wirkt sofort für alle Artikel.

