Instrukcja konfiguracji Kowal Analytics
Nawigacja w panelu administracyjnym
Główne wejścia do modułu:
Kowal -> Analytics -> DashboardStores -> Configuration -> Analytics
Struktura konfiguracji
Obecnie moduł udostępnia trzy główne grupy ustawień.
1. General
Ścieżka:
Stores -> Configuration -> Analytics -> General
Pole:
Enable Analytics
Znaczenie:
- włącza lub wyłącza tracking frontendowy i dalsze przetwarzanie analytics dla wybranego scope.
Zalecenie:
- najlepiej włączać per
store viewpo wcześniejszej weryfikacji działania trackerów i consumerów.
2. Debug
Ścieżka:
Stores -> Configuration -> Analytics -> Debug
Pola:
Enable Backend Debug LogEnable Frontend Console Log
Znaczenie:
- backend debug zapisuje logi techniczne do:
var/log/kowal_analytics_debug.log
- frontend debug zapisuje logi trackera do konsoli przeglądarki.
Zastosowanie:
- instalacja,
- QA,
- analiza błędów,
- testy selector assistanta,
- potwierdzenie, że eventy trafiają do pipeline’u.
Zalecenie:
- włączyć na czas wdrożenia i testów,
- wyłączyć na środowisku produkcyjnym po zakończeniu walidacji.
3. Tools
Ścieżka:
Stores -> Configuration -> Analytics -> Tools
Pole:
Enable Frontend Selector Assistant
Znaczenie:
- pokazuje helper na storefrontzie, który pomaga wskazać i przygotować konfigurację dla własnych area opartych o selektory.
Zastosowanie:
- mapowanie custom section,
- analiza struktury DOM,
- przygotowanie definicji area bez ręcznej edycji kodu.
Jak rozumieć konfigurację w praktyce
Scope
Moduł działa w scope Magento, więc konfiguracja może być różna dla:
default,website,store view.
Najbezpieczniej traktować moduł jako narzędzie per store view, bo:
- różne sklepy mogą mieć inny layout,
- różne sklepy mogą mieć inne sekcje bloga, CMS i merchandisingu,
- raporty per store view są znacznie bardziej wiarygodne operacyjnie.
Jak rozumieć podstawowe pojęcia w module
Area
Area to wydzielony obszar strony, który chcesz mierzyć jako źródło wpływu na sprzedaż.
Przykłady:
related_productsupsell_productscrosssell_productscategory_listingsearch_resultswishlist_productscompare_productsblog_post_listingblog_sidebar_categorieshomepage_promo_box
Object
Object to konkretny element wewnątrz area.
Przykłady:
- pojedynczy produkt na liście,
- jeden wpis blogowy,
- jedna kategoria bloga,
- jeden tag,
- jeden baner,
- jeden slajd.
Source Page
Source Page to strona, z której użytkownik wszedł w interakcję prowadzącą dalej do sprzedaży.
Przykłady:
- karta produktu źródłowego dla
related_products, - wpis blogowy dla klikniętego produktu,
- listing kategorii dla klikniętego produktu,
- wyniki wyszukiwania dla produktu.
Dashboard i raporty
Analytics Dashboard
To główny ekran przeglądowy. Pokazuje:
- attributed revenue,
- attributed orders,
- average order value,
- CTR,
- top areas,
- top supported products,
- top blog sources,
- linki do raportów szczegółowych.
Ten ekran odpowiada na pytanie:
co działa najlepiej
Area Report
Ten raport odpowiada na pytania:
- który area generuje przychód,
- które object w tym area sprzedają,
- z jakich source page bierze się sprzedaż.
Przykład:
related_productsma 18 zamówień,- najlepiej sprzedaje w nim
Zing Jump Rope, - najczęściej źródłem tej ścieżki jest karta produktu
Affirm Water Bottle.
Product Context Report
To raport dla obszarów produktowych takich jak:
related_productsupsell_productscrosssell_productscategory_listingsearch_results
Pokazuje zależność:
source product -> clicked object -> purchased SKU
Przykład:
- użytkownik jest na PDP
Affirm Water Bottle, - klika
WB05-S-Orangewrelated_products, - kupuje
WB05-S-Orange.
Blog Commerce Report
To raport dla obszarów blogowych:
blog_post_listingblog_recent_posts_widgetblog_sidebar_recent_postsblog_sidebar_categoriesblog_sidebar_tagsblog_post_view
Odpowiada na pytania:
- który post sprzedaje,
- która kategoria bloga sprzedaje,
- który tag wspiera sprzedaż,
- jakie SKU są kupowane po wejściu z bloga.
Object Report
To raport dla jednego konkretnego object.
Przykład:
- jeden produkt w
related_products, - jeden wpis blogowy z
blog_post_listing, - jedna kategoria bloga z
blog_sidebar_categories.
Pokazuje:
- ile miał impresji,
- ile miał kliknięć,
- ile wygenerował zamówień,
- jaki przychód został mu przypisany,
- z jakich source page pochodziły te ścieżki.
Source Page Report
To raport dla jednej konkretnej strony źródłowej.
Przykład:
- karta produktu
Affirm Water Bottle, - wpis blogowy
Jak wybrać bidon treningowy, - listing kategorii
Buty do biegania.
Pokazuje:
- jakie clicked object z tej strony sprzedają,
- jakie SKU są kupowane po wejściu z tej strony,
- ile zamówień i przychodu generuje ta konkretna strona jako punkt startowy ścieżki.
Modele atrybucji
Dostępne modele:
Last ClickFirst ClickAssistedView Through
Jak je czytać:
Last Click
Najlepszy do pytania:
- który element bezpośrednio domknął sprzedaż.
First Click
Najlepszy do pytania:
- który element rozpoczął ścieżkę prowadzącą do zakupu.
Assisted
Najlepszy do pytania:
- który element brał udział w ścieżce, nawet jeśli nie był ostatnim kliknięciem.
View Through
Najlepszy do pytania:
- czy sama ekspozycja sekcji miała wpływ na sprzedaż, nawet bez kliknięcia.
Konfiguracja custom area
Custom area możesz przygotować przez Frontend Selector Assistant.
Typowy workflow:
- Włącz
Enable Frontend Selector Assistant. - Otwórz storefront.
- Uruchom assistant.
- Wskaż obszar.
- Sprawdź proponowany
container selector. - Sprawdź proponowany
item selector. - Sprawdź
link selector. - Zapisz definicję.
- Potwierdź, że runtime apply dodało
data-kowal-track-*. - Przetestuj kliknięcie i przejście do raportów.
Przykład custom area
Załóżmy, że na stronie głównej masz box promocyjny z trzema kaflami.
Możesz zdefiniować:
area_code = homepage_promo_boxobject_type = promotioncontainer_selector = .homepage-promoitem_selector = .homepage-promo__itemlink_selector = .homepage-promo__link
Wtedy raport pokaże:
- który kafel był klikany,
- który prowadził do zakupu,
- jaki przychód wygenerował.
Workflow testowy po konfiguracji
Najbardziej sensowna kolejność:
- włączyć analytics,
- włączyć backend debug,
- włączyć frontend console log,
- przejść scenariusz użytkownika,
- sprawdzić dashboard,
- sprawdzić raport area,
- zejść do object report albo source page report,
- wyłączyć debug po potwierdzeniu poprawności.
Zalecenia operacyjne
- utrzymuj consumery pod supervisorem albo systemd,
- pilnuj, aby Magento cron działał stale,
- po zmianach motywu sprawdzaj, czy selektory custom area nadal pasują do DOM,
- po zmianach merchandisingu porównuj wyniki per area,
- nie interpretuj samego CTR jako sukcesu bez sprawdzenia przychodu i zamówień.





















