GoogleAnalyticsTracker - A C# library for tracking Google Analytics
Switch branches/tags
Nothing to show
Pull request Compare This branch is 224 commits behind maartenba:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.nuget
GoogleAnalyticsTracker
.gitignore
GoogleAnalyticsTracker.sln
LICENSE.md
README.md
build.cmd

README.md

GoogleAnalyticsTracker

GoogleAnalyticsTracker - A C# library for tracking Google Analytics

Like this project?

via PayPal.

What can it be used for?

GoogleAnalyticsTracker was created to have a means of tracking specific URL's directly from C#. For example, when creating an API using the ASP.NET MVC framework, GoogleAnalyticsTracker enables you to track usage of the API by calling directly into Google Analytics.

Get it on NuGet!

Install-Package GoogleAnalyticsTracker

Example usage

Using GoogleAnalyticsTracker is very straightforward. In your code, add the following structure wherever you want to track page views:

using (Tracker tracker = new Tracker("UA-XXXXXX-XX", "www.example.org"))
{
    tracker.TrackPageView("My API - Create", "api/create");
    tracker.TrackPageView("MY API - List", "api/list");
}

Or without a using block:

Tracker tracker = new Tracker("UA-XXXXXX-XX", "www.example.org");
tracker.TrackPageView("My API - Create", "api/create");

A number of extension methods are available which use the provided HttpContext as the source for URL and user propertires:

Tracker tracker = new Tracker("UA-XXXXXX-XX", "www.example.org");
tracker.TrackPageView(HttpContext, "My API - Create");

Finally, an ActionFilter for use with ASP.NET MVC is available:

[ActionTracking("UA-XXXXXX-XX", "www.example.org")]
public class ApiController
    : Controller
{
    public JsonResult Create()
    {
        return Json(true);
    }
}

This filter can also be applied as a global action filter, optionally filtering the requests to log:

public class MvcApplication : System.Web.HttpApplication
{
    public static void RegisterGlobalFilters(GlobalFilterCollection filters)
    {
        filters.Add(new HandleErrorAttribute());
        filters.Add(new ActionTrackingAttribute(
            "UA-XXXXXX-XX", "www.example.org",
            action => action.ControllerDescriptor.ControllerName == "Api")
        );
    }
}

License

MS-PL License

Building the source

After cloning the repository, run build.cmd. A folder named "Build" will be created and populated with:

  • Assemblies
  • PDB files
  • NuGet package

Who uses GoogleAnalyticsTracker?