django-ga-mail app

A reusable Django app that sends google analytics report by email.

Installation

To get the latest stable release from PyPi

$ pip install django-ga-mail

To get the latest commit from GitHub

$ pip install -e git+git://github.com/nanvel/django-ga-mail.git#egg=ga_mail

Add ga_mail to your INSTALLED_APPS

INSTALLED_APPS = (
    ...,
    'ga_mail',
)

Specify next variables in settings:

GA_PROFILE_ID = 12345678
GA_USERNAME = '[email protected]'
# don't use your working account here,
# create another one for analytics and give it access to ga profile
GA_PASSWORD = 'somepass'
GA_SOURCE_APP_NAME = 'some.site',
ANALYTICS_BLOCKS = (
    'new_visitors_30days_today',
    'new_visitors_7days_today_vs_14days_7days',
    'pageviews_7days_today')

Check that MANAGERS variable contains necessary emails.

Available blocks:

• returning_visitors_7days_today
• new_visitors_7days_today
• new_visitors_30days_today
• new_visitors_7days_today_vs_14days_7days
• new_visitors_7days_today_vs_returning_visitors_7days_today
• pageviews_7days_today
• countries_30days_today

Call python manage.py ga_mail to send analytics report.

Contribute

If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
$ virtualenv .env --no-site-packages
$ source .env/bin/activate
$ python setup.py install
$ pip install -r test_requirements.txt

$ git co -b feature_branch master
# Implement your feature and tests
$ git add . && git commit
$ git push -u origin feature_branch
# Send us a pull request for your feature branch