> 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/banner.md).

# Banner

Leiste im Kopfbereich mit Rabattcode, Countdown und Klick-Aktion

Der Banner ist eine Leiste über dem Kopfbereich deines Shops. Er eignet sich für Rabatte mit Countdown, Versandhinweise oder Vorteile wie „30 Tage Rückgabe“.

<div><figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-36bbc6fc78bb184154c0a2b56ce2c4006e2ecace%2Fmarketing-aktionen-sf-banner.png?alt=media" alt="Banner im Shop"><figcaption><p>Text-Banner mit kopierbarem Rabattcode und Countdown</p></figcaption></figure> <figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-0ee07f699447dc06bcd1162368f2f02f8345a2fa%2Fmarketing-aktionen-sf-mobile.png?alt=media" alt="Banner auf dem Smartphone"><figcaption><p>Derselbe Banner mobil</p></figcaption></figure></div>

### Wo der Banner erscheint

Im Tab **Banner** legst du in der Karte **Ausspielung** den Banner-Modus fest:

| Banner-Modus | Wo er erscheint                                                                    | Targeting nötig |
| ------------ | ---------------------------------------------------------------------------------- | --------------- |
| Global       | Auf allen Seiten. Überschreibt alle Default- und Fallback-Banner                   | nein            |
| Default      | Nur bei den gewählten Kategorien, Produkten, Produktgruppen oder Herstellern       | ja              |
| Fallback     | Nur dort, wo kein Global-Banner aktiv ist und kein passendes Default-Banner greift | nein            |

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-2eb85094a74958c9250c5653047843a776d36262%2Fmarketing-aktionen-admin-banner-playout.png?alt=media" alt="Karte Ausspielung mit Banner-Modus und Priorität"><figcaption></figcaption></figure>

Gelten mehrere Banner desselben Modus gleichzeitig, entscheidet die **Priorität**: Die höhere Zahl gewinnt. Ob sich gleichzeitig gültige Banner abwechseln, stellst du in den [Grundeinstellungen](https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/einrichtung.md#grundeinstellungen) ein.

{% hint style="info" %}
Für den Anfang reicht fast immer „Global“: Banner aktivieren, Inhalt eintragen, speichern. Der Banner erscheint sofort auf allen Seiten, solange die Aktion läuft.
{% endhint %}

### Inhalt

In der Karte **Inhalt** wählst du die Darstellung:

* **Text-Banner** – eine Zeile Text über die ganze Breite, optional mit Button.
* **Kachel-Leiste** – mehrere kurze Kacheln nebeneinander, jede mit Icon, Text und eigenem Link. Ideal für Vorteile wie „Gratis Versand“ oder „Sicher zahlen“.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-2013a2c9fb39b1594b260b407f3547ec16be7d90%2Fmarketing-aktionen-sf-tiles.png?alt=media" alt="Kachel-Leiste mit vier Vorteilen im Kopfbereich"><figcaption><p>Kachel-Leiste, gleichmäßig verteilt (Demo-Shop cogi-suite.de)</p></figcaption></figure>

Für die Kachel-Leiste stellst du zusätzlich ein, wie die Kacheln stehen:

| Einstellung             | Möglichkeiten                                                                                                                                                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Ausrichtung der Kacheln | **Gleichmäßig verteilt** (Standard): jede Kachel bekommt eine gleich breite Spalte, die Trennstriche sitzen gleichmäßig. **Kompakt in der Mitte**: die Kacheln stehen als Gruppe mittig. **Linksbündig**: die Kacheln beginnen links |
| Auf dem Handy           | **Wischen** (Standard): die Kacheln stehen in einer Reihe, die Besucher seitlich wischen. **Automatisch durchlaufen**: eine Kachel nach der anderen, mittig, Wechsel alle 4 Sekunden                                                 |

{% hint style="info" %}
Wer auf seinem Gerät reduzierte Bewegung eingestellt hat, bekommt auch bei „Automatisch durchlaufen“ die Wisch-Reihe. Fährt jemand mit der Maus über die Leiste oder springt mit der Tastatur hinein, hält das Durchlaufen an.
{% endhint %}

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-4cf233c4346c9c71f795b4b36c79f12cc9f56aa8%2Fmarketing-aktionen-admin-banner-content.png?alt=media" alt="Inhalt des Banners mit Platzhaltern, Rabattcode und Countdown-Einstellung"><figcaption></figcaption></figure>

Im Text-Banner setzt du Platzhalter ein, die der Shop beim Anzeigen füllt:

| Platzhalter         | Wird im Shop zu                                                     |
| ------------------- | ------------------------------------------------------------------- |
| `%discountCode%`    | dem Rabattcode aus dem Feld darunter, per Klick kopierbar           |
| `%expiryCountdown%` | einem laufenden Countdown, als Text oder als Kästchen (siehe unten) |
| `%expiryDate%`      | dem Enddatum der Aktion mit Uhrzeit, z. B. 30.11.2026, 23:59        |
| `%d%`               | nur den Tagen des Countdowns, z. B. 8                               |
| `%h%`               | nur den Stunden ohne volle Tage, zweistellig, z. B. 08              |
| `%ht%`              | allen verbleibenden Stunden zusammen, z. B. 200                     |
| `%m%`               | nur den Minuten, zweistellig, z. B. 05                              |
| `%s%`               | nur den Sekunden, zweistellig, z. B. 40                             |
| `%url%`             | dem Link aus dem Klick-Verhalten                                    |
| `%b%…%b%`           | blinkendem Text zwischen den beiden Markierungen                    |

Die einzelnen Einheiten `%d%`, `%h%`, `%ht%`, `%m%` und `%s%` brauchst du nur für eigene Gestaltungen, etwa „Noch %ht% Stunden“. Die Liste aller Platzhalter steht auch im Admin direkt unter dem Texteditor.

#### Countdown

Unter **Countdown läuft bis** wählst du, worauf der Countdown zählt:

| Einstellung                                        | Typischer Einsatz                                                                                             |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Ende der Aktion                                    | Black Friday, Wochenend-Sale: zählt bis „Gültig bis“                                                          |
| Jeden Tag bis Ende des Zeitfensters (Tagesangebot) | Tagesangebot bis 23 Uhr: zählt jeden Tag bis zur Uhrzeit „bis“ im Zeitfenster und startet am nächsten Tag neu |

{% hint style="info" %}
Für ein Tagesangebot stellst du im Tab **Allgemein** das Zeitfenster ein, zum Beispiel „Uhrzeit bis 23:00“. Der Startpunkt „Tagesangebot bis 23 Uhr“ im Assistenten erledigt beides für dich.
{% endhint %}

#### Countdown-Darstellung

Unter **Countdown-Darstellung** legst du fest, wie `%expiryCountdown%` aussieht:

| Einstellung  | Im Shop                                                                   |
| ------------ | ------------------------------------------------------------------------- |
| Als Text     | „2 Tage 13:05:42“                                                         |
| Als Kästchen | Tage, Stunden, Minuten und Sekunden je in einem Kästchen mit Beschriftung |

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-f100570f822753aee53f6416d71d133b64e932b5%2Fmarketing-aktionen-sf-countdown-boxes.png?alt=media" alt="Banner mit Countdown in Kästchen"><figcaption><p>Countdown als Kästchen – unter einem Tag entfällt das Tageskästchen</p></figcaption></figure>

Die Kästchen übernehmen die Textfarbe des Banners, die Zahlen seine Hintergrundfarbe – auf einer dunklen Leiste also helle Kästchen mit dunklen Zahlen. Unter **Design** kannst du beide Farben auch eigens setzen. Der Startpunkt „Countdown mit Kästchen“ im Assistenten richtet eine dunkle Leiste mit Kästchen-Countdown für dich ein.

#### Klick-Verhalten

| Klick-Aktion                      | Was passiert                                                                                              |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Link öffnen                       | Öffnet die eingetragene URL, optional in einem neuen Tab. Trag die vollständige Adresse mit https\:// ein |
| Popup mit eigenem Inhalt öffnen   | Zeigt einen eigenen Text in einem Fenster                                                                 |
| Popup der Marketing-Aktion öffnen | Öffnet das Popup aus dem Tab „Popup“ dieser Aktion                                                        |

### Design & Verhalten

In der Karte **Design & Verhalten** stellst du Hintergrund- und Textfarbe, einen Button und den Innenabstand ein. Neben den Farbfeldern siehst du die Farben deines Themes und übernimmst sie per Klick. Dazu kommen „sticky“ (der Banner bleibt beim Scrollen sichtbar) und die Blinkgeschwindigkeit.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-f76dc69f4ec80e8efb3e257a27c0562d8f8e437a%2Fmarketing-aktionen-admin-banner-design.png?alt=media" alt="Design und Verhalten des Banners"><figcaption></figcaption></figure>

Unter **Sichtbarkeit** grenzt du den Banner weiter ein:

* **Seiten-Sichtbarkeit** – nur auf bestimmten Seitentypen anzeigen oder dort ausblenden. Tipp: Warenkorb, Kasse und Anmelden/Registrieren ausblenden, damit der Checkout ungestört bleibt.
* **Zielgruppe & Geräte** – nur für bestimmte Kundengruppen oder nur auf Desktop, Tablet oder Mobil.

### A/B-Testing

In der Karte **Varianten** legst du mehrere Varianten eines Banners an, zum Beispiel zwei verschiedene Texte. Mit aktivem A/B-Testing verteilt das Plugin sie nach Gewichtung auf die Besucher. Jeder Besucher behält dabei seine Variante.

{% hint style="info" %}
A/B-Testing ist etwas anderes als die Rotation: A/B-Testing teilt die Varianten **eines** Banners auf die Besucher auf, die Rotation wechselt zwischen **mehreren** Bannern.
{% endhint %}


---

# 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/banner.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.
