Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 2.11 KB

NOTES.md

File metadata and controls

62 lines (45 loc) · 2.11 KB

Thumbtrack Analytics

Thumbtrack is a "mobile first" web app for conferences. Users can browse the conference schedule, swipe and dropdown to view events in parallel sessions, and pin events they want to see.

This repo contains an analysis of the site traffic and user events during RailsConf 2019.

Google Analytics

Service Account Credentials

  1. Create a new project through the Google Developer's Console.
  2. Enable the Google Analytics Reporting API.
  3. Find out what kind of credentials are needed:
    • Which API are you using? Analytics Reporting API
    • Where will you be calling the API from? Other UI (e.g. Windows, CLI tool)
    • What data will you be accessing? Application data
  4. Create a service account.
    • Service account name: thumbtrack-analytics
    • Role: Project Viewer
    • Service account ID: thumbtrack-analytics (@thumbtrack.iam.gserviceaccount.com)
    • Key type: JSON
  5. Move the key into the project as "google-service-account-key.json"

Analytics Reporting

  1. Extract the email address from the generated service account key, and add it as a User to the Google Analytics project.
  2. Grab the View ID for the web site, and store it in "google-analytics-view.json".

Helpful links

Python environment

pipenv install --dev

Getting the data

The code for downloading and processing data via the Google Analytics API is in the python module "analytics".

python -m analytics --list  # list available reports
python -m analytics --all   # collect all report data

Compiling the report

The report, report.Rmd is written in Rmarkdown, and compiled to output formats using the R package "rmarkdown". The build process is contained in the "Makefile" for the project.

make