# Dynamic Pricing Engine: kompletny przewodnik

> Kompletny przewodnik po wtyczce Dynamic Pricing Engine dla WooCommerce: instalacja, konfiguracja, 4 typy reguł (godzina, stan magazynowy, segment, konkurent), segmenty klientów, scraping konkurencji, natywne testy A/B, dziennik, zabezpieczenia na 3 poziomach, FAQ.

- Strona: <https://www.datafirefly.com/pl/documentation/dfdynamicpricing/>
- Język: pl
- Zaktualizowano: 2026-10-10
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfdynamicpricing/index.md), [en](https://www.datafirefly.com/en/documentation/dfdynamicpricing/index.md), [es](https://www.datafirefly.com/es/documentation/dfdynamicpricing/index.md), [de](https://www.datafirefly.com/de/documentation/dfdynamicpricing/index.md), [it](https://www.datafirefly.com/it/documentation/dfdynamicpricing/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdynamicpricing/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdynamicpricing/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

Witaj w kompletnej dokumentacji **Dynamic Pricing Engine**, silnika dynamicznych cen dla WooCommerce wydawanego przez DataFirefly. Ten przewodnik obejmuje instalację, konfigurację początkową, każdy typ reguły, segmentację klientów, scraping konkurencji, testy A/B, dziennik, zabezpieczenia cenowe i deinstalację.

**Wymagania:** WordPress 6.0+, WooCommerce 8.0+, PHP 7.4+. Zgodne z HPOS i blokami Checkout.

## Instalacja

### Przesłanie wtyczki

1. W panelu WordPressa przejdź do **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**.
2. Wybierz plik `dfdynamicpricing.zip` i kliknij _Zainstaluj teraz_.
3. Po zakończeniu instalacji kliknij _Włącz wtyczkę_.

### Co się dzieje przy aktywacji

Wtyczka tworzy 6 własnych tabel (z przedrostkiem `wp_dfdpe_`):

- `wp_dfdpe_rules` — reguły cenowe
- `wp_dfdpe_logs` — dziennik korekt
- `wp_dfdpe_segments` — segmenty klientów (3 tworzone automatycznie)
- `wp_dfdpe_competitors` — monitoring konkurencji
- `wp_dfdpe_ab_tests` — testy A/B
- `wp_dfdpe_ab_events` — zdarzenia ekspozycji, ATC i konwersji

Planowane są też dwa zadania cron: scraping konkurencji (domyślnie co godzinę) i czyszczenie dziennika (codziennie).

### Menu administracyjne

W pasku bocznym pojawia się nowe menu **Dynamic Pricing** z 7 podmenu: Panel, Reguły, Segmenty, Konkurenci, Testy A/B, Dziennik, Ustawienia. Wszystkie akcje wymagają zdolności WordPressa `manage_woocommerce`.

## Konfiguracja początkowa (Ustawienia)

Zanim utworzysz pierwszą regułę, zajrzyj do **Dynamic Pricing → Ustawienia**, aby dostosować parametry globalne.

### Dziennik

- **Włącz dziennik**: domyślnie zaznaczone. Każda korekta jest zapisywana z produktem, regułą, klientem i kontekstem.
- **Retencja (dni)**: domyślnie 60 dni. Automatyczne czyszczenie działa codziennie.

Dziennik jest limitowany do 1 wpisu na sesję, produkt i godzinę, aby zapobiec zalewowi. Możesz go całkowicie wyłączyć, jeśli z niego nie korzystasz.

### Globalne zabezpieczenia cenowe

- **Cena minimalna (% ceny wyjściowej)**: na przykład 70 = nigdy nie schodzić poniżej 70 % ceny wyjściowej. 0 = wyłączone.
- **Cena maksymalna (% ceny wyjściowej)**: na przykład 130 = nigdy nie przekraczać 130 %. 0 = wyłączone.
- **Nigdy nie sprzedawać poniżej kosztu zakupu**: do włączenia, jeśli przechowujesz koszt w meta produktu.
- **Klucz meta kosztu zakupu**: domyślnie `_cost` (zgodny z WooCommerce Cost of Goods).

### Scraper konkurencji

- **Częstotliwość uruchamiania**: co godzinę, dwa razy dziennie albo codziennie. Scraper przetwarza 25 adresów URL na partię.

### Wyświetlanie na froncie

- **Pokaż przekreśloną cenę wyjściową**: przydatne dla widocznego efektu promocji. Wyłącz przy poufnych testach A/B.

## Tworzenie pierwszej reguły

Przejdź do **Dynamic Pricing → Reguły → Dodaj**. Każda reguła ma te same pola podstawowe, niezależnie od typu.

### Pola wspólne

- **Nazwa**: etykieta wewnętrzna, przydatna w dzienniku (np. „Happy hour 18-20").
- **Typ**: Godzina, Stan magazynowy, Segment klienta albo Konkurent.
- **Status**: Aktywna albo Nieaktywna. Nieaktywna reguła nigdy nie jest ewaluowana.
- **Priorytet**: reguły wykonują się w rosnącej kolejności priorytetu. Każda reguła pracuje na wyniku poprzedniej.
- **Zakres**: Globalny, Kategoria, Tag albo Konkretny produkt.
- **Korekta**: Procent, Kwota stała, Wartość zdefiniowana albo Dopasowanie do konkurenta (tylko przy typie Konkurent).
- **Minimum / Maksimum**: opcjonalne zabezpieczenia na poziomie reguły.
- **Okno dat**: daty rozpoczęcia i zakończenia, aby reguła była aktywna tylko w danym okresie.
- **Test A/B**: opcjonalne powiązanie z testem A/B i jego wariantem (patrz sekcja Testy A/B).

**Rada priorytetyzacji:** zacznij od reguł najszerszych (globalnych) o niskim priorytecie, a potem doprecyzuj regułami celowanymi o wyższym priorytecie. Globalne zabezpieczenia z Ustawień stosowane są zawsze na końcu.

## Typ 1: reguła godzinowa

Koryguje cenę według godziny i dnia tygodnia. Idealna dla efektu happy hour, promocji weekendowych albo taryf nocnych.

### Dostępne warunki

- **Dni tygodnia**: wybierz jeden lub kilka dni (poniedziałek do niedzieli, format ISO).
- **Godzina rozpoczęcia / zakończenia**: w formacie 24-godzinnym. Przedziały przecinające północ są obsługiwane automatycznie (np. 22-02).
- **Strefa czasowa**: _witryna_ (domyślnie, strefa WordPressa) albo strefa konkretna (np. `Europe/Warsaw`).

### Konkretne przykłady

- **Happy hour**: −15 %, czwartek-piątek, 18-20, strefa Europe/Paris.
- **Promocja weekendowa**: −10 %, sobota-niedziela, 00:00-23:59.
- **Cena nocna**: +5 %, codziennie, 22-06 (przecina północ, obsługiwane automatycznie).

## Typ 2: reguła stanu magazynowego

Koryguje cenę według poziomu zapasu produktu. Przydatna do szybkiego upłynniania nadwyżek albo dowartościowania produktów stających się rzadkimi.

### Dostępne warunki

- **Operator**: .
- **Próg**: liczba całkowita.
- **Tryb**: _Bezwzględny_ (liczba sztuk) albo _Procent zapasu początkowego_ (wymaga meta `_initial_stock` ustawionego na produkcie).

### Konkretne przykłady

- **Upłynnianie**: stan >= 50 (nadwyżka) → −20 %.
- **Rzadkość**: stan < 5 → +10 %.
- **Procent zapasu początkowego**: tryb procentowy, stan < 20 % zapasu początkowego → −5 %.

Aby użyć trybu procentowego, dodaj pole meta `_initial_stock` do produktów (przez WP All Import, ACF albo proste `update_post_meta`). Bez tego meta tryb procentowy jest ignorowany.

## Typ 3: reguła segmentu klienta

Stosuje korektę wyłącznie do klientów należących do jednego lub kilku zdefiniowanych segmentów.

### Dostępne warunki

- **Segmenty**: jeden lub kilka istniejących segmentów (patrz sekcja Segmenty).
- **Dopasowanie**: _Any_ (klient należy do co najmniej jednego segmentu) albo _All_ (należy do wszystkich).

### Konkretne przykłady

- **Lojalność**: segment _loyal-customers_, korekta −10 %.
- **Odzyskiwanie**: segment _dormant_ (do utworzenia), korekta −20 % przez 7 dni.
- **B2B**: segment _b2b_ (rola `wholesale`), korekta −25 %.

## Typ 4: reguła ceny konkurenta

Dopasowuje Twoją cenę do ceny konkurenta skonfigurowanego w sekcji Konkurenci. Dostępne trzy strategie.

### Strategie

- **Match**: Twoja cena staje się dokładnie ceną konkurenta.
- **Undercut**: Twoja cena schodzi poniżej ceny konkurenta, procentowo albo o kwotę stałą.
- **Overprice**: Twoja cena wychodzi powyżej konkurenta (pozycjonowanie premium).

### Dostępne warunki

- **Tryb**: _Procent_ albo _Kwota stała_.
- **Wartość**: procent (np. 5 dla 5 %) albo kwota w walucie.
- **Maksymalny wiek danych (godziny)**: powyżej tego progu dane ze scrapingu uznawane są za zbyt stare i reguła przechodzi na zachowanie awaryjne.
- **Fallback**: zachowanie przy niedostępnych danych konkurenta (na przykład korekta neutralna albo pominięcie reguły).

### Konkretny przykład

Undercut 3 % względem konkurenta A, z maksymalnym wiekiem 6 godzin. Jeśli konkurent A nie był scrapowany od 6 godzin, reguła jest pomijana, a cena pozostaje bez zmian.

## Segmenty klientów

Segment to kombinacja kryteriów definiująca grupę klientów. Utworzony segment może być celem reguły typu _Segment klienta_.

### Segmenty tworzone przy aktywacji

- **new-customers**: klienci z 0 albo 1 zamówieniem.
- **loyal-customers**: klienci z 5 zamówieniami lub więcej.
- **vip**: klienci, którzy wydali co najmniej 500 €.

### Tworzenie segmentu

W **Dynamic Pricing → Segmenty → Dodaj** zdefiniuj:

- **Nazwa** i **Slug** (generowany automatycznie, jeśli pusty).
- **Opis** (opcjonalny, dla Twojego zespołu).
- **Kryteria**: dodaj tyle wierszy, ile trzeba. Wszystkie kryteria muszą być spełnione (logiczne I).
- **Status**: aktywny albo nieaktywny.

### Pola dostępne w kryteriach

- `order_count` — liczba zamówień klienta.
- `total_spent` — łączna wydana kwota (w walucie witryny).
- `is_guest` — 1, jeśli odwiedzający nie jest zalogowany, 0 w przeciwnym razie.
- `user_roles` — role WordPressa klienta (np. `customer`, `subscriber`, `wholesale`).
- `days_since_last_order` — dni od ostatniego zamówienia.

### Dostępne operatory

Dziesięć operatorów: `==`, `!=`, `>`, `>=`, `