← Tilbake til bloggen
googleanalytics tracking event documentation opensource

Vi lanserer open source rammeverk for dokumentasjon av Google Analytics events

Vi lanserer open source rammeverk for dokumentasjon av Google Analytics events

Det siste året har vi jobbet målrettet med å bygge spisskompetanse på Google Analytics internt. En av de største utfordringene vi har støtt på, er manglende dokumentasjon av events – spesielt custom events. Dette har gjort det krevende å holde oversikt: Hvilke events finnes? Hva brukes de til? Hvordan ser de ut, og hvor i systemet brukes de?

Derfor har vi utviklet et nytt rammeverk: GA Event Documentation – og vi har valgt å gjøre det open source.

Hvorfor laget vi dette?

Vi har hatt et økende behov, og fokus på å forstå brukeratferd, måle effekten av endringer og avdekke forbedringsmuligheter. Det har ført til at vi har laget mange nye GA-events. Med flere events har det blitt vanskeligere å holde styr på hva som finnes – både for utviklere, team-medlemmer og andre stakeholders.

Hva gjør verktøyet?

Dette rammeverket lar deg dokumentere GA-events på en strukturert og oversiktlig måte. Slik fungerer det:

  • Du får et webgrensesnitt hvor du kan bla gjennom og søke etter hendelser, med informasjon som navn, type (server- eller klient-side), beskrivelse, JSON-struktur og kategorier.
  • Nye hendelser blir automatisk oppdaget gjennom BigQuery-jobber som kjører jevnlig (for eksempel månedlig).
  • Dokumentasjonen kan oppdateres direkte i grensesnittet – ingen behov for pull requests eller å oppdatere Excel-ark.

Bak kulissene benytter vi .NET 8 Azure Functions som backend, React.js i frontend, og Google Cloud (spesielt BigQuery) til datainnsamling. Oppsettet er enkelt å komme i gang med – bare følg noen enkle steg beskrevet i dokumentasjonen.

Klar til å tas i bruk

Enten du er utvikler eller analytiker, vet du hvor viktig det er med god oversikt over events. Rammeverket er gratis, lisensiert under MIT, og klart til bruk – eller tilpasning – etter dine behov.

Alt du trenger finner du på GitHub: dokumentasjon, installasjonsskript og selve kildekoden.

Et åpent og levende prosjekt

Vi håper dette rammeverket kan bidra til bedre og mer standardisert dokumentasjon i arbeidet med events for Google Analytics. Prosjektet er åpent kildekode, og vi ønsker oss både brukere og bidragsytere. Har du innspill, ideer eller endringsforslag? Vi vil gjerne høre fra deg!

👉 GitHub-repoet finner du her: https://github.com/Komplett/GA.EventDocumentation

Verktøyet er utviklet av undertegnede i Komplett, og vi gleder oss til å se hvordan andre kan ta det i bruk og bygge videre på det.

Skrevet av: Mikkel Holmberg, Webutvikler & GTM- og sporingsingeniør