Configuratiehandleiding voor Kowal Analytics

Navigatie in het beheerpanel

Belangrijkste ingangen naar de module:

• Kowal -> Analytics -> Dashboard
• Stores -> Configuration -> Analytics

Configuratiestructuur

De module biedt momenteel drie hoofdgroepen met instellingen.

1. General

Pad:

• Stores -> Configuration -> Analytics -> General

Veld:

• Enable Analytics

Betekenis:

• schakelt frontend tracking en verdere analytics-verwerking in of uit voor de gekozen scope.

Aanbeveling:

• bij voorkeur inschakelen per store view na eerdere verificatie van trackers en consumers.

2. Debug

Pad:

• Stores -> Configuration -> Analytics -> Debug

Velden:

• Enable Backend Debug Log
• Enable Frontend Console Log

Betekenis:

• backend debug schrijft technische logs naar:
  • var/log/kowal_analytics_debug.log
• frontend debug schrijft trackerlogs naar de browserconsole.

Gebruik:

• installatie,
• QA,
• foutanalyse,
• tests van de selector assistant,
• bevestiging dat events in de pipeline terechtkomen.

Aanbeveling:

• inschakelen tijdens implementatie en tests,
• uitschakelen op de productieomgeving na voltooiing 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 op basis van selectors.

Gebruik:

• mapping van custom section,
• analyse van de DOM-structuur,
• voorbereiding van area-definities zonder handmatige codebewerking.

Hoe u de configuratie in de praktijk moet begrijpen

Scope

De module werkt binnen de 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 u de basisbegrippen in de module moet begrijpen

Area

Area is een afgebakend gebied van de pagina dat u wilt meten als bron van invloed op verkoop.

Voorbeelden:

• related_products
• upsell_products
• crosssell_products
• category_listing
• search_results
• wishlist_products
• compare_products
• blog_post_listing
• blog_sidebar_categories
• homepage_promo_box

Object

Object is een specifiek element binnen area.

Voorbeelden:

• een afzonderlijk product op de lijst,
• één blogartikel,
• één blogcategorie,
• één tag,
• één banner,
• één slide.

Source Page

Source Page is de pagina van waaruit de gebruiker een interactie is aangegaan die verder tot verkoop leidt.

Voorbeelden:

• productpagina van het bronproduct voor related_products,
• blogartikel voor het aangeklikte product,
• categorielisting 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 beantwoordt de vraag:

• co działa najlepiej

Area Report

Dit rapport beantwoordt de vragen:

• welk area omzet genereert,
• welke object in dit area verkopen,
• uit welke source page de verkoop komt.

Voorbeeld:

• related_products heeft 18 bestellingen,
• Zing Jump Rope verkoopt daarin het best,
• de bron van dit pad is meestal de productpagina Affirm Water Bottle.

Product Context Report

Dit is een rapport voor productgebieden zoals:

• related_products
• upsell_products
• crosssell_products
• category_listing
• search_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-Orange in related_products,
• koopt WB05-S-Orange.

Blog Commerce Report

Dit is een rapport voor bloggebieden:

• blog_post_listing
• blog_recent_posts_widget
• blog_sidebar_recent_posts
• blog_sidebar_categories
• blog_sidebar_tags
• blog_post_view

Het beantwoordt de vragen:

• welke post verkoopt,
• welke blogcategorie verkoopt,
• welke tag ondersteunt verkoop,
• 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 blogartikel uit blog_post_listing,
• één blogcategorie uit blog_sidebar_categories.

Het toont:

• hoeveel impressies het had,
• hoeveel klikken het had,
• hoeveel bestellingen het heeft gegenereerd,
• welke omzet eraan is toegeschreven,
• uit welke source page deze paden kwamen.

Source Page Report

Dit is een rapport voor één specifieke bronpagina.

Voorbeeld:

• productpagina Affirm Water Bottle,
• blogartikel Jak wybrać bidon treningowy,
• categorielisting Buty do biegania.

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 als startpunt van het pad genereert.

Attributiemodellen

Beschikbare modellen:

• Last Click
• First Click
• Assisted
• View Through

Hoe u ze moet lezen:

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 aankoop is gestart.

Assisted

Het beste voor de vraag:

• welk element deel uitmaakte van het pad, ook als het niet de laatste klik was.

View Through

Het beste voor de vraag:

• of alleen al de exposure van een sectie invloed had op verkoop, zelfs zonder klik.

Configuratie van custom area

Custom area kunt u voorbereiden via Frontend Selector Assistant.

Typische workflow:

1. Schakel Enable Frontend Selector Assistant in.
2. Open de storefront.
3. Start de assistant.
4. Wijs het gebied aan.
5. Controleer de voorgestelde container selector.
6. Controleer de voorgestelde item selector.
7. Controleer link selector.
8. Sla de definitie op.
9. Bevestig dat runtime apply data-kowal-track-* heeft toegevoegd.
10. Test een klik en de overgang naar rapporten.

Voorbeeld van custom area

Stel dat u op de homepage een promotiebox met drie tegels hebt.

U kunt definiëren:

• area_code = homepage_promo_box
• object_type = promotion
• container_selector = .homepage-promo
• item_selector = .homepage-promo__item
• link_selector = .homepage-promo__link

Dan toont het rapport:

• op welke tegel werd geklikt,
• welke tot aankoop leidde,
• welke omzet deze genereerde.

Testworkflow na configuratie

De meest logische volgorde:

1. analytics inschakelen,
2. backend debug inschakelen,
3. frontend console log inschakelen,
4. een gebruikersscenario doorlopen,
5. het dashboard controleren,
6. het area report controleren,
7. doorgaan naar object report of source page report,
8. debug uitschakelen na bevestiging van de correctheid.

Operationele aanbevelingen

• beheer consumers met supervisor of systemd,
• zorg ervoor dat Magento cron continu draait,
• controleer na themawijzigingen of selectors van custom area nog steeds passen bij de DOM,
• vergelijk na merchandisingwijzigingen resultaten per area,
• interpreteer CTR alleen niet als succes zonder omzet en bestellingen te controleren.

Installatiehandleiding voor Kowal Analytics

Vereisten

Controleer vóór de installatie of:

• de Magento 2-instantie correct werkt,
• Composer toegang heeft tot de pakketrepository van Kowal,
• u CLI-toegang hebt tot bin/magento,
• cron en queue consumers in de omgeving kunnen worden uitgevoerd,
• de omgeving correct schrijft naar de database en naar var/log.

Installatie via Composer

Voeg de Composer-repository toe:

Toegangsgegevens voor de Composer-repository, het e-mailadres van de klant en de licentietoken, ontvangt u per e-mail na aankoop. Ze zijn ook beschikbaar in het klantenpaneel na inloggen op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van uw account en TWOJ_TOKEN door de ontvangen token. Voer de opdrachten uit in de hoofdmap van Magento.

composer config repositories.kowal composer https://repo.kowal.store

Voeg de toegangsgegevens voor de privérepository toe:

composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

Installeer de module:

composer require kowal/module-analytics

Module inschakelen

Voer de standaard Magento-commando’s uit:

bin/magento module:enable Kowal_Analyticsbin/magento setup:upgradebin/magento cache:flush

Als de winkel in production mode draait, voer dan ook uit:

bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:flush

Asynchrone processen starten

De module gebruikt 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.attribution

Magento cron moet ook correct werken, omdat de module retry en backfill voor attributie gebruikt.

Basiscontrole:

bin/magento cron:run

Wat er na installatie gebeurt

Na een correcte installatie:

• laadt de module de tracker op de storefront,
• slaat frontend events op,
• koppelt de analytics-sessie aan quote,
• verplaatst analytics-identifiers naar sales_order,
• slaat conversies en conversie-items op,
• berekent attributie van bestellingen aan area en object,
• maakt dashboard en gedetailleerde rapporten beschikbaar in het Magento-paneel.

Waar u kunt controleren of de module werkt

Controleer na installatie:

• Kowal -> Analytics -> Dashboard
• Stores -> Configuration -> Analytics

Als de module correct actief is, zou u moeten zien:

• het moduledashboard,
• een samenvattingswidget op het native Magento-dashboard,
• de configuratiesectie in Stores -> Configuration.

Aanbevolen technische test na implementatie

Voer een eenvoudige end-to-end-test uit:

1. Open de winkelpagina.
2. Ga naar een productpagina.
3. Klik op een getrackt element, bijvoorbeeld een product in related_products of een blogartikel.
4. Voeg het product toe aan de winkelwagen.
5. Plaats een bestelling.
6. 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 u wilt bevestigen dat tracking werkt op de render van de pagina, controleer dan de aanwezigheid van attributen:

• data-kowal-track-area
• data-kowal-track-area-id
• data-kowal-track-object
• data-kowal-track-id
• data-kowal-track-sku

Voorbeeld:

• de container van de sectie related_products moet data-kowal-track-area='related_products' hebben
• een afzonderlijk product in deze sectie moet data-kowal-track-object='product' en een eigen data-kowal-track-id hebben

Typische problemen na installatie

Het dashboard is zichtbaar, maar er zijn geen gegevens

Controleer:

• of de consumers draaien,
• of cron werkt,
• of analytics is ingeschakeld in de configuratie,
• of de tracker op de frontend wordt geladen,
• of er op de pagina daadwerkelijk getrackte area zijn.

Gebeurtenissen worden opgeslagen, maar de attributie is onvolledig

Controleer:

• of consumer kowal_analytics.attribution werkt,
• of cron retry werkt,
• of bron-events de database bereiken vóór de definitieve herberekening van attributie.

Custom area verschijnt niet in rapporten

Controleer:

• of de area-definitie correct is opgeslagen,
• of de selectors overeenkomen met de werkelijke DOM,
• of runtime apply data-kowal-track-* toevoegt,
• of het betreffende gebied object-identifiers heeft die nodig zijn voor verdere analyse.

Implementatieadvies

De veiligste volgorde is:

1. de module installeren,
2. consumers en cron starten,
3. debug inschakelen,
4. één eenvoudig productscenario testen,
5. het dashboard controleren,
6. pas daarna tracking uitbreiden naar custom area.