WooCommerce
Plugin 0.8.5WooCommerce jest aktywnym źródłem prawdy o sprzedaży. Integracja składa się z połączenia REST API do importu oraz pluginu first-party do bieżących zdarzeń.
Połączenie sklepu
- 1Wygeneruj klucze Woo REST API
W WordPressie przejdź do WooCommerce → Ustawienia → Zaawansowane → REST API i utwórz klucz odczyt/zapis.
- 2Uruchom kreator w Klientometrze
Podaj pełny adres HTTPS, nazwę sklepu, Consumer Key ck_… oraz Consumer Secret cs_….
- 3Wykonaj test
Backend weryfikuje dostęp do sklepu przed zapisaniem zaszyfrowanych poświadczeń.
- 4Zaimportuj dane
Pierwszy import pobiera zamówienia i opcjonalnie katalog, a duplikaty są pomijane.
Dodawanie sklepu może być zablokowane dla konta demo, użytkownika bez roli administratora/managera, zaległej płatności lub osiągniętego limitu sklepów w planie.
Instalacja pluginu
- Pobierz ZIP z kreatora lub Ustawienia → Integracje.
- W WordPressie wybierz Wtyczki → Dodaj nową → Wyślij wtyczkę.
- Aktywuj plugin „Klientometr Attribution”.
- Wklej jednorazowy klucz połączenia i zapisz.
- Otwórz Diagnostykę i uruchom test API.
Klucze pluginu mają prefiks kmw_, są haszowane po stronie backendu i mogą zostać osobno obrócone lub unieważnione.
Moduły pluginu
| Moduł | Co wysyła | Domyślnie |
|---|---|---|
| Tracking przeglądarkowy | sesje, page_view i kontekst marketingowy | Wyłączony |
| ViewContent | wyświetlenie produktu | Gotowy po włączeniu trackera |
| AddToCart | dodanie produktu do koszyka | Gotowy po włączeniu trackera |
| InitiateCheckout | rozpoczęcie checkoutu | Gotowy po włączeniu trackera |
| Zakupy | purchase po utworzeniu zamówienia | Wyłączony |
| Statusy | order_updated | Wyłączony |
| Zwroty | refund z kwotą i walutą | Wyłączony |
| Meta Pixel / CAPI | sygnały browser i server-side | Wyłączony |
Nieudane wysyłki do ingestu trafiają do kolejki ponowień obsługiwanej przez WP-Cron. Plugin udostępnia także dziennik ostatniej aktywności i eksport diagnostyczny.
Meta Pixel, CAPI i konflikty
Ten sam event_id jest współdzielony przez Klientometr, Meta Pixel i CAPI. Dzięki temu Meta oraz backend mogą deduplikować sygnał browser/server dotyczący tego samego zakupu.
Gdy aktywny jest PixelYourSite lub inna integracja Meta, Pixel i CAPI Klientometru pozostają wyłączone do czasu jawnego potwierdzenia współdzielonej odpowiedzialności. W becie BZP tylko jeden plugin powinien wysyłać kontrolowany Purchase/CAPI.
Diagnostyka pluginu
- Sprawdź status połączenia i endpoint ingest.
- Potwierdź ostatni event oraz długość kolejki ponowień.
- Wyślij zdarzenie testowe przed włączeniem modułów produkcyjnych.
- Sprawdź zgodę przez WP Consent API i filtr
klientometr_attribution_consent_state. - Przy problemach eksportuj diagnostykę bez kopiowania sekretów.

