> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/display-elemente-und-suchhinweise.md).

# Display-Elemente und Suchhinweise

Bild-Banner in Erlebniswelten und Hinweise in der Suche (In-App-Käufe)

Beide Funktionen sind In-App-Käufe. Ob sie in deinem Shop schon freigeschaltet sind, zeigt dir der Assistent im ersten Schritt. Nach dem Kauf richtest du sie direkt dort oder im Editor ein.

### Display-Elemente

Ein Display-Element zeigt Bilder deiner Aktion in einer Erlebniswelt, zum Beispiel ein großes Aktionsbild auf der Startseite. Es läuft im Zeitraum der Aktion und verschwindet danach von selbst.

Für Desktop und Mobil hinterlegst du jeweils eigene Bilder. Unterhalb der Umbruchgrenze (Standard 768 Pixel) zeigt der Shop die Mobil-Bilder. Hast du kein Mobil-Bild hinterlegt, erscheint auf Smartphones das Desktop-Bild (siehe [Ohne Mobil-Bild](#ohne-mobil-bild)).

**So kommt das Display-Element in den Shop:**

1. Im Tab **Display-Elemente** „Display-Element aktivieren“ einschalten, Desktop-Bilder und bei Bedarf Mobil-Bilder hinzufügen und speichern.
2. Unter **Inhalte → Erlebniswelten** das gewünschte Layout öffnen.
3. In der rechten Seitenleiste **Blöcke** öffnen, unter „Block-Kategorie“ **Marketing-Aktionen** wählen und den Block **CogiDisplay-Element** an die gewünschte Stelle ziehen.

| Einstellung     | Bedeutung                                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| Darstellung     | Untereinander: alle Bilder der laufenden Aktion. Slider: die Bilder wechseln sich ab                         |
| Tags            | Optional: Ein Display-Element in der Erlebniswelt zeigt dann nur Aktionen mit diesem Tag, z. B. „Startseite“ |
| Sprache je Bild | Optional: Das Bild erscheint nur in der gewählten Storefront-Sprache                                         |

{% hint style="info" %}
Mit Tags spielst du verschiedene Aktionen an verschiedenen Stellen aus, zum Beispiel einen Herbst-Sale auf der Startseite und eine Marken-Aktion auf einer Landingpage.
{% endhint %}

### Mehrere Display-Elemente in einer Aktion

Eine Aktion kann mehrere Display-Elemente haben. Für einen Zeitraum, etwa die Black Week, legst du so nur **eine** Aktion an und hinterlegst darin alle Bilder für die verschiedenen Stellen im Shop: eines für die Startseite, eines für die Seitenleiste der Kategorieseiten, eines für eine Landingpage.

**So legst du ein weiteres Display-Element an:**

1. Klicke im Tab **Display-Elemente** deiner Aktion unter der letzten Karte auf **Weiteres Display-Element hinzufügen**.
2. Gib dem neuen Display-Element einen **Name**, zum Beispiel „Seitenleiste“. Der Name erscheint nur in der Verwaltung und hilft dir, die Karten auseinanderzuhalten.
3. Vergib ein **Tag** und hinterlege die Bilder. Jedes Display-Element hat eigene Tags, eigene Bilder, eine eigene Link-Einstellung und lässt sich einzeln aktivieren.
4. Speichere die Aktion.

Welches Display-Element wo erscheint, entscheiden die Tags:

| Element in der Erlebniswelt | Was es von einer Aktion zeigt                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| mit Tag                     | alle aktiven Display-Elemente der Aktion, die eines der gewählten Tags tragen              |
| ohne Tag                    | das erste aktive Display-Element der Aktion ohne Tag; tragen alle ein Tag, das erste davon |

Mit **Nach oben** und **Nach unten** legst du die Reihenfolge fest. Sie bestimmt, welches Display-Element ein Element ohne Tag zeigt, und in welcher Reihenfolge mehrere passende Display-Elemente untereinander oder im Slider stehen. **Display-Element entfernen** löscht eine Karte samt ihren Bildern, eine Aktion behält immer mindestens ein Display-Element.

Jedes Display-Element hat seine eigene Umbruchgrenze. Stehen mehrere untereinander, wechselt jedes an seiner eigenen Grenze zu den Mobil-Bildern. Im Slider gilt die Grenze des ersten Display-Elements für alle Slides.

Die Statistik im cogi Commander zählt Aufrufe und Klicks für jedes Display-Element einzeln.

{% hint style="info" %}
Bestehende Aktionen ändern sich durch das Update nicht: Ihr bisheriges Display-Element ist einfach das erste in der Liste.
{% endhint %}

### Werbung in der Seitenleiste von Kategorieseiten

Auf Kategorieseiten mit Seitenleiste ist unter der Kategorie-Navigation Platz für Werbung, zum Beispiel für eine Aktion, eine andere Kategorie oder deine Beratung. Dafür brauchst du nur das Display-Element und ein Tag.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-4e55d265bbb88af44ea280b5c483661819d63a56%2Fmarketing-aktionen-sf-seitenleiste.png?alt=media" alt="Kategorieseite mit zwei Anzeigen unter der Kategorie-Navigation"><figcaption><p>Zwei Aktionen untereinander in der Seitenleiste, nur auf dem Desktop</p></figcaption></figure>

**So richtest du es ein:**

1. Lege eine Marketing-Aktion an oder nimm eine laufende und füge dort ein weiteres Display-Element hinzu. Im Tab **Display-Elemente** aktivierst du das Display-Element, vergibst das Tag **Seitenleiste** und lädst nur ein **Desktop-Bild** im Hochformat hoch (zum Beispiel 600 × 800 Pixel). Unter **Link-URL** trägst du ein, wohin die Anzeige führt.
2. Öffne unter **Inhalte → Erlebniswelten** das Layout deiner Kategorieseiten mit Seitenleiste. Ist es gesperrt (Shopware-Standardlayouts), dupliziere es zuerst.
3. Ziehe den Block **CogiDisplay-Element** aus der Block-Kategorie **Marketing-Aktionen** in die Seitenleiste, direkt unter die Kategorie-Navigation.
4. Wähle im Element bei **Tags** „Seitenleiste“ und bei **Darstellung** „Untereinander“.
5. Blende den Block in den Block-Einstellungen unter **Sichtbarkeit** für **Mobil** aus. Auf dem Smartphone stünde die Anzeige sonst zwischen Navigation und Produkten.
6. Weise das Layout unter **Kataloge → Kategorien** im Tab **Layout** den gewünschten Kategorien zu.

Laufen mehrere Aktionen mit dem Tag gleichzeitig, stehen ihre Bilder untereinander, die neueste oben. Endet eine Aktion, verschwindet ihre Anzeige von selbst.

{% hint style="warning" %}
Ein Display-Element **ohne** Tag zeigt die Bilder aller laufenden Aktionen, also auch deine Seitenleisten-Werbung. Gib deinen übrigen Display-Elementen deshalb ebenfalls ein Tag, zum Beispiel „Startseite“.
{% endhint %}

### Ohne Mobil-Bild

Hast du für ein Display-Element kein Mobil-Bild hinterlegt, zeigt es auf Smartphones das Desktop-Bild. Ein eigenes Mobil-Bild hat immer Vorrang.

Soll das Display-Element auf Smartphones leer bleiben, etwa bei Werbung nur für große Bildschirme, schalte in seiner Karte **Ohne Mobil-Bild das Desktop-Bild auf Smartphones zeigen** aus. Unter **Mobil-Bilder** steht jeweils, was auf Smartphones gerade passiert.

{% hint style="info" %}
Display-Elemente, die vor Version 1.8.6 angelegt wurden, bleiben nach dem Update wie gewohnt auf Smartphones leer, solange kein Mobil-Bild hinterlegt ist. Möchtest du dort das Desktop-Bild zeigen, schalte den Schalter ein und speichere.
{% endhint %}

### Suchhinweise (InsightSearch)

Der Suchhinweis zeigt einen Banner in den Suchvorschlägen deiner Suche. Er setzt das Plugin [Suche - Intelligent und KI Optimiert](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert.md) voraus.

| Einstellung     | Möglichkeiten                                                             |
| --------------- | ------------------------------------------------------------------------- |
| Banner-Position | Im Ergebnisbereich oder ganz oben über der Suche                          |
| Inhalt          | Text mit Rabattcode, Link und optionalem Button                           |
| Design          | Text-, Hintergrund- und Button-Farben, Innenabstand, Blinkgeschwindigkeit |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/display-elemente-und-suchhinweise.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
