Java API for Google Analytics Measurement Protocol
Java API for Google Analytics Measurement Protocol (part of Universal Analytics). This library
is released under liberal Apache Open source License 2.0
Google Analytics Measurement Protocol is new tracking protocol, which will replace the legacy Tracking protocol.
This protocol is documented at https://developers.google.com/analytics/devguides/collection/protocol/v1/
The library is available in Maven Central. Add the following dependency and you are good to go.
<dependency>
<groupId>com.brsanthu</groupId>
<artifactId>google-analytics-java</artifactId>
<version>1.1.1</version>
</dependency>
To get a local build, do
git clone https://github.com/brsanthu/google-analytics-java.git
mvn install
View Javadocs here http://brsanthu.github.io/google-analytics-java/javadocs/
Features
This library implements the measurement protocol with following features.
- Supports all parameters and hit types.
- Able to configure default parameters, which would be used for each request.
- Type safe data types as appropriate (String, Integer, Double and Boolean)
- Convenient hit specific request types for easy construction.
- Synchronous or Asynchronous Event Processing.
- Support for delayed request construction.
- Asynchronous processing uses Java Concurrent Executor Service.
- Uses the latest Apache Http Client (4.3) for high performing event posting.
- Event posting can be enabled/disabled at run time at configuration level.
- Supports connections via Proxy
- Gathers some basic information from the underlying Jvm (File Encoding, User Language, Screen Size, Color Depth etc)
- Validates the request and can throw exception or log warning if validation fails (still wip)
- Logging uses SLF4J api
- Gathers basic stats (number of events posted for each hit type) if requested in the configuration.
- Implementation is Thread Safe
- Jar files are OSGi ready, so could be used with Eclipse
- Build against Java 1.6
- Complete Measurement Protocol parameter information is made available as Javadocs
Version History
Version 1.1.1 - May 21 2014
- Fixed the issue #14. Https Collection url has been updated to latest one.
- Fixed the issue #15. Added new parameter User Id (uid). As part of this, another change was made to move initializing the default ClientId parameter from GoogleAnalyticsRequest to DefaultRequest. This way, whatever the default clientid you use, will be used for all requests. Previously, default client id wasn't referred.
Version 1.1.0 - Apr 22 2014
- Fixed the issue #5. Fix changes some of the existing behavior. If you are using discover system parameters, then by default Screen Colors and Screen Resolution will not be populated. If you would like, you need to set AwtRequestParameterDiscoverer in the GoogleAnalyticsConfig before initializing the GoogleAnalytics. This change is to ensure that it can be used in a environment where JVM has no access to java.awt.* classes.
Version 1.0.5 - Apr 09 2014
Version 1.0.4 - Mar 3 2014
Version 1.0.3 - Jan 20 2014
Examples
GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.post(new PageViewHit("https://www.google.com", "Google Search"));
Or
GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.postAsync(new PageViewHit("https://www.google.com", "Google Search"));
Or
GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.postAsync(new RequestProvider() {
public GoogleAnalyticsRequest getRequest() {
return new PageViewHit("https://www.google.com", "Google Search");
}
});
Other Implementations
There are few Java implementation of Google Analytics api, but found some issues (or protocol mismatch) with each of them.
https://github.com/nhnopensource/universal-analytics-java
- Doesn't implement all parameters of Measurement Protocol.
- Cannot specify default parameters
- Only one unit test case and coverage is very minimal
- Uses Legacy Apache Http Client (3.x)
https://code.google.com/p/jgoogleanalyticstracker/
- Implements Legacy Google Analytics protocol
https://github.com/siddii/jgoogleanalytics
- Implements Legacy Google Analytics protocol