Skip to main content

​
Zwei Wege zur Empfehlung

Das Plugin kann Empfehlungen von Luigi’s Box auf zwei Arten ausspielen. Der Unterschied ist wichtig, weil er bestimmt, wie die Empfehlungen aussehen und wer sie trackt.

Nativer Slider (Recommender-API)

Das Plugin holt die Empfehlungen serverseitig bei Luigi’s Box ab und rendert sie im Produktslider deines Templates. Sie sehen aus wie der Rest deines Shops, weil sie dein Template benutzen.

recco.js Widget

Luigi’s Box lädt die Empfehlungen im Browser nach und rendert sie selbst. Schnell eingebunden, Optik kommt von Luigi’s Box.
Im Modus Nativer Slider meldet das Plugin Views und Klicks der Empfehlungen aktuell noch nicht an die Luigi’s Box Analytics zurück. Das recco.js Widget trackt sich selbst. Wenn dir die Auswertung der Empfehlungen wichtig ist, nimm vorerst das Widget.

​
Wo die Empfehlungen erscheinen

Auch hier gibt es zwei Wege, und du kannst beide gleichzeitig nutzen.

​
Per OPC-Portlet platzieren

Im OPC-Editor findest du unter der Gruppe Luigi’s Box das Portlet Luigi’s Box Empfehlungen. Zieh es an die Stelle, an der die Empfehlungen erscheinen sollen. Auf Produktseiten gibt das Portlet den Artikelkontext automatisch mit. Nimm diesen Weg, wenn du die Position genau steuern willst.

​
Automatisch je Seitentyp

Unter Empfehlungen im Plugin-Backend legst du Platzierungen an, die global greifen - ohne dass du jede Seite im OPC anfassen musst. Nimm diesen Weg, wenn die Empfehlungen überall gleich erscheinen sollen.

​
Eine Platzierung einrichten

Jede Platzierung hat die folgenden Felder:

​
Gängige Recommender-Typen

Welche Modelle in deinem Konto verfügbar sind, siehst du in der Luigi’s Box Oberfläche. Das Feld ist bewusst frei, damit du auch neue Modelle nutzen kannst, ohne auf ein Plugin-Update zu warten.

​
Artikelkontext

Auf Produktseiten gibt das Plugin automatisch den aktuellen Artikel als Kontext mit. Im Warenkorb übergibt es die enthaltenen Positionen, maximal zehn. Auf Startseite und Kategorieseite gibt es keinen Artikelkontext - nimm dort Modelle wie trends oder bestsellers, die keinen brauchen.

​
Den richtigen Selektor finden

Der Selektor entscheidet, wo die Empfehlungen landen. Öffne die Seite im Browser, klick mit der rechten Maustaste auf das Element, unter oder über dem die Empfehlungen erscheinen sollen, und wähle Untersuchen. Nimm eine stabile Klasse oder eine ID.
Nimm keinen Selektor, der nur aus generierten Klassen besteht - die ändern sich beim nächsten Template-Update. Ein Container mit sprechendem Namen hält länger.

​
Wenn nichts erscheint

Häng den Parameter ?lbdebug=1 an die URL der Seite. Das Plugin schreibt dann die komplette Kette ins Plugin-Log: welche Konfiguration gegriffen hat, welcher Feed und welche Tracker-ID benutzt wurden, was an Luigi’s Box rausging, was zurückkam, wie die Treffer auf deine Artikel gemappt wurden und welche Artikel am Ende geladen werden konnten. Der Cache wird dabei übergangen. Das Log findest du im Plugin-Backend unter Ereignisprotokoll, Kanal recommender. Die häufigsten Ursachen:
Die Zuordnung läuft über die Artikelnummer. Prüfe, ob die Artikelnummern in Luigi’s Box mit denen in deinem Shop übereinstimmen - meist fehlt ein abgeschlossener Produkt-Sync.
Entweder kennt das Modell den übergebenen Artikel noch nicht, oder der Recommender-Typ existiert in deinem Konto nicht. Beides siehst du in der Antwort im Debug-Log.
Selektor und Einfügemethode prüfen. Bei mehreren passenden Elementen greift das erste.
Die Empfehlungen werden 10 Minuten zwischengespeichert. Mit ?lbdebug=1 umgehst du den Cache.