Przejdź do treści

Przewodnik użytkowania

Szczegółowy opis wszystkich zakładek panelu Recommended Products Modal Pro.

Zakładka Triggers — kiedy odpalić modal

Każdy trygger włączasz osobno, możesz łączyć je dowolnie. Wersja Free ma tylko Add to Cart.

  • Add to Cart — po dodaniu produktu do koszyka. Klasyczny moment cross-sellingu.
  • Exit Intent — detekcja ruchu myszy do paska zakładek lub tab visibility hidden. Ostatnia szansa na uratowanie wizyty.
  • Pre-checkout — sekundę przed przejściem do kasy. Pokaż jeszcze jedno uzupełnienie zanim klient zatwierdzi.
  • Scroll Depth — po przewinięciu N% strony (domyślnie 60%). Sygnał zainteresowania.
  • Time on Page — po N sekundach (domyślnie 30s). Idealne dla produktów premium gdzie klient się waha.
  • Cart Page — inline lub modal na stronie koszyka. Rekomendacje „kupowane razem” oparte o zawartość koszyka.
  • Single Product — subtelny sidebar na karcie produktu. Sugeruje podczas oglądania, jeszcze przed ATC.
  • Wishlist — po dodaniu produktu do wishlisty. Integracja z TI WC Wishlist i YITH WC Wishlist.

Zakładka Algorithms — co zarekomendować

Mieszaj algorytmy per trygger, kategoria lub segment klienta.

  • Frequently Bought Together (FBT) — klasyczne pary z Twoich historycznych koszyków, pre-computed cronem
  • Collaborative Filtering — „klienci tacy jak Ty kupili także…” na bazie segmentów zachowań
  • Same Brand — trzyma użytkownika w ekosystemie marki, którą już wybrał
  • Same Category — alternatywy w tej samej kategorii, świetne dla mody i dekoracji
  • Cross-Category Pairing — uczy się par „kategoria A → kategoria B” (np. obiektywy do aparatów)
  • Higher Margin — rekomenduje produkty z najwyższą marżą (custom field, pełna kontrola)
  • Best Sellers — ostatnie 30/90 dni, filtr po stocku i kategorii bazowej
  • New Arrivals — podświetla świeży asortyment u klientów eksplorujących sklep
  • Price Range Match — w tej samej półce cenowej, żeby nie odstraszyć ceną
  • Manual Rules — gdy chcesz przejąć stery: warunki + priorytety + lista produktów

Zakładka Layouts — wygląd modalu

  • Card Carousel — najpopularniejszy, slider z kartami produktów
  • Grid — siatka 2×2 lub 3×3
  • List — pionowa lista z większymi obrazkami i opisami
  • Bottom Sheet — mobile-first slide-up
  • Sidebar — wysunięcie z prawej (desktop) lub bottom (mobile)
  • Fullscreen — pełnoekranowy z dużym hero
  • Inline — bez modalu, wbudowany w stronę (Single Product, Cart)

Zakładka Rules — manualne reguły cross-sell

Gdy chcesz przejąć stery i nie polegać na algorytmie. Każda reguła ma warunki (np. produkt X w koszyku + kategoria Y), priorytety (kolejność stosowania), rekomendacje (lista produktów). Pierwsza pasująca reguła wygrywa.

Zakładka Segments — różne strategie dla różnych klientów

Definiujesz segmenty (np. „klienci VIP”, „pierwsza wizyta”, „porzucony koszyk w 7 dniach”), a każdy może mieć własną strategię, layout i harmonogram.

  • Warunki segmentu: rola WP, total spend, liczba zamówień, kategoria w koszyku, geo (kraj/region), nowość/powracający, dzień tygodnia
  • Override per segment: trygger, algorytm, layout, lista wykluczeń
  • Scheduling per segment: aktywuj tylko w wybranych dniach/godzinach

Zakładka Experiments — A/B testing

Zbuduj dwa warianty modalu, ustaw split (domyślnie 50/50) i pozwól silnikowi wskazać zwycięzcę. Statystyczna istotność liczona po stronie pluginu (chi-square test).

  • Multi-arm — A/B/C, do 4 wariantów jednocześnie
  • Sticky session 30 dni — ten sam użytkownik widzi ten sam wariant przy powrocie
  • Auto-stop po osiągnięciu progu (configurable confidence level — 90%, 95%, 99%)
  • Eksport wyników do CSV — z raw eventami i statystykami

Zakładka Analytics — dashboard ROI

Każda akcja jest trackowana w tabeli wp_wpnest_rpm_events: impression, click, ATC z modalu, purchase. Dashboard agreguje to per trygger, algorytm, segment i wariant A/B.

  • CTR modalu — kliknięcia / wyświetlenia
  • ATC rate — dodania do koszyka / kliknięcia
  • AOV uplift — wzrost średniej wartości zamówień z modalu
  • ROI breakdown — per trygger, algorytm, segment, wariant
  • Cohort analysis — porównanie zamówień z modalem vs bez

Komendy WP-CLI

# Wymuszony rebuild par FBT (po dużym imporcie zamówień)
wp wpnest-rpm pairs:rebuild

# Cleanup starych eventów (manual, normalnie cron daily)
wp wpnest-rpm events:cleanup

# Test webhooka Slack/Discord
wp wpnest-rpm webhook:test --url=https://hooks.slack.com/...

# Eksport reguł i segmentów do JSON
wp wpnest-rpm export > rpm-config.json

# Import konfiguracji z pliku JSON
wp wpnest-rpm import < rpm-config.json

# Lista aktywnych experiments z wynikami
wp wpnest-rpm experiments:list