Częstotliwość

Częstotliwość odpowiada na pytanie: gdy już wiemy że trigger się odpalił, czy ten konkretny odwiedzający faktycznie zobaczy popup, biorąc pod uwagę ile razy już go widział? Cztery tryby, konfigurowane na zakładce Overview w karcie Frequency & dismissal.

Typy częstotliwości

Once per session (session)

Domyślny. Odwiedzający widzi popup raz na sesję przeglądarki. Zamknięcie karty (albo wygaśnięcie sesji) resetuje suppression — zobaczy go znowu przy następnej wizycie.

Przechowywanie suppression: sesja PHP zawsze; sessionStorage też gdy zgoda GDPR pozwala. Wybierz dla jednorazowych ogłoszeń, które chcesz pokazywać każdemu powracającemu odwiedzającemu na nowej wizycie.

Once every N days (days)

Odwiedzający widzi popup raz, potem jest suppressed na N dni (ustawiane polem Days between shows). Po N dniach może się znów pokazać.

Przechowywanie suppression: localStorage z timestampem expiry (gdy zgoda pozwala). Gdy zgoda jest wstrzymana, fallback do sesji PHP (co efektywnie redukuje się do session-only suppression dla tego odwiedzającego).

Wybierz dla okresowych ponagleń, gdzie session-only jest za nachalne, a always-on za agresywne — tygodniowe prompty newsletter, miesięczne przypomnienia o wyprzedaży.

Always show (always)

Bez suppression. Popup odpala się za każdym razem, gdy trigger się odpali (każde załadowanie strony z immediate, każda strona spełniająca próg scroll, itd.).

Wybierz dla cookie bannerów, które prawnie muszą się pokazywać do potwierdzenia, albo dla globalnych informacji, które odwiedzający musi explicite odrzucić za każdym razem.

Until permanently dismissed (permanent)

Popup pokazuje się przy każdym załadowaniu strony, dopóki odwiedzający nie kliknie buttona Don’t show again. Po odrzuceniu nigdy nie pokaże się ponownie temu odwiedzającemu, chyba że wyczyści przechowywanie przeglądarki.

Przechowywanie suppression: localStorage bez expiry (gdy zgoda pozwala). Gdy zgoda jest wstrzymana, flaga dismiss żyje w sesji PHP — czyli permanent ustawienie efektywnie redukuje się do “do końca tej sesji”.

Wybierz gdy popup jest informacyjny i ma marudzić do potwierdzenia (np. top banner o trwającym oknie maintenance).

Kontrolki odrzucania

Trzy opcjonalne UI affordance decydujące jak odwiedzający może odrzucić popup. Przełączaj w karcie Frequency & dismissal:

Show close (X) button

Renderuje mały × w rogu shella. Kliknięcie go zamyka popup i rejestruje event close. Zalecane dla dostępności (odwiedzający zawsze może uciec).

Close on overlay click

Kliknięcie poza popupem (na przyciemnionym overlay) zamyka go. Istotne tylko dla display type modal — inne warianty nie mają overlay do kliknięcia. Zalecane dla modal.

Show permanent dismiss button

Renderuje button Don’t show again, który zamyka popup ORAZ zapisuje flagę permanent suppression.

Zachowanie zależy od Frequency:

• Frequency = Always show — button jest wyłączony w edytorze z help textem: “Disabled — frequency is set to ‘Always show’, so the popup re-appears even after a permanent dismiss.” Intencja Always show to ciągłe pokazywanie; permanent dismiss byłby z tym sprzeczny.
• Frequency = Until permanently dismissed — button jest wymagany z help textem: “Required — frequency is set to ‘Until permanently dismissed’, so the popup needs this button to let visitors close it for good.”
• Frequency = Session / N days — button jest opcjonalny. Gdy on, kliknięcie działa jak permanent suppression (nadpisując skonfigurowaną częstotliwość dla tego odwiedzającego).

Kliknięcie permanent dismiss rejestruje event permanent_dismiss.

Semantyka wartości częstotliwości

Pole Days between shows jest widoczne tylko gdy Frequency = Once every N days. Inne częstotliwości je ukrywają.

Jak częstotliwość interaguje z GDPR

Stan częstotliwości musi gdzieś trwać. Ustawienie systemowe gdprMode wybiera gdzie:

• Wait for cookie acceptance (domyślnie) — bez client storage, dopóki odwiedzający nie zaakceptuje cookies. Podczas braku zgody suppression żyje tylko w sesji PHP, która wygasa przy zamknięciu przeglądarki. Praktyczny efekt: częstotliwość N dni degraduje się do session-only dla odwiedzających, którzy nigdy nie wyrażają zgody.
• Use browser storage — zapisuj sessionStorage / localStorage od razu. Częstotliwość działa zgodnie z dokumentacją.
• Use cookies — to samo co storage mode, ale z cookies.

Pełny obraz w Storefront → GDPR i storage.

Jak częstotliwość interaguje z display mode

Gdy więcej niż jeden popup kwalifikuje się na tej samej stronie, systemowy Popup display mode decyduje co się dzieje:

• Only first (highest priority) — pokazuje się tylko jeden popup o najwyższym priorytecie. Pozostałe kwalifikujące się są pomijane na to ładowanie strony (ale ich stan częstotliwości nie jest oznaczony jako “shown” — będą rozważone ponownie na następnej stronie).
• Queue (sequential) — pojawiają się jeden po drugim w kolejności priorytetu, z uwzględnieniem limitu per-sesja (maxPerSession).

Gdzie dalej

• Triggers — kiedy popup miałby się odpalić.
• Storefront → GDPR i storage — dokładnie gdzie żyje stan suppression.
• Stages → Popup — close button i overlay click w kontekście każdego wariantu.