GoogleAnalyticsTracker - A C# library for tracking Google Analytics
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.
Note that for GoogleAnalyticsTracker to work, you should configure Google Analytics as a website. This library will not work when the GOogle Analytics account is configured as an app.
Install-Package GoogleAnalyticsTracker
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")
);
}
}
GoogleAnalyticsTracker does not track your users. It simply serves as an interface to Google Analytics where you should provide all tracking data that is required. Of course. GoogleAnalyticsTracker sends some data that can be inferred from usage, such as the hostname on which it is running, but not the hostname of your client. Sessions are also untracked: every event that is tracked counts as a new unique visitor to Google Analytics.
- If you do need to track user sessions, implement a custom IAnalyticsSession and pass it to the constructor of the Tracker object.
- If you do need to track actual user data, it can be set on the Tracker object using its properties like Hostname, Language, UserAgent and so on.
After cloning the repository, run build.cmd. A folder named "Build" will be created and populated with:
- Assemblies
- PDB files
- NuGet package