OneTrace.pro Hilfe

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.

Seite „Empfehlungs-Widgets“: Widget-Liste mit Statistik und 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.

Widget-Editor: Bereich „Produkte“ und Vorschau

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.

  1. Klicken Sie auf Stil aus einem Bild.
  2. 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.
  3. Hat das Widget Varianten, wählen Sie, auf welche der Stil angewendet wird.
  4. 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.

Stil aus einem Screenshot

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

Bereich „Anzeige“: Regeln, Aktivierung und Code für die Website

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.

Bereich „Varianten“: Variante B mit anderer Überschrift und Gestaltung

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.

Widget-Statistik: Summen, Diagramm nach Tagen und Vergleich der Varianten

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.