Skip to content

chrpr/pyganalytics

Repository files navigation

pyganalytics

A first cut at basic code to harvest specific dimensions and metrics from Google Analytics.

Installation

See reqiurements.pip for a list of dependencies. If you're running Ananconda, you can create a new environment with:

	% conda create --name pyganalytics python=2.7
	% activate pyganalytics (WIN)
	% source activate pyganalytics (Linux)

Otherwise, use Virtual Environment:

	% virtualenv --no-site-packages pyganalytics
	% source pyganalytics/bin/activate (Linux)

And install Requirements

	% pip install -r requirements.pip
Setup

You'll need to set up authentication.

  • Create and authorize a project at Developers Console: console.developers.google.com
  • Rename client_secret.json.template to client_secret.json
  • Add Client ID & Client Secret values from Developers Console
  • On first use, you will be prompted to authorize the app via a browser window.
Usage
  • Rename config.yml.template to config.yml

  • Add the ID for the view you want to analyze

    • Under Analytics, select "Admin"
    • Select an Account, Property, and View
    • Click "View Settings"
    • Copy and paste "View ID" into config.yml
  • By default, this configuration gives counts of pageviews by page

    • You can change your metrics (only supports one at a time)
    • You can change dimensions (supports a comma separated list)
  • Requires 3 arguments:

    • Output file name

    • Configuration yml file (supports multiple configurations)

    • Start Date (date to begin harvesting from)

    • End Date (default is current date)

        # python analytics.py -o test.csv -c nyu.yml -f 2015-11-01
      
  • By default, it runs in "weekly mode", but if you see "sampling", can be changed to daily.

    • Change rrule.WEEKLY to rrule.DAILY
    • Change timedelta(days=6) to timedelta(days=0)

Note, the code herein is based on an older iteration of Google's HelloAnalyticsAPI Python code: https://developers.google.com/analytics/devguides/reporting/core/v3/quickstart/service-py

It is therefore licensed under an Apache 2.0 License.

About

Python Google Analytics Harvester

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages