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

FacebookTwitterInstagramYoutubeTwitch