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

# Einrichtung

Installation, Grundeinstellungen und Berechtigungen

{% hint style="info" %}
Installiere das Plugin über den Shopware Community Store. Alternativ lädst du die ZIP-Datei unter **Erweiterungen → Meine Erweiterungen** hoch und aktivierst sie dort.
{% endhint %}

Nach der Aktivierung findest du das Plugin unter **Marketing → Marketing-Aktionen**. Von dort legst du Aktionen an, mit oder ohne Assistent. Die Auffüll-Störer erreichst du über den Button **Auffüll-Störer** oben in der Liste.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-aeb049391a855a1ad7f7dea31791683e3655037c%2Fmarketing-aktionen-admin-list.png?alt=media" alt="Liste der Marketing-Aktionen"><figcaption><p>Übersicht der Marketing-Aktionen mit Status</p></figcaption></figure>

### Grundeinstellungen

Die Grundeinstellungen erreichst du unter **Erweiterungen → Meine Erweiterungen → Marketing-Aktionen → Konfigurieren**. Die meisten Shops müssen hier nichts ändern, alle Werte sind ab Werk sinnvoll gesetzt. Jede Einstellung lässt sich je Verkaufskanal anpassen.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-891fd73df66ae3ec44c86aba826da45e6a2fd2c8%2Fmarketing-aktionen-admin-config.png?alt=media" alt="Plugin-Konfiguration"><figcaption><p>Konfiguration mit Direktlinks zu den Aktionen</p></figcaption></figure>

| Einstellung                                        | Standard    | Bedeutung                                                                                                                             |
| -------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Marketing-Aktionen im Shop ausspielen              | an          | Hauptschalter. Aus: Im Shop erscheint nichts mehr, die Aktionen selbst bleiben unverändert und laufen weiter, sobald er wieder an ist |
| Wenn mehrere Banner gleichzeitig gültig sind       | Aus         | Aus: nur der Banner mit der höchsten Priorität. Sequenziell oder Zufällig: die Banner wechseln sich ab                                |
| Rotationsintervall in Sekunden                     | 8           | Zeit bis zum nächsten Banner. 0 = kein automatischer Wechsel                                                                          |
| Consent-Quelle                                     | Automatisch | Woher die Einwilligung des Besuchers gelesen wird: Cookiebot, Shopwares Cookie-Hinweis oder ein eigener JavaScript-Hook               |
| Popups erst nach der Consent-Entscheidung anzeigen | an          | Solange der Cookie-Hinweis offen ist, öffnet sich kein Popup                                                                          |
| Gültigkeit von „einmal pro Kunde“ in Tagen         | 365         | Danach darf ein Popup mit „einmal pro Kunde“ erneut erscheinen                                                                        |

{% hint style="info" %}
Der Hauptschalter ist dein Notaus: Wenn im Shop etwas nicht stimmt, schaltest du alle Banner, Popups und Störer mit einem Klick ab, ohne eine einzige Aktion anzufassen.
{% endhint %}

### Berechtigungen

Unter **Einstellungen → Benutzer & Rechte → Rollen** findest du im Bereich Marketing zwei Einträge:

| Berechtigung                              | Wofür                                                                     |
| ----------------------------------------- | ------------------------------------------------------------------------- |
| Marketing-Aktionen                        | Ansehen, Bearbeiten, Anlegen und Löschen von Aktionen und Auffüll-Störern |
| Marketing-Aktionen: freies HTML in Popups | Popups mit dem Inhaltstyp „Freies HTML (Code)“ speichern                  |

{% hint style="warning" %}
Freies HTML wird im Shop unverändert ausgegeben, auch Skripte. Gib diese Berechtigung nur Personen, denen du auch Zugriff auf das Theme geben würdest. Popups mit Text oder Newsletter-Anmeldung brauchen sie nicht.
{% endhint %}

### In-App-Käufe

Banner, Popup, Listing-Störer und Auffüll-Störer sind im Plugin enthalten. Display-Elemente und Suchhinweise sind In-App-Käufe. Der Assistent zeigt dir direkt, welche davon in deinem Shop schon freigeschaltet sind.

{% hint style="info" %}
Benötigst du Hilfe bei der Einrichtung des Shopware-6-Plugins? Kontaktiere uns gerne.
{% 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/einrichtung.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.
