M0069 eKomi-Importer für Gambio
Handbuch
1. Was das Modul für Sie leistet
Wer seine Kundenzufriedenheit über eKomi erhebt, sammelt dort wertvolle Produktbewertungen – sie liegen aber beim Bewertungsdienst und nicht dort, wo Ihre Kunden kaufen. Das Modul holt diese Bewertungen regelmäßig in Ihren Shop und übergibt sie an das eingebaute Bewertungssystem von Gambio. Damit erscheinen sie genau dort, wo sie wirken: direkt am Artikel.
Im Einzelnen leistet das Modul:
- den automatischen Abruf der bei eKomi gesammelten Produktbewertungen,
- die Übernahme dieser Bewertungen in das Bewertungssystem Ihres Shops,
- die Zuordnung jeder Bewertung zur zugehörigen Bestellung, zum Artikel und zum Kunden,
- die Kennzeichnung übernommener Bewertungen mit dem Logo des Bewertungsdienstes,
- die wahlweise gekürzte oder vollständig ausgeblendete Anzeige der Kundennamen,
- optional die Einbindung der eKomi-Zustimmungslösung auf der Bestellabschlussseite.
Die Bewertungen gelangen in das eingebaute Bewertungssystem von Gambio. Eine Übergabe an zusätzlich betriebene Fremdsysteme – etwa Mailbeez – findet ausdrücklich nicht statt.
2. Voraussetzungen
Für den Betrieb brauchen Sie:
- einen laufenden Vertrag mit eKomi und ein Konto, in dem Produktbewertungen erhoben werden,
- die eKomi-Zugangsdaten (Interface-ID und Interface-Passwort), die im Shop hinterlegt sein müssen,
- die installierte Modulumgebung von Xycons in einer zum Modul passenden Version.
Die eKomi-Zugangsdaten pflegen Sie nicht im Modul, sondern in der eKomi-Anbindung Ihres Shops. Das Modul greift auf genau diese Daten zu – Sie müssen sie also nur einmal hinterlegen. Alternativ können Sie eine Abruf-Adresse verwenden, die Sie direkt von eKomi erhalten haben; dazu mehr in Abschnitt 4.3.
3. Wo Sie das Modul im Backend finden
Das Setup erreichen Sie über das Menü „Xycons-Module" ► „Kundenkonto / Setups" und dort über den TAB „eKomi Bewertungsimport".
Die Bedienoberfläche, über die Sie einen Import von Hand anstoßen, finden Sie ebenfalls im Menü „Xycons-Module" unter dem Eintrag „eKomi Import ausführen".
4. Das Setup
Im Setup legen Sie fest, ob das Modul arbeitet, wie die übernommenen Bewertungen im Shop aussehen und woher die Bewertungen bezogen werden. Nehmen Sie sich diese Einstellungen vor dem ersten Import vor – sie wirken sich unmittelbar auf das aus, was Ihre Kunden zu sehen bekommen.
4.1 Modul und Lizenz
| Einstellung | Bedeutung |
|---|---|
| Modulstatus | Der Hauptschalter. Ist das Modul ausgeschaltet, findet kein Import statt, die zeitgesteuerte Aufgabe läuft ins Leere, und im Shop werden weder Herkunfts-Logos noch die gekürzte Namensanzeige verwendet. (Standard: ausgeschaltet) Schalten Sie das Modul erst ein, wenn Sie die übrigen Einstellungen vorgenommen haben. |
| Ihr Lizenzschlüssel | Der Schlüssel, den Sie mit dem Modul erhalten haben. Ohne gültigen Schlüssel arbeitet das Modul nicht. (Standard: leer) |
| Ihre Lizenz | Zeigt an, welche Lizenzart erkannt wurde. Dieses Feld ist eine reine Anzeige und kann nicht bearbeitet werden. |
4.2 Darstellung der Bewertungen
Bewertungen von eKomi enthalten den Namen des Bestellers. Ob und wie dieser Name im Shop erscheint, entscheiden Sie hier. Bedenken Sie dabei, dass der volle Klarname eines Kunden im öffentlich sichtbaren Shop steht – die gekürzte Schreibweise ist in der Praxis die gängigste Wahl.
| Einstellung | Bedeutung |
|---|---|
| Namen in Bewertungsansicht anzeigen | Bestimmt die Schreibweise des Namens bei jeder Bewertung. (Standard: voller Name)
|
| Bewertungen mit Anbieter-Logo markieren | Blendet bei jeder importierten Bewertung ein kleines eKomi-Logo ein und macht damit sichtbar, dass die Bewertung aus einer geprüften Erhebung stammt – ein Vertrauensgewinn gegenüber einer Bewertung ohne erkennbare Herkunft. Bewertungen, die direkt im Shop geschrieben wurden, bleiben ohne Logo. (Standard: Ja, Logo anzeigen) |
4.3 Die eKomi-Anbindung
| Einstellung | Bedeutung |
|---|---|
| Support für / Import von eKomi | Schaltet die Anbindung an eKomi ein. Ist sie eingeschaltet, ruft das Modul die Bewertungen mit den im Shop hinterlegten eKomi-Zugangsdaten ab. (Standard: Ja) Die Einstellung steuert außerdem, ob die Zustimmungslösung auf der Bestellabschlussseite eingeblendet wird (siehe Abschnitt 9). |
| eKomi-Token | Der Token für die Zustimmungslösung von eKomi. Nur wenn hier ein Token hinterlegt ist, wird das Zustimmungsfenster nach dem Bestellabschluss angezeigt. Den Token erhalten Sie von eKomi. (Standard: leer) |
| eKomi-Api-URL | Eine optionale Abruf-Adresse, die eine Bewertungsdatei liefert. Ist hier eine Adresse hinterlegt, wird diese verwendet und die Zugangsdaten aus der Shop-Anbindung bleiben unberücksichtigt. Tragen Sie hier nur eine Adresse ein, wenn Sie sie ausdrücklich von eKomi erhalten haben – in allen anderen Fällen lassen Sie das Feld leer. (Standard: leer) |
4.4 Betrieb
| Einstellung | Bedeutung |
|---|---|
| Letzter Cronjob | Zeigt an, wann der Import zuletzt gelaufen ist. Dieses Feld ist eine reine Anzeige. Es ist die schnellste Kontrolle, ob die zeitgesteuerte Aufgabe tatsächlich arbeitet: Steht hier ein Datum von vor mehreren Tagen, obwohl Sie einen täglichen Lauf eingerichtet haben, stimmt mit der Zeitsteuerung etwas nicht. |
5. So arbeitet der Bewertungsimport
Ein Importlauf besteht aus zwei Schritten, die Sie im Ergebnisprotokoll gut nachvollziehen können.
Schritt 1 – Bewertungen abholen. Das Modul holt die Bewertungsdatei bei eKomi ab. Jede Zeile darin enthält den Zeitpunkt der Bewertung, die Bestellnummer, die Artikelnummer, die Sternebewertung und den Bewertungstext. Diese Zeilen werden im Shop zwischengespeichert. Zeilen, die bereits aus einem früheren Lauf bekannt sind, werden erkannt und nicht doppelt verarbeitet – Sie können den Import also gefahrlos mehrfach starten.
Schritt 2 – Bewertungen im Shop anlegen. Aus den noch nicht übernommenen Zeilen entstehen echte Bewertungen im Bewertungssystem Ihres Shops. Dabei sucht das Modul zu jeder Zeile die zugehörige Bestellung und daraus den Kunden, dessen Name dann – gemäß Ihrer Einstellung aus Abschnitt 4.2 – bei der Bewertung erscheint. Der Bewertungstext wird in der Hauptsprache Ihres Shops abgelegt. Jede so entstandene Bewertung wird als Bewertung aus der eKomi-Erhebung gekennzeichnet und trägt damit das Herkunfts-Logo.
Nicht jede Zeile führt zu einer Bewertung. Übersprungen wird eine Zeile,
- wenn die genannte Bestellung im Shop nicht (mehr) vorhanden ist,
- wenn der bewertete Artikel im Shop nicht (mehr) vorhanden ist,
- wenn Bestell- oder Artikelnummer in der Datei fehlen.
Das Ergebnisprotokoll weist diese Fälle als „Übersprungen" aus. Ein paar übersprungene Zeilen sind normal, wenn Sie Artikel aus dem Sortiment genommen oder Altbestellungen gelöscht haben.
6. Den Import sofort starten
Für einen Lauf von Hand – etwa direkt nach der Einrichtung oder wenn Sie eine Bewertung vermissen – öffnen Sie im Menü „Xycons-Module" den Eintrag „eKomi Import ausführen" und klicken dort auf „Ausführen".
Nach dem Lauf erscheint direkt darunter das Ergebnis mit den Zählern des Laufs: wie viele Zeilen aus der Bewertungsdatei gelesen wurden, wie viele Bewertungen daraus neu entstanden sind, wie viele Zeilen übersprungen wurden und ob Fehler aufgetreten sind. Das ist die schnellste Antwort auf die Frage, ob die Anbindung sauber funktioniert.
7. Den Import regelmäßig laufen lassen
Damit neue Bewertungen ohne Ihr Zutun in den Shop wandern, richten Sie eine zeitgesteuerte Aufgabe ein. Sie finden sie im Backend unter „Toolbox" ► „Zeitgesteuerte Aufgaben" unter dem Namen „EKomi-Importer Cronjob". Dort aktivieren Sie die Aufgabe und wählen das gewünschte Intervall.
Damit die zeitgesteuerten Aufgaben Ihres Shops überhaupt anlaufen, muss auf dem Server ein regelmäßiger Aufruf des Shops eingerichtet sein. Ist bei Ihnen noch keine Zeitsteuerung in Betrieb, lassen Sie Ihren Hoster den folgenden Aufruf minütlich einrichten:
{IhreShopadresse}/shop.php?do=Cronjobs/Run
Der Shop entscheidet dann selbst, welche Aufgabe wann tatsächlich an der Reihe ist – der Bewertungsimport läuft also weiterhin nur in dem Takt, den Sie eingestellt haben.
8. Die Bewertungen im Shop
Übernommene Bewertungen erscheinen an denselben Stellen wie die Bewertungen, die Ihre Kunden direkt im Shop schreiben:
- in der Bewertungsübersicht auf der Artikeldetailseite,
- auf der Seite mit allen Bewertungen zu einem Artikel.
Bei jeder Bewertung aus der eKomi-Erhebung steht – sofern in Abschnitt 4.2 eingeschaltet – das Logo des Bewertungsdienstes. Der Name des Bewertenden erscheint in der Schreibweise, die Sie dort gewählt haben. Die Sternebewertung fließt in die Durchschnittsbewertung des Artikels ein, so wie es bei jeder anderen Bewertung auch der Fall ist.
Wie Bewertungen in Ihrem Shop dargestellt werden – etwa ob sie als eigener Reiter am Artikel erscheinen –, richtet sich nach den Bewertungseinstellungen Ihres Shops. Das Modul verändert diese Darstellung nicht, es füllt sie mit Inhalten.
9. Die Zustimmungslösung auf der Bestellabschlussseite
eKomi bietet eine Lösung an, mit der Ihre Kunden unmittelbar nach dem Bestellabschluss ihre Zustimmung zur Bewertungsanfrage geben können. Das erhöht die Rücklaufquote spürbar, weil die Frage im Moment der größten Aufmerksamkeit gestellt wird und nicht erst Tage später per E-Mail.
Zur Aktivierung tragen Sie im Setup unter „eKomi-Token" den Token ein, den Sie von eKomi erhalten haben, und lassen die eKomi-Unterstützung eingeschaltet. Das Zustimmungsfenster erscheint dann automatisch auf der Bestellabschlussseite und bezieht sich auf die soeben abgeschlossene Bestellung. Ohne Token bleibt die Bestellabschlussseite unverändert.
10. Modultexte ä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 zum Beispiel die Bezeichnungen im Setup oder die Meldungen, die Ihnen nach einem Importlauf angezeigt werden. Sie müssen dafür keine Datei anfassen, und Ihre Anpassungen bleiben bei einem Modulupdate erhalten.
11. Shopupdate und Modulpflege
Bevor Sie Ihren Shop auf eine neue Version aktualisieren, prüfen Sie bitte auf unserer Seite, ob das Modul für diese Shopversion freigegeben ist. Ein Modul passt sich nicht von selbst an eine neue Shopversion an – es greift an genau den Stellen in den Shop ein, die sich mit einem Update ändern können.
Installieren Sie beim Shopupdate immer auch die jeweils neueste Version des Moduls und der Modulumgebung. Es genügt nicht, allein den Shop zu aktualisieren: Modul und Modulumgebung gehören zusammen, und ein alter Stand einer der beiden Komponenten führt zu Fehlern, deren Ursache man erfahrungsgemäß an der falschen Stelle sucht.
Lassen Sie Ihr Shopupdate durch uns durchführen, aktualisieren wir Ihre Xycons-Module und die Modulumgebung selbstverständlich mit, sofern passende Versionen vorliegen.
12. Häufige Stolpersteine
Es werden keine Bewertungen importiert
Prüfen Sie der Reihe nach: Ist das Modul im Setup eingeschaltet? Ist die eKomi-Unterstützung eingeschaltet? Sind die eKomi-Zugangsdaten in Ihrem Shop hinterlegt? Starten Sie anschließend einen Import von Hand – das Ergebnisprotokoll benennt die Ursache im Klartext, etwa dass keine Zugangsdaten hinterlegt sind oder der Bewertungsdienst nicht erreichbar war.
Es werden viele Zeilen übersprungen
Das Modul legt nur Bewertungen zu Bestellungen und Artikeln an, die es in Ihrem Shop noch gibt. Wenn Sie Artikel gelöscht oder Altbestellungen entfernt haben, lassen sich die betroffenen Bewertungen nicht mehr zuordnen. Das ist kein Fehler, sondern der Schutz davor, Bewertungen an falscher Stelle einzuhängen.
Der Import läuft nicht von allein
Sehen Sie im Setup unter „Letzter Cronjob" nach. Steht dort ein altes Datum, ist entweder die zeitgesteuerte Aufgabe nicht aktiviert oder auf Ihrem Server läuft kein regelmäßiger Aufruf des Shops. Beides ist in Abschnitt 7 beschrieben.
Die Namen sollen anders erscheinen
Die Schreibweise der Namen wird bei jeder Anzeige neu gebildet, nicht beim Import festgeschrieben. Sie können die Einstellung aus Abschnitt 4.2 also jederzeit ändern – die Änderung wirkt sofort auf alle bereits importierten Bewertungen, ein erneuter Import ist dafür nicht nötig.
Das Zustimmungsfenster erscheint nicht
Es wird nur angezeigt, wenn das Modul eingeschaltet ist, die eKomi-Unterstützung aktiv ist und ein Token hinterlegt wurde. Fehlt eine dieser drei Voraussetzungen, bleibt die Bestellabschlussseite bewusst unverändert.
Eine Bewertung soll nicht im Shop stehen
Löschen Sie sie im Bewertungsbereich Ihres Shopbackends. Da jede Bewertung nur einmal übernommen wird, kommt sie durch einen späteren Importlauf nicht zurück.
Wir wünschen Ihnen viel Erfolg beim Einsatz des Moduls!
