Skip to content

spanishgringo/ga-campaign-tracking

Repository files navigation

Google Analytics Campaign Tracking Script

Use this plugin to pull campaign and other data out of the Google Analytics cookie for use in your web app or passing into your MAP and CRM for full closed-loop source and ROI reporting.

Written and maintained by Michael Freeman & Ben Word.

Usage

  • Place the ga-cookie.js script above your standard ga.js tracking code
  • Set the defaults:
    • gaCookie.domainName: if you do not use standard subdomain level GA tracking, set this to the same domain that you use for your GA cookie
    • gaCookie.strPath: if you do not use standard subdomain level GA tracking, set this to the same cookie path that you use for your GA cookie
    • gaCookie.prefix: To differentiate values that come from your website instead of other channels, this object will attach a prefix in front of the Medium value. Default is "WEB-" but you can set it to anything, including empty ""
  • Call gaCookie.getVisitData(); once your form is loaded (in the case of an AJAX loaded form, make sure it is in the DOM before calling. I suggest binding to an using the "one method in jQuery when the form receives focus or shows")

Default values that are populated in webforms

If you do not modify the script you will need to ensure that your hidden fields on your forms include the proper fields with the correct name attributes.

  • gaLandingPage: The Landing Page of the current session
  • gaCamMed: Google Analytics Campaign Medium
  • gaSource: Google Analytics Campaign Source
  • gaCamName: Google Analytics Campaign Name (for Campaign Name to appear from Paid Search traffic you must manually tag your ad URLs, even for AdWords)
  • gaCamKW: Google Analytics Campaign Keyword (for KW to appear from Paid Search traffic you must manually tag your ad URLs, even for AdWords)
  • gaCamContent: Google Analytics Campaign Content (for Content to appear from Paid Search traffic you must manually tag your ad URLs, even for AdWords)
  • gaAdWordsID: Google AdWords GACLID value - this is a value that can be used to later upload CRM conversion data back into AdWords. More information about uploading offline conversions into AdWords

Other values that can be accessed from the GA cookie

  • gaCookie.getFirstVisitTime([destinationFieldName]): First Date/Time that this visitor came to your website
  • gaCookie.getLastVisitTime([destinationFieldName]): Most recent Date/Time that this visitor came to your website
  • gaCookie.getSessionStartTime([destinationFieldName]): Date/Time that current session started
  • gaCookie.getSessionVisits([destinationFieldName]): Total number of sessions that this visitor has made to your site
  • gaCookie.getNumberCampaigns([destinationFieldName]): Total number of different campaigns that this visitor has used to visit your site
  • gaCookie.getGAVisitorID([destinationFieldName]): Unique GA Visitor ID
  • gaCookie.getCustomVar(customVarNum [, destinationFieldName]): Custom variables are not always persisted in the GA cookie. It depends on the custom variable's scope. The custom variable is accessible if it is a session-level scoped custom variable. Page-level scoe custom variables only appear during the page view where the custom variable was set. Visitor level custom variables are set one time and then tracked via the visitorID on the backend

FAQ

  • Q: Can you use this code with Universal Analytics (UA)?
  • A: UA does not support cookie based campaign tracking. Everything is done in the cloud. However, you can run the traditional ga.js script in localservermode to take advantage of the cookie tracking. Download a copy locally of ga.js and setup code that looks similar to this:
<script>    
    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', "UA-xxxxx-x"]);
    _gaq.push(['_setDomainName', "YOURDOMAIN"]);
    //place a blank 1x1 gif on your server with name __utm.gif
    _gaq.push(['_setLocalGifPath', "//YOURDOMAIN/PATH/__utm.gif"]);
    _gaq.push(['_setLocalServerMode']);

    _gaq.push(['_trackPageview']);

    (function() {var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
                   //ga.src = ('https:' == document.location.protocol ? 'https://' : 'http://') + 'stats.g.doubleclick.net/dc.js';
                   //ga.src = ('https:' == document.location.protocol ? 'https://' : 'http://') + 'YOURDOMAIN/PATH/ga.js';
                   var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);}
                )();
</script>

License

MIT License

Acknowledgments

Various components originally based on the following:

Releases

No releases published

Packages

No packages published