Skip to content

A simple Python class for parsing useful visitor and referral data from a Google Analytics cookie.

License

Notifications You must be signed in to change notification settings

tedtieken/Python-Google-Analytics-Cookie-Parser

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Google Analytics Cookie Parser

Python Google Analytics Cookie Parser is a simple class for parsing useful visitor and referral data from a Google Analytics cookie.

Utilize it during your sign up process in order to permanently store informations about where your customers came from, which opens the door for all sorts of useful metrics...

Cookie Breakdown

From utma to utmz is a decent blog post that explains, at a high level, the various cookies Google Analytics uses to store data. The two most interesting (at least to me) are the utma and utmz cookies:

  • utma is a persistent cookie that tracks the number of visits, and times of the first and last visit
  • utmz keeps track of all the referral information, with useful nuggets like ad campaigns and referring domain or search engine

Usage

Instantiate an object with two keyword arguments containing the strings contained in the two cookies. Here's an example that will work on Pylons:

from path.to.google_analytics_cookie import GoogleAnalyticsCookie
utmz = request.cookies['__utmz'] if 'utmz' in request.cookies else None
utma = request.cookies['__utma'] if 'utma' in request.cookies else None
gac = GoogleAnalyticsCookie(utmz=utmz, utma=utma)

In Django: from path.to.google_analytics_cookie import GoogleAnalyticsCookie utmz = request.COOKIES['__utmz'] if '__utmz' in request.COOKIES else None utma = request.COOKIES['__utma'] if '__utma' in request.COOKIES else None gac = GoogleAnalyticsCookie(utmz=utmz, utma=utma)

Your object will have utma and utmz attributes that are dictionaries with the following keys:

gac.utma['domain_hash']
gac.utma['random_id']
gac.utma['first_visit_at']
gac.utma['previous_visit_at']
gac.utma['current_visit_at']
gac.utma['session_counter']

gac.utmz['domain_hash']
gac.utmz['timestamp']
gac.utmz['session_counter']
gac.utmz['campaign_number']
gac.utmz['campaign_data']['source']
gac.utmz['campaign_data']['name']
gac.utmz['campaign_data']['medium']
gac.utmz['campaign_data']['term']
gac.utmz['campaign_data']['content']

Happy data mining!

About

A simple Python class for parsing useful visitor and referral data from a Google Analytics cookie.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Python 100.0%