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

# Popup

Fenster über der Seite – mit Text, Newsletter-Anmeldung, Erlebniswelt oder eigenem HTML

Das Popup öffnet sich als Fenster über der Seite. Es eignet sich für Ankündigungen, eine Newsletter-Anmeldung mit Gutschein oder ein eingebettetes Formular.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-11dd2f8ba75ffd1fdc346e777e9df5058ea5a582%2Fmarketing-aktionen-sf-popup.png?alt=media" alt="Popup im Shop mit Bild links und Text rechts"><figcaption><p>Popup mit Bild links und Inhalt rechts</p></figcaption></figure>

### Inhalt

In der Karte **Inhalt** wählst du den Inhaltstyp:

| Inhaltstyp           | Wofür                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------- |
| Text                 | Mit dem Editor gestalteter Inhalt: Überschrift, Text, Bild, Link                       |
| Newsletter-Anmeldung | Anmeldeformular mit optionaler Einleitung, auf Wunsch mit Gutschein nach der Anmeldung |
| Erlebniswelt         | Eine unter **Inhalte → Erlebniswelten** gestaltete Seite                               |
| Freies HTML (Code)   | Code wie Einbettungscodes von Newsletter-Tools, wird unverändert ausgegeben            |

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-275f84b229dc607e3d180753f995ebc7e519a29f%2Fmarketing-aktionen-admin-popup-content.png?alt=media" alt="Inhalt eines Popups"><figcaption></figcaption></figure>

Darunter legst du die **Position** fest: oben, in der Mitte oder unten im Browserfenster.

{% hint style="warning" %}
„Freies HTML“ braucht die eigene Berechtigung **Marketing-Aktionen: freies HTML in Popups** (siehe [Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/einrichtung.md#berechtigungen)). Shopware filtert beim Text-Inhalt aus Sicherheitsgründen Teile wie Formulare und Skripte heraus. Wenn du also einen Einbettungscode deines Newsletter-Tools einfügen willst, ist „Freies HTML“ der richtige Typ.
{% endhint %}

#### Gutschein nach der Newsletter-Anmeldung

Bei der Newsletter-Anmeldung kann das Popup direkt nach dem Absenden einen Gutscheincode zeigen:

| Gutschein                           | Wirkung                                                                                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------- |
| Kein Gutschein                      | Nur die Anmeldung                                                                                 |
| Fester Code (für alle gleich)       | Jeder Abonnent sieht denselben Code. Er muss zu einer aktiven Rabattaktion mit diesem Code passen |
| Individualcodes aus einer Promotion | Jeder Abonnent bekommt einen eigenen Code aus der gewählten Rabattaktion                          |

{% hint style="info" %}
Für Individualcodes muss die Rabattaktion dem Verkaufskanal zugeordnet sein und Individualcodes verwenden. Sonst wird kein Code ausgegeben.
{% endhint %}

### Wann sich das Popup öffnet

In der Karte **Verhalten** legst du Auslöser und Häufigkeit fest.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-955351362173aee2c6e9f616036426ebb6c36298%2Fmarketing-aktionen-admin-popup-behaviour.png?alt=media" alt="Auslöser und Anzeige-Verhalten des Popups"><figcaption></figcaption></figure>

| Auslöser                     | Wann                                                              |
| ---------------------------- | ----------------------------------------------------------------- |
| Nach Zeit                    | Einige Sekunden nach dem Seitenaufruf                             |
| Beim Scrollen nach unten     | Sobald ein bestimmter Anteil der Seite gescrollt wurde            |
| Exit Intent                  | Wenn der Mauszeiger die Seite nach oben verlässt (Desktop)        |
| Nur per Klick auf das Banner | Nie von selbst, nur nach einem Klick auf den Banner dieser Aktion |

Für Touch-Geräte gibt es ein eigenes **mobiles Verhalten**: Scroll-Up (das Gegenstück zum Exit Intent), Scroll-Down, nach Zeit oder gar nicht anzeigen.

| Anzeige-Verhalten  | Wirkung                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------- |
| Immer anzeigen     | Bei jedem Seitenaufruf                                                                  |
| Einmal pro Session | Einmal je Browser-Sitzung                                                               |
| Einmal pro Kunde   | Einmal, danach erst wieder nach der Zeit aus den Grundeinstellungen (Standard 365 Tage) |
| Mit Cooldown       | Erst nach einer Wartezeit erneut                                                        |

{% hint style="info" %}
Am wenigsten stört „Nach Zeit“ mit 5 bis 10 Sekunden und „Einmal pro Session“. Solange der Cookie-Hinweis offen ist, öffnet sich ab Werk kein Popup.
{% endhint %}

### Darstellung

In der Karte **Darstellung** wählst du Breite, ein Hintergrundbild und das Layout:

| Einstellung                | Möglichkeiten                                                                    |
| -------------------------- | -------------------------------------------------------------------------------- |
| Popup-Breite               | Automatisch, S (400 px), M (600 px), L (900 px), XL (1200 px) oder eigene Breite |
| Hintergrundbild            | Ein Bild aus der Medienverwaltung                                                |
| Layout mit Hintergrundbild | Inhalt über dem Bild oder Bild links, Inhalt rechts                              |

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-74eec981288424b425488d4db6df838f3eef641e%2Fmarketing-aktionen-admin-popup-appearance.png?alt=media" alt="Darstellung des Popups"><figcaption></figcaption></figure>

Jede Variante kann ein eigenes Bild, Layout und eine eigene Textfarbe haben. Leer gelassen übernimmt sie die Werte aus der Darstellung.

{% hint style="info" %}
Empfohlene Bildmaße: 1200 × 800 px (Querformat) für „Inhalt über dem Bild“, 600 × 800 px (Hochformat) für „Bild links“. Halte wichtige Bildteile in der Mitte. Die Karte bietet passende Beispielbilder als PNG und SVG zum Herunterladen. Wähle bei dunklen Bildern eine helle Textfarbe.
{% endhint %}

### A/B-Testing und Eingrenzung

Wie beim Banner legst du mehrere Varianten an und lässt sie per A/B-Testing auf die Besucher verteilen. Auslöser und Häufigkeit gelten für alle Varianten gleich.

Unter **Sichtbarkeit** grenzt du das Popup auf bestimmte Seiten, Kundengruppen oder Geräte ein. Ohne Eingrenzung erscheint es auf allen Seiten.


---

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