Metadata-Version: 1.1
Name: django-google-analytics-app
Version: 2.0.1
Summary: Django Google Analytics app allowing for server side/non-js tracking.
Home-page: http://github.com/praekelt/django-google-analytics
Author: Praekelt Foundation
Author-email: dev@praekelt.com
License: BSD
Description: Django Google Analytics
        =======================
        **Django Google Analytics brings the power of server side/non-js Google Analytics to your Django projects**
        
        .. contents:: Contents
            :depth: 3
        
        Installation
        ------------
        
        #. Install or add ``django-google-analytics`` to your Python path.
        #. Add ``google_analytics`` to you ``INSTALLED_APPS`` setting.
        #. Add URL include to your project's ``urls.py`` file::
        
            (r'^djga/', include('google_analytics.urls')),
        
        #. Specify a Google Analytics `tracking code <https://support.google.com/analytics/bin/answer.py?hl=en&answer=1008080>`_, i.e.::
        
            GOOGLE_ANALYTICS = {
                'google_analytics_id': 'xxx',
            }
        
           where ``xxx`` is your tracking code.
        
        #. If you intend tracking through middleware and Celery remember to `install Celery and run its worker process <http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html>`_.
        
        Usage
        -----
        
        There are two ways to add tracking to your pages.
        
        1. HTML tag
        ***********
        
        Using ``<img/>`` and sticking it in your ``base.html``::
        
            {% load google_analytics_tags %}
            <div style="display:none">
                <img src="{% google_analytics %}" width="0" height="0" />
            </div>
        
        2. Middleware + Celery
        **********************
        
        Using Django's middleware, you can process every request and use Celery to make the request to Google Analytics::
        
            MIDDLEWARE_CLASSES = (
                'google_analytics.middleware.GoogleAnalyticsMiddleware',
            )
        
        You have to add ``google_analytics`` to your ``CELERY_IMPORTS``::
        
            CELERY_IMPORTS = ('google_analytics.tasks')
        
        You can also specify paths that will be excluded when tracking::
        
            GOOGLE_ANALYTICS_IGNORE_PATH = ['/health/', ]
        
        Authors
        =======
        
        Praekelt Foundation
        -------------------
        
        * Hedley Roos
        * Milton Tony
        * Shaun Sephton
        
        Unomena
        -------
        
        * Euan Jonker
        
        Changelog
        =========
        
        2.0.1
        -----
        #. Use correct URL for GA Measurement Protocol v1
        
        2.0.0
        -----
        #. Upgrade to GA Measurement Protocol v1
        
        1.0.0
        -----
        #. Make compatible with Django 1.6
        
        0.0.5
        -----
        #. Removed Jmbo dependency, renamed.
        
        0.0.4
        -----
        #. Better packaging.
        
        0.0.3
        -----
        #. Fork, rename, re-license from panomena-analytics.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
