Empfehlungs-Widgets auf der Website
Ein Widget ist ein fertiger Produktblock auf der Website: „Das könnte Ihnen gefallen“ auf der Startseite, „Zusammen gekauft“ auf der Produktseite, „Zuletzt angesehen“ im Warenkorb. Sie richten es in OneTrace.pro ein und fügen einmalig einen kurzen Code in die Website ein. Danach ändern Sie Art, Gestaltung, Anzeigeregeln und Aktivierung, ohne die Website anzupassen.
Voraussetzungen sind ein installierter Tracker (Website anbinden), ein Produktkatalog sowie Ereignisse zu Produktaufrufen, Warenkorb und Käufen (Empfehlungen und Produktkatalog). Widgets erstellen und ändern können „Inhaber“, „Administrator“ und „Manager“; alle anderen sehen Einstellungen und Statistik, können aber nicht speichern.
Widget-Liste
Öffnen Sie Website → Widgets. Die Karte jedes Widgets zeigt den Status, die Statistik der letzten 30 Tage, den Vergleich der Varianten, sofern vorhanden, und den Code für die Website.

Der Schalter Auf der Website anzeigen schaltet das Widget ab, ohne die Website zu ändern: Der Status wechselt zu „Pausiert“, der Block auf der Seite wird geleert. Schalten Sie es wieder ein, kehren die Produkte zurück. Die Schaltfläche mit dem Papierkorb löscht das Widget vollständig.
Um ein Widget anzulegen, klicken Sie auf Widget erstellen. Um es zu ändern, klicken Sie auf seinen Namen oder die Schaltfläche mit dem Stift. Beides öffnet die Editor-Seite.
Widget-Editor
Links stehen die Einstellungen in vier Bereichen: Produkte, Aussehen, Anzeige und Varianten. Rechts ist die Vorschau: Sie stellt das Widget genauso dar wie auf der Website, mit echten Produkten aus Ihrem Katalog. Enthält ein Bereich einen Fehler, erscheint neben seinem Namen eine Markierung. Klicken Sie auf Speichern – die Änderungen sind beim nächsten Laden der Seite auf der Website sichtbar, den Code müssen Sie nicht ändern. Verlassen Sie die Seite mit ungespeicherten Änderungen, warnt Sie der Browser.

Der Umschalter Desktop / Smartphone über der Vorschau zeigt beide Layouts. Auf der Website passt sich das Layout an die Breite des verfügbaren Platzes an, nicht an die Bildschirmbreite: In einer schmalen Spalte sieht das Widget genauso aus wie auf dem Smartphone. Schriftart und Textfarbe übernimmt das Widget von der Website, sofern Sie keine eigenen festlegen.
Produkte
| Feld | Was es festlegt |
|---|---|
| Name | Name des Widgets; nur im Admin-Bereich sichtbar |
| Was angezeigt wird | Art der Empfehlungen: Persönlich, Beliebt, Im Trend, Zusammen angesehen, Zusammen gekauft, Ähnlich, Zuletzt angesehen, Zeit nachzukaufen |
| Kategorie | für Beliebt und Im Trend: Kategorie-ID aus dem Katalog; leer – gesamter Katalog |
| Produkte insgesamt | von 1 bis 24 |
| Produkt für die Vorschau | für „Zusammen angesehen“, „Zusammen gekauft“ und „Ähnlich“: ID des Produkts, für das die Vorschau erstellt wird; leer – das erste verfügbare Produkt |
Gibt es keine passenden Produkte, zeigt die Vorschau graue Platzhalter, damit Sie die Gestaltung beurteilen können.
Aussehen
| Feld | Was es festlegt |
|---|---|
| Überschrift | Text über den Produkten, zum Beispiel „Das könnte Ihnen gefallen“ |
| Schaltfläche | Text der Schaltfläche in der Karte, zum Beispiel „Details“; leer – ohne Schaltfläche |
| Anordnung | Raster oder Karussell mit Scrollen |
| Karten pro Reihe | von 1 bis 8 |
| Preis anzeigen | Preis in der Karte |
| Fertige Stile | „Wie auf der Website“, „Karten“, „Minimalistisch“, „Kontrast“ – füllen die Gestaltungsfelder aus, die Sie danach weiter anpassen können |
| Was die Karte zeigt | Marke, alter Preis, Rabatt-Badge, Rahmen und Schatten der Karte |
| Bildproportionen und Bild | 1:1, 3:4 oder 4:3; Bild vollständig oder füllt die Fläche mit beschnittenen Rändern |
| Farben | Akzent, Kartenhintergrund, Bildhintergrund, Text, Preis, Schaltfläche und Schaltflächentext; ohne Farbe – wie auf der Website, der Bildhintergrund ist dann weiß |
| Textgröße, Größe der Überschrift, Überschrift | Größen in Prozent der Website-Schrift und Ausrichtung der Überschrift |
| Eckenradius, Abstand zwischen Karten, Innenabstand der Karte | in Pixeln |
| Karussell-Pfeile | Scroll-Schaltflächen an den Rändern des Karussells |
| Smartphone | Karten pro Reihe auf schmalen Bildschirmen (von 1 bis 3) und ein eigenes Layout, etwa Karussell statt Raster |
| Eigenes CSS | Regeln für die Klassen des Widgets: .cdp-rec__name, .cdp-rec__price, .cdp-rec__button und weitere |
Eigenes CSS wirkt nur innerhalb dieses Widgets und ändert den Rest der Seite nicht. Externe Ressourcen lassen sich darin nicht laden: @import, url() und ähnliche Konstrukte werden beim Speichern abgelehnt.
Hat das Projekt mehrere Sprachen, erscheint über der Überschrift der Umschalter Sprache der Texte. In der Standardsprache füllen Sie Überschrift und Schaltfläche aus, in den anderen Sprachen deren Übersetzungen; ein leeres Feld zeigt den Text der Standardsprache. Besucher sehen Überschrift und Schaltfläche in ihrer Sprache, also der, die der Tracker an das Profil übermittelt (Sprache der Kunden); ohne Übersetzung in der Standardsprache. Preise erscheinen im Format der Sprache des Besuchers.
Stil aus einem Bild
Die Schaltfläche Stil aus einem Bild im Bereich Aussehen übernimmt die Gestaltung aus einem Screenshot mit Produktkarten – von Ihrer Website oder einer Website, die Ihnen gefällt.
- Klicken Sie auf Stil aus einem Bild.
- Ziehen Sie ein Bild hinein, fügen Sie es aus der Zwischenablage ein (Strg+V) oder wählen Sie eine Datei: PNG, JPEG oder WebP bis 3 MB.
- Hat das Widget Varianten, wählen Sie, auf welche der Stil angewendet wird.
- Klicken Sie auf Stil übernehmen.
Die KI füllt Farben, Größen, Eckenradien, Anordnung und den Inhalt der Karte aus und ergänzt, was die Einstellungen nicht abbilden, unter Eigenes CSS. Jeder Wert wird genauso geprüft wie bei manueller Eingabe, unpassende werden verworfen. Das Ergebnis ist ein Entwurf: Prüfen Sie die Vorschau und speichern Sie oder klicken Sie auf Rückgängig machen.

Das Bild wird nicht gespeichert. Die Auswahl wird nach tatsächlichem Verbrauch vom Projektguthaben bezahlt; reicht das Guthaben nicht oder ist KI nicht im Tarif enthalten, ist die Schaltfläche nicht verfügbar, und darunter steht der Grund.
Anzeige

| Feld | Was es festlegt |
|---|---|
| Auf der Website anzeigen | Aktivierung des Widgets, wie in der Liste |
| Nur auf Seiten und Außer auf Seiten | Seitenadressen ohne Domain, eine pro Zeile; * steht für beliebige Zeichen, zum Beispiel /catalog/*. Leer – auf allen Seiten |
| Geräte | alle, nur Computer oder nur Smartphones |
| Besucher | alle, nur neue oder nur wiederkehrende |
| Nur Mitgliedern von Segmenten und Außer Mitgliedern von Segmenten | Segmente des Besuchers; die Mitgliedschaft wird bei jeder Anzeige anhand des Profils geprüft |
Die Regeln prüft der Server bei jedem Laden des Widgets. Greifen sie nicht, bleibt der Platz auf der Seite leer, und das Layout bricht nicht. Es sind dieselben Regeln wie bei Anmeldeformularen.
Hier finden Sie auch den Code für die Website, mehr dazu weiter unten.
Varianten
Mit Varianten prüfen Sie, welche Überschrift, welche Art von Empfehlungen oder welche Gestaltung mehr Klicks und Käufe bringt. Die Haupteinstellungen des Widgets sind Variante A. Mit Variante hinzufügen legen Sie bis zu drei weitere Varianten an: B, C und D. In jeder können Sie ändern:
- die Art der Empfehlungen – Was angezeigt wird;
- Überschrift und Schaltfläche mit Übersetzungen;
- Anordnung und die gesamte Gestaltung.
Leere Felder werden von Variante A übernommen.

Die Besucher werden zu gleichen Teilen auf die Varianten verteilt, und jeder Besucher sieht immer dieselbe Variante. Der Umschalter über der Vorschau zeigt die gewählte Variante. Die Ergebnisse des Vergleichs finden Sie in der Statistik unter dem Editor.
Auf Ihrer Website ansehen
Die Schaltfläche Auf Ihrer Website ansehen über der Vorschau öffnet eine Seite Ihrer Website mit dem Widget im gespeicherten Zustand. Geben Sie die Adresse der Seite an, auf der der Code des Widgets eingefügt ist, wählen Sie die Variante und klicken Sie auf Öffnen.
So ist das Widget sichtbar, auch wenn es ausgeschaltet ist oder die Seite nicht unter die Anzeigeregeln fällt. Impressionen und Klicks in diesem Modus fließen nicht in die Statistik ein. Der Link gilt 24 Stunden; solange der Tab geöffnet ist, bleibt der Ansichtsmodus auch beim Wechsel zwischen Seiten Ihrer Website erhalten. Ungespeicherte Änderungen sind auf der Website nicht sichtbar – speichern Sie zuerst.
Code für die Website
Den Code des Widgets finden Sie in seiner Karte in der Liste und im Bereich Anzeige des Editors. Fügen Sie ihn in die Seitenvorlage dort ein, wo der Block erscheinen soll:
<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>
Attribute:
data-item– ID des Produkts der Seite oder der Produkte im Warenkorb, durch Komma getrennt:data-item="SKU-1,SKU-7". Pflicht für die Arten „Zusammen angesehen“, „Zusammen gekauft“ und „Ähnlich“ – setzen Sie es aus der Seitenvorlage ein.data-category– Kategorie-ID für beliebte Produkte, wenn auf verschiedenen Seiten unterschiedliche Kategorien gebraucht werden.data-exclude– durch Komma getrennte IDs von Produkten, die nicht angezeigt werden sollen, etwa solche, die bereits im Warenkorb liegen.
Persönliche und zuletzt angesehene Produkte werden anhand des Besuchers ausgewählt, dafür ist data-item nicht nötig.
Gibt es keine passenden Produkte, bleibt der Platz auf der Seite leer – das Layout bricht nicht.
Statistik
Unter dem Editor steht die Statistik des Widgets für 7, 30 oder 90 Tage: Summen, ein Diagramm nach Tagen und der Vergleich der Varianten. Wählen Sie über dem Diagramm die Kennzahl: Impressionen, Klicks, CTR oder Umsatz. Hat das Widget Varianten, hat jede im Diagramm ihre eigene Linie.

| Kennzahl | Wie sie berechnet wird |
|---|---|
| Impressionen | das Widget war mindestens zur Hälfte im Sichtbereich des Besuchers. Ein Seitenaufruf ohne Scrollen bis zum Block zählt nicht, daher ist die CTR eines Widgets unten auf der Seite aussagekräftig |
| Klicks | Klicks auf Produktkarten |
| CTR | Klicks geteilt durch Impressionen |
| Käufe | Käufe des Produkts durch denselben Kunden innerhalb von 7 Tagen nach einem Klick darauf; im Diagramm am Tag des ersten Klicks |
| Umsatz | Summe dieser Käufe |
Die Tage werden in UTC gezählt. Impressionen und Klicks bei der Ansicht auf Ihrer Website werden nicht berücksichtigt.
Die Variantentabelle zeigt Impressionen, Klicks, CTR, Käufe und Umsatz jeder Variante. Darunter steht ein Fazit zu Klicks und zu Käufen pro Impression: welche Variante besser ist und ob die Daten schon ausreichen, um sich darauf zu verlassen. Solange es wenige Daten gibt, sagt das Fazit genau das – warten Sie dann ab, statt eine Variante nach einem zufälligen Unterschied zu wählen.
Die Gesamtwirkung der Empfehlungen auf der Website nach Art finden Sie im Bereich Empfehlungen.
Single-Page-Websites
Der Tracker findet Widgets selbst nach dem Laden der Seite, beim Erscheinen neuer Elemente und bei einer Änderung von data-item. Auf Websites mit React, Vue und Ähnlichem genügt es daher, das Attribut zu ändern – der Block wird neu gezeichnet.
Müssen die Produkte ohne Änderung der Attribute aktualisiert werden, etwa nach einer Änderung des Warenkorbs, rufen Sie Folgendes auf:
cdp.widgets({ force: true });
Eigener Code statt Widget
Entwickler können einen Empfehlungsblock direkt aus dem Code ausgeben, ohne Einrichtung im Admin-Bereich:
window.addEventListener('load', () => {
cdp.renderRecommendations('#recs', {
type: 'viewed_with', item: 'SKU-1', title: 'Zusammen angesehen', layout: 'carousel', columns: 4,
});
});
Der Block sieht genauso aus wie ein Widget, Impressionen und Klicks werden automatisch erfasst. Sie können ihn schon vor dem Laden des Trackers aufrufen: Der Aufruf wartet in der Warteschlange. Das Element muss bereits auf der Seite sein, deshalb wartet das Beispiel auf das Ereignis load. Ein leeres Ergebnis leert das Element. Die Gestaltung wird mit denselben Optionen wie bei Widgets aus dem Admin-Bereich festgelegt, zum Beispiel imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb'; imageBackground ist eine Farbe oder transparent. Anzeigeregeln und Varianten gibt es nur bei Widgets aus dem Admin-Bereich.