> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.
# Empfehlungen
> Produktempfehlungen von Luigi's Box im Shop platzieren - nativer Slider oder Widget
## 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.
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.
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:
| Feld | Bedeutung |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Aktiv** | Schaltet die Platzierung ein oder aus, ohne sie zu löschen |
| **Modus** | `Nativer Slider (Recommender-API)` oder `recco.js Widget` |
| **Seitentyp** | Produktseite, Warenkorb, Startseite oder Kategorieseite |
| **Recommender-Typ** | Das Modell bei Luigi's Box, das die Empfehlungen liefert. Freies Feld - die gängigen Modelle stehen als Vorschlag bereit |
| **Anzahl** | Wie viele Produkte angezeigt werden |
| **Titel** | Überschrift über dem Slider |
| **Selektor** | CSS-Selektor des Elements, an dem die Empfehlungen eingefügt werden |
| **Einfügemethode** | Wie relativ zum Selektor eingefügt wird: anhängen, voranstellen, davor, danach oder ersetzen |
### Gängige Recommender-Typen
| Typ | Wofür |
| -------------------------- | ------------------------------------------------------ |
| `item_detail_alternatives` | Alternativen auf der Produktdetailseite |
| `item_detail_complements` | Passendes Zubehör auf der Produktdetailseite |
| `basket` | Empfehlungen im Warenkorb |
| `basket_popup` | Empfehlungen im Warenkorb-Popup |
| `trends` | Aktuelle Trends, gut für die Startseite |
| `bestsellers` | Bestseller, gut für die Startseite und Kategorieseiten |
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.