Häufigkeit und Cookie-Regeln festlegen
Die Einstellung „Anzeigefrequenz" steuert, wie oft derselbe Besucher ein Popup sieht. Diese Anleitung erklärt jede Option und wie der zugrunde liegende Browser-Speicher funktioniert.
Optionen für die Anzeigefrequenz
Setzen Sie im Abschnitt Allgemein des Popup-Editors die Anzeigefrequenz auf einen der vier Werte.
Immer
Das Popup öffnet sich bei jedem Seitenaufruf, auf dem das Popup aktiv ist. Es wird kein Browser-Speicher geschrieben.
Verwenden Sie diese Option für Inhalte, die immer sichtbar sein müssen — z. B. ein rechtlicher Hinweis oder eine dringende Service-Unterbrechungsmeldung.
Einmal pro Sitzung
Das Popup öffnet sich höchstens einmal pro Browser-Sitzung. Nach dem Öffnen schreibt das Plugin ein Session-Cookie namens ssd_popup_<popup-id> (ohne Ablaufdatum, path=/, sameSite=lax, sowie secure über HTTPS). Ein Session-Cookie gilt über alle Tabs und Fenster desselben Browsers hinweg und wird automatisch gelöscht, wenn der Browser geschlossen wird.
Das bedeutet: Das Popup erscheint pro Browser-Sitzung nur einmal — unabhängig davon, wie viele Tabs oder Fenster der Besucher öffnet, auch beim Öffnen einer Unterseite in einem neuen Tab — und erscheint beim nächsten Besuch nach dem Schließen des Browsers erneut.
Warum ein Cookie und nicht
sessionStorage?sessionStorageist auf einen einzelnen Tab beschränkt. Beim Öffnen eines Links in einem neuen Tab erhielt dieser Tab einen leeren Speicher, sodass ein „Einmal pro Sitzung"-Popup fälschlicherweise erneut erschien. Ein Session-Cookie gilt für die gesamte Browser-Sitzung — genau das, was unter „einmal pro Sitzung" zu verstehen ist.
Verwenden Sie diese Option für Willkommensnachrichten oder Rabattanzeigen, bei denen das Popup beim ersten Besuch jeder Browser-Sitzung erscheinen soll, aber nicht bei jeder Seitennavigation.
Einmal pro Tag (24 h)
Das Popup öffnet sich höchstens einmal in 24 Stunden. Das Plugin schreibt ein { timestamp }-Objekt in localStorage unter dem Schlüssel ssd_popup_<popup-id> und prüft, ob seit diesem Zeitstempel mehr als 24 Stunden vergangen sind.
Verwenden Sie diese Option für tägliche Aktionen oder Neuigkeiten-Ankündigungen.
Einmalig
Das Popup öffnet sich genau einmal pro Browser-Profil. Das Plugin schreibt in localStorage unter demselben Schlüssel und zeigt das Popup nie wieder an, solange dieser Schlüssel existiert.
Verwenden Sie diese Option für echte Erstmalig-Nachrichten — z. B. ein „Willkommen in unserem Shop"-Angebot für völlig neue Besucher.
Wie Browser-Speicher genutzt wird
Das Plugin verwendet ein Session-Cookie für Einmal pro Sitzung und localStorage für Einmal pro Tag und Einmalig. Alle Schlüssel folgen dem Muster ssd_popup_<popup-id>.
- Einmal pro Sitzung — ein Session-Cookie (ohne Ablaufdatum), das über alle Tabs und Fenster hinweg gilt und beim Schließen des Browsers gelöscht wird.
- Einmal pro Tag / Einmalig — ein
{ timestamp }-Objekt inlocalStorage, das über Sitzungen hinweg bestehen bleibt, bis der Zeitstempel abläuft (24 h) oder der Schlüssel entfernt wird (Einmalig).
Da das Plugin Browser-Speicher statt serverseitiger Sessions oder Account-Flags verwendet:
- Der Häufigkeitscap gilt pro Browser-Profil, nicht pro Shopware-Kundenkonto. Ein Besucher, der einen anderen Browser oder einen privaten Tab verwendet, sieht das Popup erneut.
- Das Löschen von Browser-Daten (Verlauf, Cookies, localStorage) setzt alle Häufigkeitscaps für diesen Browser zurück.
Das Plugin registriert auch einen Eintrag im Shopware Cookie-Manager unter der Gruppe Erforderlich (Cookie-Name: ssd_ultimate_popup). Diese Registrierung erklärt dem Cookie-Manager, dass das Plugin einen technisch notwendigen Häufigkeits-Flag im Browser speichert — daher ist vor dem Anwenden des Häufigkeitscaps keine Einwilligung erforderlich.
Beispiele
| Ziel | Anzeigefrequenz |
|---|---|
| Rechtlichen Hinweis immer zeigen | Immer |
| Willkommensnachricht einmal pro Besuch | Einmal pro Sitzung |
| Tagesangebot einmal täglich zeigen | Einmal pro Tag (24 h) |
| Erstkunden-Onboarding-Popup | Einmalig |