Kowal Analytics voor Magento 2
Wat is deze module
Kowal Analytics is een salesattributiemodule voor Magento 2. Het doel ervan is te laten zien welke elementen van de winkel daadwerkelijk invloed hebben op de winkelwagen, bestelling en omzet.
Dit is geen gewone pixel die pageviews verzamelt. De module analyseert de volledige verkoopcontext:
- welk gebied is weergegeven,
- op welk object binnen dat gebied is geklikt,
- vanaf welke pagina of van welk product de gebruiker de interactie is gestart,
- welk product aan de winkelwagen is toegevoegd,
- welke SKU uiteindelijk is gekocht,
- welke omzet aan dit pad moet worden toegeschreven.
Daardoor kan de winkel antwoord geven op vragen waarop standaard analytics meestal geen antwoord geven:
- Welke secties
related productsverkopen echt? - Welke
upsell- encross-sell-blokken genereren omzet? - Welke blogposts leiden tot productverkoop?
- Welke banners, widgets of CMS-secties worden alleen aangeklikt, maar converteren niet?
- Welke pagina-elementen nemen ruimte in, maar hebben geen invloed op de verkoop?
Wat is de zakelijke waarde
De module is ontwikkeld voor winkels die merchandising, content en pagina-indeling willen optimaliseren op basis van echte impact op verkoop, en niet alleen op basis van verkeer of CTR.
Vanuit de rapporten kun je beoordelen:
- omzet per area,
- aantal bestellingen per area,
- effectiviteit van specifieke objecten binnen een bepaalde area,
- effectiviteit van de relatie product -> aangeklikt product -> gekochte SKU,
- invloed van de blog op de verkoop,
- invloed van de first click, last click, assisted share en view-through,
- bronpaden die tot een aankoop leiden.
Wat onderscheidt deze module van eenvoudige analytics pixel
1. Meet verkoop, niet alleen weergaven en klikken
Een klik alleen zegt nog niets over de zakelijke waarde. Kowal Analytics koppelt frontend-events aan de winkelwagen, bestelling en omzet.
2. Werkt met het begrip area
De basiseenheid van analyse is area, dus een afgebakend gedeelte van de pagina dat je wilt meten.
Voorbeelden:
related_productsop PDP,upsell_productsop PDP,crosssell_productsin de winkelwagen,category_listingop de productlijst van een categorie,search_resultsin de zoekresultaten,wishlist_products,compare_products,blog_post_listing,blog_sidebar_categories,- een eigen promotionele box in CMS.
3. Maakt het ook mogelijk om object te analyseren
In elke area bevinden zich specifieke object, dus elementen die de gebruiker ziet en aanklikt.
Voorbeelden:
- een product in de sectie
related_products, - een blogpost in de lijst met posts,
- een blogcategorie in de sidebar,
- een promotiebanner,
- een CTA-link in een marketingbox.
Dat betekent dat het rapport niet stopt op het niveau:
- de related-sectie werkt
maar afdaalt naar het niveau:
- product X in de related-sectie verkoopt het best
- blogpost Y leidt tot het grootste aantal bestellingen
4. Kent de broncontext
De module slaat ook de broncontext op, dus waar het pad is begonnen.
Voorbeeld:
- de gebruiker is op de productpagina van
Affirm Water Bottle, - ziet
related_products, - klikt op
Zing Jump Rope, - gaat naar de PDP van dit product,
- voegt het toe aan de winkelwagen,
- en koopt uiteindelijk
Zing Jump Rope.
In dat geval kun je tonen:
source page=Affirm Water Bottle,area=related_products,clicked object=Zing Jump Rope,purchased sku=Zing Jump Rope.
Dit is precies het analyseniveau dat meestal ontbreekt in typische tools.
Hoe de belangrijkste begrippen te begrijpen
Area
Area is een sectie of blok van de pagina dat je wilt meten als bron van invloed op de verkoop.
Voorbeelden:
- sectie met gerelateerde producten,
- categorielijst,
- blogwidget,
- blogsidebar,
- promotiebanner,
- popup,
- eigen CMS-blok.
Object
Object is een specifiek element binnen area.
Voorbeelden:
- één product in een lijst,
- één blogpost,
- één blogcategorie,
- één tag,
- één slide in een slider,
- één banner in een promotiesectie.
Source Page
Source Page is de pagina vanaf waar de gebruiker het pad is gestart dat verband houdt met een bepaalde area.
Voorbeelden:
- bronproductpagina voor
related_products, - blogpost voor een link die naar een product leidt,
- categorielijst voor een productklik,
- zoekresultaten voor een aangeklikt product.
Purchased SKU
Dit is de specifieke SKU die is gekocht en waaraan we de invloed van een bepaalde area of object toeschrijven.
Welke gebieden kunnen worden gemeten
De module ondersteunt zowel native integraties als gebieden die via selectors zijn gedefinieerd.
Voorbeelden in e-commerce
related_productsupsell_productscrosssell_productscategory_listingsearch_resultswishlist_productscompare_products
Voorbeelden in content commerce
blog_post_listingblog_recent_posts_widgetblog_sidebar_recent_postsblog_sidebar_categoriesblog_sidebar_tagsblog_post_view
Aangepaste voorbeelden
homepage_promo_boxblack_friday_bannersummer_campaign_sliderai_recommendationscategory_top_cta
Welke rapporten de gebruiker krijgt
Analytics Dashboard
Dit dient voor een snel overzicht van de resultaten.
Het toont onder andere:
- attributed revenue,
- attributed orders,
- CTR,
- top areas,
- top supported products,
- top blog sources.
Area Report
Geeft antwoord op de vraag:
- welk gebied werkt,
- welke objecten daarin verkopen,
- uit welke bronnen de verkoop ontstaat.
Voorbeeld:
related_productslevert 12 bestellingen en 4 800 PLN omzet op,- het best verkochte product is
WB05-S-Orange, - de meest voorkomende bron van dit pad is het product
Affirm Water Bottle.
Product Context Report
Dit rapport is cruciaal voor productgebieden.
Het beantwoordt de vraag:
- vanaf welk bronproduct,
- op welk product is geklikt,
- en wat uiteindelijk is gekocht.
Voorbeeld:
source product=Affirm Water Bottle,clicked object=Zing Jump Rope,purchased sku=Zing Jump Rope,orders= 7,revenue= 840 PLN.
Blog Commerce Report
Toont de invloed van de blog op de verkoop.
Geeft antwoord op vragen:
- welke post verkoopt,
- welke blogcategorie verkoopt,
- welke tag tot bestellingen leidt,
- welke SKU's worden gekocht na binnenkomst via de blog.
Voorbeeld:
- de post
Hoe kies je een trainingsbidongenereerde 9 bestellingen, - de meest gekochte SKU na deze post is
Affirm Water Bottle.
Object Report
Hiermee kun je inzoomen op één concreet object.
Voorbeeld:
- één specifiek product in
related_products, - één specifieke blogpost in
blog_post_listing, - één specifieke blogcategorie in de sidebar.
Het rapport toont:
- klikken,
- bestellingen,
- omzet,
- bronpagina's,
- gekochte SKU's gekoppeld aan dit ene object.
Source Page Report
Dit is een rapport vanuit het omgekeerde perspectief.
In plaats van naar het object te kijken, kijk je naar één bronpagina en controleer je:
- welke aangeklikte objecten vanaf deze pagina verkopen,
- welke SKU's daarna worden gekocht,
- welke omzet deze specifieke pagina heeft gegenereerd als startpunt van het pad.
Voorbeeld:
- de productpagina
Affirm Water Bottleals source page, - de best verkopende objecten vanaf deze pagina zijn twee producten uit
related_products, - de totale omzet uit dit pad is 1 350 PLN.
Typische gebruiksscenario's
Optimalisatie van merchandising
De winkel kan vergelijken of:
related_productsbeter verkoopt danupsell_products,- cross-sell in de winkelwagen de verkoop echt afrondt,
- de categorielijst naar producten leidt die daadwerkelijk eindigen in een bestelling.
Bloganalyse
Het contentteam kan controleren:
- welke posts naar PDP leiden,
- welke posts helpen een product aan de winkelwagen toe te voegen,
- welke posts daadwerkelijk invloed hebben op de verkoop.
Opschonen van de winkel-layout
Als een sectie veel impressies heeft en weinig of geen invloed op de omzet, kan worden beoordeeld of:
- deze moet worden verbeterd,
- verplaatst,
- de inhoud moet worden vervangen,
- of volledig verwijderd.
Wijzigingen testen
Na een wijziging van layout, widget, blog of aanbevelingsmechanisme kun je vergelijken:
- de periode ervoor en erna,
- de impact op CTR,
- de impact op bestellingen,
- de impact op omzet.
Voor wie deze module is
De meeste waarde halen eruit:
- eigenaren van Magento-winkels,
- e-commerce managers,
- merchandisers,
- CRO-teams,
- content- en SEO-teams,
- bureaus die Magento-winkels ontwikkelen.
Samenvatting
Kowal Analytics verandert storefront-elementen in meetbare verkoopbronnen.
Het maakt het mogelijk om van de algemene vraag:
- werkt dit blok?
naar de concrete vraag te gaan:
- welk product, welke post, welke categorie of welke bronpagina genereert precies verkoop en welke omzet zit daarachter?
Installatiehandleiding voor Kowal Analytics
Vereisten
Zorg er vóór de installatie voor dat:
- de Magento 2-instantie correct werkt,
- Composer toegang heeft tot de package repository van Kowal,
- je CLI-toegang hebt tot
bin/magento, - op de omgeving cron en queue consumers kunnen worden uitgevoerd,
- de omgeving correct schrijfrechten heeft naar de database en naar
var/log.
Installatie via Composer
Voeg de Composer-repository toe:
composer config repositories.kowal composer https://repo.kowal.storeVoeg toegangsgegevens toe voor de private repository:
composer config http-basic.repo.kowal.store Installeer de module:
composer require kowal/module-analyticsDe module inschakelen
Voer de standaard Magento-commando's uit:
bin/magento module:enable Kowal_Analyticsbin/magento setup:upgradebin/magento cache:flushAls de winkel in production mode draait, voer dan ook uit:
bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flushAsynchrone processen starten
De module maakt gebruik van queues en asynchrone verwerking. Zonder dit zijn dashboard en rapporten niet compleet.
Start de vereiste consumers:
bin/magento queue:consumers:start kowal_analytics.raw_eventsbin/magento queue:consumers:start kowal_analytics.conversionbin/magento queue:consumers:start kowal_analytics.attributionMagento cron moet ook correct werken, omdat de module retry en backfill voor attributie gebruikt.
Basiscontrole:
bin/magento cron:runWat gebeurt er na de installatie
Na een correcte installatie doet de module het volgende:
- laadt de tracker op de storefront,
- slaat frontend-events op,
- koppelt de analytics-sessie aan
quote, - draagt analytics-identifiers over naar
sales_order, - slaat conversies en conversie-items op,
- berekent attributie van bestellingen naar area en object,
- biedt een dashboard en gedetailleerde rapporten in het Magento-beheerpaneel.
Waar controleren of de module werkt
Controleer na de installatie:
Kowal -> Analytics -> DashboardStores -> Configuration -> Analytics
Als de module correct actief is, zou je moeten zien:
- het dashboard van de module,
- een samenvattende widget op het native Magento-dashboard,
- een configuratiesectie in Stores -> Configuration.
Aanbevolen technische test na implementatie
Voer een eenvoudige end-to-end-test uit:
- Open de winkelpagina.
- Ga naar een productpagina.
- Klik op een getrackt element, bijvoorbeeld een product in
related_productsof een blogpost. - Voeg het product toe aan de winkelwagen.
- Plaats een bestelling.
- Controleer of events, conversies en attributie zijn opgeslagen.
Als debug is ingeschakeld, controleer dan:
- logs in de browserconsole,
var/log/kowal_analytics_debug.log
Wat de moeite waard is om in HTML te controleren
Als je wilt bevestigen dat tracking werkt bij het renderen van de pagina, controleer dan de aanwezigheid van de attributen:
data-kowal-track-areadata-kowal-track-area-iddata-kowal-track-objectdata-kowal-track-iddata-kowal-track-sku
Voorbeeld:
- de container van de sectie
related_productsmoetdata-kowal-track-area='related_products'hebben - een individueel product in deze sectie moet
data-kowal-track-object='product'en een eigendata-kowal-track-idhebben
Typische problemen na installatie
Dashboard is zichtbaar, maar er zijn geen gegevens
Controleer:
- of de consumers draaien,
- of cron werkt,
- of analytics in de configuratie is ingeschakeld,
- of de tracker op de frontend wordt geladen,
- of er op de pagina daadwerkelijk getrackte area aanwezig zijn.
Events worden opgeslagen, maar de attributie is onvolledig
Controleer:
- of de consumer
kowal_analytics.attributionwerkt, - of cron retry werkt,
- of de bron-events de database bereiken vóór de definitieve attributieberekening.
Custom area verschijnt niet in rapporten
Controleer:
- of de area-definitie correct is opgeslagen,
- of de selectors overeenkomen met de daadwerkelijke DOM,
- of runtime apply
data-kowal-track-*toevoegt, - of het betreffende gebied objectidentifiers heeft die nodig zijn voor verdere analyse.
Implementatieaanbeveling
De veiligste volgorde is als volgt:
- installeer de module,
- start consumers en cron,
- schakel debug in,
- test één eenvoudig productscenario,
- controleer het dashboard,
- breid de tracking pas daarna uit naar custom area.
Configuratiehandleiding voor Kowal Analytics
Navigatie in het beheerpaneel
Belangrijkste ingangen tot de module:
Kowal -> Analytics -> DashboardStores -> Configuration -> Analytics
Configuratiestructuur
Momenteel biedt de module drie hoofdgroepen instellingen.
1. General
Pad:
Stores -> Configuration -> Analytics -> General
Veld:
Enable Analytics
Betekenis:
- schakelt frontend-tracking en verdere analytics-verwerking in of uit voor de geselecteerde scope.
Aanbeveling:
- het beste per
store viewinschakelen na eerdere verificatie van trackers en consumers.
2. Debug
Pad:
Stores -> Configuration -> Analytics -> Debug
Velden:
Enable Backend Debug LogEnable Frontend Console Log
Betekenis:
- backend debug schrijft technische logs weg naar:
var/log/kowal_analytics_debug.log
- frontend debug schrijft trackerlogs weg naar de browserconsole.
Toepassing:
- installatie,
- QA,
- foutanalyse,
- tests van de selector assistant,
- bevestiging dat events in de pipeline terechtkomen.
Aanbeveling:
- inschakelen tijdens implementatie en tests,
- uitschakelen in de productieomgeving na afronding van de validatie.
3. Tools
Pad:
Stores -> Configuration -> Analytics -> Tools
Veld:
Enable Frontend Selector Assistant
Betekenis:
- toont een helper op de storefront die helpt bij het aanwijzen en voorbereiden van configuratie voor eigen area gebaseerd op selectors.
Toepassing:
- mapping van custom sections,
- analyse van de DOM-structuur,
- voorbereiding van area-definities zonder handmatige codebewerking.
Hoe de configuratie in de praktijk te begrijpen
Scope
De module werkt binnen Magento-scope, dus de configuratie kan verschillen voor:
default,website,store view.
Het veiligst is om de module te behandelen als een tool per store view, omdat:
- verschillende winkels een andere layout kunnen hebben,
- verschillende winkels andere blog-, CMS- en merchandisingsecties kunnen hebben,
- rapporten per store view operationeel veel betrouwbaarder zijn.
Hoe de basisbegrippen in de module te begrijpen
Area
Area is een afgebakend gedeelte van de pagina dat je wilt meten als bron van invloed op de verkoop.
Voorbeelden:
related_productsupsell_productscrosssell_productscategory_listingsearch_resultswishlist_productscompare_productsblog_post_listingblog_sidebar_categorieshomepage_promo_box
Object
Object is een specifiek element binnen area.
Voorbeelden:
- een individueel product in een lijst,
- één blogpost,
- één blogcategorie,
- één tag,
- één banner,
- één slide.
Source Page
Source Page is de pagina vanaf waar de gebruiker een interactie is gestart die verder tot verkoop leidde.
Voorbeelden:
- bronproductpagina voor
related_products, - blogpost voor het aangeklikte product,
- categorielijst voor het aangeklikte product,
- zoekresultaten voor het product.
Dashboard en rapporten
Analytics Dashboard
Dit is het hoofdscherm voor overzicht. Het toont:
- attributed revenue,
- attributed orders,
- average order value,
- CTR,
- top areas,
- top supported products,
- top blog sources,
- links naar gedetailleerde rapporten.
Dit scherm geeft antwoord op de vraag:
wat werkt het best
Area Report
Dit rapport geeft antwoord op vragen:
- welke area omzet genereert,
- welke objecten in die area verkopen,
- van welke source page de verkoop komt.
Voorbeeld:
related_productsheeft 18 bestellingen,- daarin verkoopt
Zing Jump Ropehet best, - de meest voorkomende bron van dit pad is de productpagina
Affirm Water Bottle.
Product Context Report
Dit is een rapport voor productgebieden zoals:
related_productsupsell_productscrosssell_productscategory_listingsearch_results
Het toont de relatie:
source product -> clicked object -> purchased SKU
Voorbeeld:
- de gebruiker bevindt zich op de PDP
Affirm Water Bottle, - klikt op
WB05-S-Orangeinrelated_products, - koopt
WB05-S-Orange.
Blog Commerce Report
Dit is een rapport voor bloggebieden:
blog_post_listingblog_recent_posts_widgetblog_sidebar_recent_postsblog_sidebar_categoriesblog_sidebar_tagsblog_post_view
Het geeft antwoord op vragen:
- welke post verkoopt,
- welke blogcategorie verkoopt,
- welke tag de verkoop ondersteunt,
- welke SKU's worden gekocht na binnenkomst via de blog.
Object Report
Dit is een rapport voor één specifiek object.
Voorbeeld:
- één product in
related_products, - één blogpost uit
blog_post_listing, - één blogcategorie uit
blog_sidebar_categories.
Het toont:
- hoeveel impressies het had,
- hoeveel klikken het had,
- hoeveel bestellingen het genereerde,
- welke omzet eraan is toegeschreven,
- van welke source page deze paden afkomstig waren.
Source Page Report
Dit is een rapport voor één specifieke bronpagina.
Voorbeeld:
- de productpagina
Affirm Water Bottle, - de blogpost
Hoe kies je een trainingsbidon, - de categorielijst
Hardloopschoenen.
Het toont:
- welke clicked object vanaf deze pagina verkopen,
- welke SKU's worden gekocht na binnenkomst vanaf deze pagina,
- hoeveel bestellingen en omzet deze specifieke pagina genereert als startpunt van het pad.
Attributiemodellen
Beschikbare modellen:
Last ClickFirst ClickAssistedView Through
Hoe je ze leest:
Last Click
Het beste voor de vraag:
- welk element de verkoop direct heeft afgerond.
First Click
Het beste voor de vraag:
- welk element het pad naar de aankoop heeft gestart.
Assisted
Het beste voor de vraag:
- welk element aan het pad heeft deelgenomen, ook als het niet de laatste klik was.
View Through
Het beste voor de vraag:
- of alleen de blootstelling van de sectie invloed had op de verkoop, ook zonder klik.
Configuratie van custom area
Je kunt een custom area voorbereiden via Frontend Selector Assistant.
Typische workflow:
- Schakel
Enable Frontend Selector Assistantin. - Open de storefront.
- Start de assistant.
- Wijs het gebied aan.
- Controleer de voorgestelde
container selector. - Controleer de voorgestelde
item selector. - Controleer
link selector. - Sla de definitie op.
- Bevestig dat runtime apply
data-kowal-track-*heeft toegevoegd. - Test de klik en de overgang naar rapporten.
Voorbeeld van custom area
Stel dat je op de homepage een promotionele box hebt met drie tegels.
Je kunt definiëren:
area_code = homepage_promo_boxobject_type = promotioncontainer_selector = .homepage-promoitem_selector = .homepage-promo__itemlink_selector = .homepage-promo__link
Dan toont het rapport:
- welke tegel is aangeklikt,
- welke tot aankoop leidde,
- welke omzet deze heeft gegenereerd.
Testworkflow na configuratie
De meest logische volgorde:
- analytics inschakelen,
- backend debug inschakelen,
- frontend console log inschakelen,
- een gebruikersscenario doorlopen,
- het dashboard controleren,
- het area report controleren,
- afdalen naar object report of source page report,
- debug uitschakelen nadat de correctheid is bevestigd.
Operationele aanbevelingen
- houd consumers onder supervisor of systemd,
- zorg ervoor dat Magento cron voortdurend werkt,
- controleer na wijzigingen in het thema of selectors van custom area nog steeds bij de DOM passen,
- vergelijk na merchandisingwijzigingen de resultaten per area,
- interpreteer CTR niet op zichzelf als succes zonder omzet en bestellingen te controleren.
























